Configuración de LINE
Este artículo explica cómo configurar el canal LINE en Braze, incluido cómo configurar usuarios, reconciliar ID de usuario y crear usuarios de prueba de LINE en Braze.
Requisitos previos
Necesitarás lo siguiente para integrar LINE con Braze:
- Cuenta comercial de LINE
- Estado de cuenta premium o verificada (necesario para sincronizar los seguidores existentes)
- Consulta las directrices de cuentas de LINE
- Cuenta de desarrollador de LINE
- Canal de la API de mensajería de LINE
El envío de mensajes de LINE desde Braze consume los créditos de mensajes o de acciones de tu cuenta.

Configurar native_line_id: Puedes configurar native_line_id enviando actualizaciones de usuario a Braze (por ejemplo, con el endpoint /users/track, la importación de CSV o la ingesta de datos en la nube). Si el SDK de tu aplicación no tiene un campo específico para native_line_id, envíalo en actualizaciones de usuario del lado del servidor mediante uno de estos métodos.
Tipos de cuentas de LINE
| Tipo de cuenta | Descripción |
|---|---|
| Cuenta no verificada | Una cuenta no revisada que cualquiera puede obtener (particulares o empresas). Esta cuenta se representa con una señal gris y no aparecerá en los resultados de búsqueda dentro de la aplicación LINE. |
| Cuenta verificada | Una cuenta que ha superado la revisión de LINE Yahoo. Esta cuenta se representa con una señal azul y aparecerá en los resultados de búsqueda dentro de la aplicación LINE. Esta cuenta solo está disponible para cuentas con sede en Japón, Taiwán, Tailandia e Indonesia. |
| Cuenta premium | Una cuenta que ha superado la revisión de LINE Yahoo. Esta cuenta se representa con una señal verde y aparecerá en los resultados de búsqueda dentro de la aplicación LINE. Este tipo de cuenta se concede automáticamente durante la revisión a discreción de LINE. |
Tipo de cuenta obligatorio
Para sincronizar seguidores en Braze, tu cuenta de LINE debe ser verificada o premium. Cuando creas una cuenta, su estado predeterminado será no verificada. Tendrás que solicitar la verificación de la cuenta.
Solicitar una cuenta de LINE verificada

Las cuentas verificadas solo están disponibles para cuentas con sede en Japón, Taiwán, Tailandia e Indonesia.
- En la página Official Account de LINE, selecciona Settings.
- En Information Disclosure Verification Status, selecciona Request Account Verification.
- Introduce la información requerida.
- Espera a recibir una notificación con los resultados de la revisión.
Integración de LINE
Para configurar actualizaciones coherentes de usuarios, traer los ID de LINE de los usuarios existentes y sincronizarlos todos con los estados de suscripción de LINE:
- Importar o actualizar los usuarios conocidos existentes
- Integrar el canal LINE
- Conciliar los ID de usuario
- Cambiar los métodos de actualización de usuarios
- (Opcional) Fusionar perfiles de usuario

Cada espacio de trabajo admite un proveedor de LINE. Puedes conectar varias cuentas de LINE con un mismo proveedor de LINE. Si necesitas más de un proveedor, usa un espacio de trabajo distinto para cada uno.
Paso 1: Importar o actualizar los usuarios existentes de LINE
Este paso es necesario si tienes un usuario de LINE existente e identificado, ya que Braze extraerá automáticamente más adelante su estado de suscripción y actualizará el perfil de usuario correcto. Si no has conciliado previamente a los usuarios con su ID de LINE, omite este paso.
Puedes importar o actualizar usuarios con cualquiera de los métodos que admite Braze, incluido el endpoint /users/track, la importación de CSV o la ingesta de datos en la nube.
Independientemente del método que utilices, actualiza el native_line_id para proporcionar el ID de LINE del usuario. Para obtener más información sobre el native_line_id, consulta Configuración de usuarios.

No especifiques el estado del grupo de suscripción, ya que se ignora. LINE es la fuente de verdad para el estado de suscripción del usuario, que se sincroniza con Braze a través de la herramienta de sincronización de suscripciones o de las actualizaciones de eventos.
Paso 2: Integrar el canal LINE
Cuando termine el proceso de integración, Braze importa automáticamente a los seguidores de LINE de ese canal. Si un ID de LINE ya está asociado a un perfil de usuario de Braze, ese perfil se actualiza con el estado “suscrito”. Los ID de LINE restantes generan usuarios anónimos. Además, cuando alguien empieza a seguir tu canal de LINE, se crea un perfil de usuario no identificado.
Paso 2.1: Editar la configuración del webhook
- En LINE, ve a la pestaña Messaging API y edita tu Webhook settings:
- Configura la Webhook URL como
https://anna.braze.com/line/events.- Durante la integración, Braze cambiará automáticamente esta URL a otra según el clúster de tu panel.
- Activa Use webhook y Webhook redelivery.

- Configura la Webhook URL como
- Anota la siguiente información de la pestaña Providers:
| Tipo de información | Ubicación |
|---|---|
| ID del proveedor | Selecciona tu proveedor y ve a Settings > Basic information |
| ID del canal | Selecciona tu proveedor y ve a Channels > tu canal > Basic settings |
| Secreto del canal | Selecciona tu proveedor y ve a Channels > tu canal > Basic settings. |
| Token de acceso al canal | Selecciona tu proveedor y ve a Channels > tu canal > Messaging API. Si no hay un token de acceso al canal, selecciona Issue. |

Puedes actualizar o rotar el secreto del canal y el token de acceso al canal de un canal LINE ya integrado en Integraciones de partners > Partners tecnológicos > LINE, seleccionando tu integración.
- Ve a tu página Settings > Response settings y haz lo siguiente:
- Desactiva Greeting message. Puedes gestionarlo en Braze con un desencadenante al seguir el canal.
- Desactiva Auto-response messages. Toda la mensajería desencadenada debe pasar por Braze. Esto no te impide enviar mensajes directamente desde la consola de LINE.
- Activa Webhooks.

Paso 2.2: Generar grupos de suscripción de LINE en Braze
Braze crea un grupo de suscripción para cada canal LINE que integres. Para saber cómo funcionan los grupos de suscripción de LINE, consulta Grupos de suscripción de LINE.

Puedes añadir hasta 450 grupos de suscripción por espacio de trabajo.
- Ve a la página de partners tecnológicos de Braze para LINE e introduce la información que anotaste en la pestaña Providers de LINE:
- ID del proveedor
- ID del canal
- Secreto del canal
- Token de acceso al canal
Si quieres añadir una lista blanca de IP en tu cuenta de LINE, añade a tu lista de permitidos todas las direcciones IP indicadas para tu clúster en Lista de IP permitidas.

Durante la integración, asegúrate de comprobar que el secreto del canal sea correcto. Si no lo es, puede haber incoherencias en el estado de suscripción.

- Después de conectarte, Braze generará automáticamente un grupo de suscripción de Braze para cada integración de LINE que se añada correctamente a tu espacio de trabajo.
Cualquier cambio en tu lista de seguidores (como nuevos seguidores o personas que dejan de seguirte) se enviará automáticamente a Braze.

Paso 3: Conciliar los ID de usuario
Combina los ID de LINE de tus usuarios con sus perfiles de usuario existentes en Braze siguiendo los pasos de Conciliación de ID de usuario.
Paso 4: Cambia tus métodos de actualización de usuarios
Si ya tienes un método para enviar actualizaciones de usuarios a Braze, tendrás que actualizarlo para incluir el nuevo campo native_line_id, de modo que las actualizaciones de usuarios que envíes después a Braze incluyan ese campo.
Es posible que en Braze existan perfiles de usuario no identificados con un native_line_id, creados durante el proceso de sincronización del estado de suscripción o cuando un nuevo seguidor empezó a seguir tu canal.
Cuando un usuario de LINE se identifica en tu aplicación mediante la conciliación de usuarios u otros medios, puedes dirigirte a un posible perfil de usuario no identificado en Braze con el endpoint /users/identify. Cada perfil de usuario no identificado con un native_line_id también tiene un alias de usuario line_id que puedes usar para dirigirte al perfil de usuario que quieres identificar.
Este es un ejemplo de carga útil para /users/identify que se dirige a un perfil de usuario no identificado mediante el alias de usuario line_id:
{
"aliases_to_identify": [
{
"external_id": "known_external_id_from_your_application",
"user_alias": {
"alias_name": "U89f4a626548ccd48482f529a482f138b",
"alias_label": "line_id"
}
}
]
}
Si no existe ningún perfil de usuario para el external_id que proporcionas, este se añadirá al perfil de usuario no identificado y pasará a ser identificado. Si ya existe un perfil de usuario para el external_id, todos los atributos que solo estén en el perfil de usuario no identificado se copiarán al perfil de usuario conocido, incluidos native_line_id y el estado de suscripción del usuario.
Puedes actualizar los usuarios de LINE conocidos en tu aplicación mediante el endpoint /users/track, pasando sus identificadores externos y su native_line_id. Si ya existe un perfil de usuario no identificado para un usuario y el mismo native_line_id se añade a otro perfil de usuario mediante /users/track, este heredará todos los estados de suscripción del perfil de usuario no identificado. Sin embargo, existirán perfiles de usuario duplicados con el mismo native_line_id. Cualquier actualización de suscripción posterior procedente de actualizaciones de eventos actualizará todos los perfiles en consecuencia.

Los estados de suscripción de LINE se rastrean por native_line_id, no por external_id. Por ejemplo, si el perfil de usuario del usuario B se crea con el mismo native_line_id que el del usuario A, pero no con el mismo external_id, el usuario B hereda el estado de suscripción de LINE del usuario A.
Este es un ejemplo de carga útil para /users/track que actualiza un perfil de usuario mediante el ID de usuario externo para añadir un native_line_id:
{
"attributes": [
{
"external_id": "known_external_id_from_your_application",
"native_line_id": "U89f4a626548ccd48482f529a482f138b",
"other": "attribute"
}
]
}
Paso 5: Combinar perfiles (opcional)
Como se describió anteriormente en esta sección, existe la posibilidad de que haya varios perfiles de usuario con el mismo native_line_id. Si tus métodos de actualización crean perfiles de usuario duplicados, puedes combinar los perfiles de usuario no identificados con los perfiles de usuario identificados mediante el endpoint /user/merge.
Este es un ejemplo de carga útil para /users/merge dirigida a un perfil de usuario no identificado mediante el alias de usuario line_id:
{
"merge_updates": [
{
"identifier_to_merge": {
"user_alias": {
"alias_name": "U89f4a626548ccd48482f529a482f138b",
"alias_label": "line_id"
}
},
"identifier_to_keep": {
"external_id": "known_external_id_from_your_application"
}
}
]
}

Para obtener más información sobre cómo administrar usuarios duplicados en Braze, consulta Usuarios duplicados.
Configuración de usuarios
LINE es la fuente de verdad para los estados de suscripción de los usuarios. Aunque tengas el ID de LINE de un usuario (native_line_id), si ese usuario no sigue el canal de LINE desde el que envías, LINE no le entregará los mensajes.
Para ayudarte a gestionarlo, Braze ofrece herramientas y lógica que favorecen una base de usuarios bien integrada, incluida la sincronización de suscripciones y las actualizaciones de eventos para los seguimientos y dejar de seguir en LINE.
Sincronización de suscripciones y lógica de eventos
Para saber cómo la herramienta de sincronización de suscripciones y las actualizaciones de eventos de seguir y dejar de seguir mantienen el estado de suscripción de LINE alineado con Braze, consulta Estado de suscripción.
Reintegrar un canal de LINE en otro espacio de trabajo
Para usar un canal de LINE en otro espacio de trabajo de Braze:
- En el espacio de trabajo original, archiva el grupo de suscripción de ese canal.
- En el espacio de trabajo de destino, integra el canal siguiendo el Paso 2: Integrar el canal de LINE.
Confirma que tienes el permiso Administrar grupos de suscripción en ambos espacios de trabajo. Si no tienes permisos en ambos espacios de trabajo, la integración falla con un error que indica que el canal ya está conectado.
Para saber cómo afecta el archivado a los grupos de suscripción, consulta Grupos de suscripción de LINE.
Ejemplos
Estos son ejemplos de cómo se pueden actualizar los usuarios después de seguir los pasos de configuración.
El perfil de usuario de Braze existente ya sigue el canal de LINE
- El perfil de usuario de Braze se actualiza con un atributo
native_line_id. Su estado de suscripción predeterminado esunsubscribed. - Se ejecuta la herramienta de sincronización de suscripciones, que detecta que el usuario sigue el canal de LINE y actualiza el perfil de usuario con el estado de suscripción
subscribed. - Si se produce algún cambio en el estado de suscripción (por ejemplo, si el usuario bloquea el canal, lo elimina de sus amigos o vuelve a seguirlo), Braze recibe la actualización de LINE y actualiza el perfil de usuario con el
native_line_iden consecuencia.
El perfil de usuario existente ha bloqueado, eliminado de amigos o dejado de seguir el canal de LINE
- El perfil de usuario de Braze se actualiza con un atributo
native_line_id. Su estado de suscripción predeterminado esunsubscribed. - La herramienta de sincronización de suscripciones no detecta que el usuario siga el canal de LINE, y el estado de suscripción del usuario se mantiene como
unsubscribed. - Si más adelante el usuario sigue el canal, Braze recibe la actualización de LINE y actualiza el perfil de usuario con el estado de suscripción
subscribed.
La creación del perfil de usuario se produce después de seguir en LINE
- El canal obtiene un nuevo seguidor en LINE.
- Braze crea un perfil de usuario anónimo con el atributo
native_line_idestablecido como el ID de LINE del seguidor, y un alias de usuarioline_idestablecido como el ID de LINE del seguidor. El perfil tiene el estado de suscripciónsubscribed. - El usuario se identifica como poseedor del ID de LINE mediante la conciliación de usuarios.
- El perfil de usuario anónimo puede pasar a ser identificado mediante el endpoint
/users/identify. Las actualizaciones posteriores de este perfil de usuario (a través del endpoint/users/track, la importación de CSV o la ingesta de datos en la nube) pueden dirigirse al usuario mediante esteexternal_idconocido.
- El perfil de usuario anónimo puede pasar a ser identificado mediante el endpoint
{
"aliases_to_identify": [
{
"external_id": "known_external_id_from_your_application",
"user_alias": {
"alias_name": "U89f4a626548ccd48482f529a482f138b",
"alias_label": "line_id"
}
}
]
}
- Se puede crear un nuevo perfil de usuario (a través del endpoint
/users/track, la importación de CSV o la ingesta de datos en la nube) estableciendo elnative_line_id. Este nuevo perfil heredará el estado de suscripción del perfil de usuario anónimo existente. Ten en cuenta que esto hará que varios perfiles compartan el mismonative_line_id. Puedes fusionarlos en cualquier momento con el endpoint/users/mergesiguiendo el proceso descrito en el paso 5.
La creación del perfil de usuario se produce antes de seguir en LINE
- Adquieres un nuevo usuario y envías la información a Braze. Se crea un nuevo perfil de usuario (perfil 1).
- El usuario sigue tu cuenta de LINE.
- Braze recibe un evento de seguimiento y crea un perfil de usuario anónimo (perfil 2).
- El usuario se identifica como poseedor del ID de LINE mediante la conciliación de usuarios.
- Actualizas el perfil 1 para establecer el atributo
native_line_id. Este perfil hereda el estado de suscripción del perfil 2.- Ahora hay dos perfiles de usuario con el mismo
native_line_id. Puedes fusionarlos en cualquier momento con el endpoint/users/mergesiguiendo el proceso descrito en el paso 5.
- Ahora hay dos perfiles de usuario con el mismo
Conciliación de ID de usuario
Braze recibe automáticamente los ID de LINE cuando un usuario sigue tu canal o cuando usas el flujo de trabajo único de “sincronizar seguidores”. Además, los ID de LINE son específicos del proveedor de LINE, así que es poco probable que los usuarios puedan proporcionar su ID de LINE.
Hay dos formas de combinar un ID de LINE con un perfil de usuario existente en Braze:
Inicio de sesión con LINE
Este método usa los inicios de sesión de redes sociales para la conciliación. Cuando un usuario inicia sesión en tu aplicación, tiene la opción de usar LINE Login para crear una cuenta de usuario o iniciar sesión.

Para obtener el ID de LINE correcto de cada usuario, configura LINE Login con el mismo proveedor que tu cuenta oficial o canal de LINE integrado con Braze.
-
Ve a la consola para desarrolladores de LINE y solicita permiso para obtener las direcciones de correo electrónico de los usuarios que inician sesión en tu aplicación a través de LINE Login.
-
Sigue los pasos correspondientes que proporciona LINE para implementar LINE Login:
- Instrucciones para aplicaciones web
- Instrucciones para aplicaciones nativas
Asegúrate de incluiremailen la configuración del ámbito para las solicitudes de verificación.
-
Usa la llamada Verify ID token para obtener el correo electrónico del usuario.
-
Guarda el ID de LINE del usuario (
native_line_id) en el perfil del usuario con el correo electrónico coincidente en tu base de datos, o crea un nuevo perfil de usuario con el correo electrónico y el ID de LINE del usuario. -
Envía la información del usuario nueva o actualizada a Braze mediante el endpoint
/user/track, la importación de CSV o la ingesta de datos en la nube.
Flujos de trabajo
Un seguidor existente usa LINE Login
Situación: Se creó un usuario anónimo durante la sincronización inicial de suscriptores o después de la integración a través de un evento de “seguir”.
- El usuario inicia sesión en tu aplicación con LINE Login.
- LINE te proporciona el correo electrónico del usuario.
- Envías a Braze el usuario actualizado (el perfil de usuario existente con ese correo electrónico para añadir el ID de LINE) o actualizas el usuario anónimo con el correo electrónico.
Un nuevo seguidor usa LINE Login
Situación: No existe ningún perfil de usuario en Braze con el ID de LINE del usuario.
- El usuario inicia sesión en tu aplicación con LINE Login.
- LINE te proporciona el correo electrónico del usuario.
- Puedes:
- Actualizar un perfil de usuario existente con ese correo electrónico para que también tenga el ID de LINE del usuario.
- Crear un nuevo perfil de usuario con el correo electrónico y el ID de LINE.
- Cuando el usuario sigue tu cuenta oficial de LINE, Braze recibe un evento de seguimiento y actualiza el estado de suscripción del usuario a
subscribed.
Vinculación de cuentas de usuario
Este método permite a los usuarios vincular su cuenta de LINE a la cuenta de usuario de tu aplicación. Después, puedes usar Liquid en Braze, como {{line_id}}, para crear una URL personalizada para el usuario que devuelva su ID de LINE a tu sitio web o aplicación, donde podrá asociarse a un usuario conocido.
- Crea un Canvas basado en acciones que se base en un cambio de estado de suscripción y se desencadene cuando un usuario se suscriba a tu canal de LINE.

- Crea un mensaje que incentive a los usuarios a iniciar sesión en tu sitio web o aplicación y que pase el ID de LINE del usuario como parámetro de consulta (mediante Liquid), por ejemplo:
Thanks for following Flash n' Thread on LINE! For personalized offers and 20% off your next purchase, sign-in to your account: https://flashandthread.com/sign_in?line_user_id=
- Crea un mensaje de seguimiento que entregue el código de cupón.
- (Opcional) Crea una Campaign o un Canvas basado en acciones que se desencadene cuando se identifique al usuario de LINE para enviarle su código de cupón.

Cómo funciona
Después de que el usuario inicie sesión, se realiza un cambio en tu sitio web o aplicación para que el ID de usuario se envíe de vuelta a Braze y se asocie al ID de LINE que se pasó como parte de la URL, con un código de ejemplo como este:
const currentUrl = new URL(window.location.href)
const queryParams = new URLSearchParams(currentUrl.search);
const lineUserId = queryParams.get("line_user_id")
if (user && isLoggedIn && lineUserId) {
post(
"https://rest.iad-03.braze.com /users/identify",
{
"aliases_to_identify": [
{
"external_id": user.getUserId(),
"user_alias": {
"alias_name": lineUserId,
"alias_label": "line_id"
}
}
]
}
)
braze.logCustomEvent("identified_line_user_for_promotion");
}
Flujos de trabajo
Un usuario existente sigue tu canal de LINE
Situación: Un usuario existente en Braze sigue tu canal en LINE.
- LINE envía a Braze un evento de seguimiento.
- Braze crea un perfil de usuario anónimo con el ID de LINE, el alias de usuario
line_idy el estado del grupo de suscripción de LINEsubscribed. - El usuario recibe un mensaje de LINE con un enlace a tu sitio web y aplicación, e inicia sesión. Su perfil de usuario pasa a ser conocido.
- El perfil de usuario anónimo que se creó se identifica y se fusiona mediante el endpoint /users/identify con el perfil de usuario conocido. Ahora el perfil de usuario conocido contiene el ID de LINE y tiene el estado de suscripción
subscribed. - (Opcional) El usuario recibe un mensaje de LINE con el código de cupón y Braze registra el envío en el perfil de usuario de Braze.
Creación de usuarios de prueba de LINE en Braze
Puedes probar tu canal LINE antes de configurar la conciliación de usuarios creando un Canvas o una Campaign de tipo “¿Quién soy yo?”.
-
Configura un Canvas que devuelva el ID de usuario de Braze de un usuario cuando se envíe una palabra desencadenante específica.
Ejemplo de desencadenante
Ejemplo de mensaje
-
En Braze, puedes usar el ID de Braze para buscar usuarios específicos y modificarlos según sea necesario.

Asegúrate de que el Canvas no tenga un control global ni grupos de control que impidan los envíos.