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 empresarial de LINE
• Estado de cuenta premium o verificada (necesario para sincronizar seguidores existentes)
  • Consulta las directrices de cuentas de LINE
• Cuenta de desarrollador de LINE
• Canal de API de mensajería de LINE

El envío de mensajes LINE desde Braze consume los créditos de mensaje de tu cuenta.

Tipos de cuentas LINE

Tipo de cuenta requerido

Para sincronizar seguidores en Braze, tu cuenta LINE debe ser verificada o premium. Cuando creas una cuenta, su estado predeterminado será no verificada. Necesitarás solicitar la verificación de la cuenta.

Solicitar una cuenta LINE verificada

1. En la página de Official Account de LINE, selecciona Settings.
2. En Information Disclosure Verification Status, selecciona Request Account Verification.
3. Introduce la información requerida.
4. Espera una notificación con los resultados de la revisión.

Integración de LINE

Para configurar actualizaciones de usuario consistentes, traer los ID de LINE de usuarios existentes y sincronizarlos todos con los estados de suscripción de LINE:

1. Importar o actualizar usuarios existentes conocidos
2. Integrar el canal LINE
3. Reconciliar ID de usuario
4. Cambiar los métodos de actualización de usuarios
5. (Opcional) Fusionar perfiles de usuario

Paso 1: Importar o actualizar usuarios LINE existentes

Este paso es necesario si tienes un usuario LINE existente e identificado, ya que Braze posteriormente extraerá automáticamente su estado de suscripción y actualizará el perfil de usuario correcto. Si no has reconciliado previamente usuarios con su ID de LINE, omite este paso.

Puedes importar o actualizar usuarios usando cualquiera de los métodos que Braze admite, incluido el punto de conexión /users/track, importación CSV o Ingesta de datos de Cloud.

Independientemente del método que uses, actualiza native_line_id para proporcionar el ID de LINE del usuario. Para obtener más información sobre native_line_id, consulta Configuración de usuario.

Paso 2: Integrar el canal LINE

Después de que se complete el proceso de integración, Braze extraerá automáticamente los seguidores de LINE de ese canal en Braze. Para cualquier ID de LINE que ya esté asociado con un perfil de usuario de Braze, cada perfil se actualizará con el estado “suscrito”, y cualquier ID de LINE restante generará usuarios anónimos. Además, los nuevos seguidores de tu canal LINE tendrán perfiles de usuario no identificados creados cuando sigan el canal.

Paso 2.1: Editar la configuración del webhook

1. En LINE, ve a la pestaña Messaging API y edita tu Webhook settings:
   • Establece la Webhook URL en https://anna.braze.com/line/events.
     • Braze cambiará automáticamente esto a una URL diferente al integrar, según tu clúster de dashboard.
   • Activa Use webhook y Webhook redelivery.
     
     
2. Toma nota de la siguiente información en la pestaña Providers:

3. Ve a tu página de Settings > Response settings y haz lo siguiente:
   • Desactiva Greeting message. Esto se puede manejar en Braze mediante un desencadenador al seguir.
   • Desactiva Auto-response messages. Toda la mensajería desencadenada debe ser a través de Braze. Esto no te impedirá enviar directamente desde la consola de LINE.
   • Activa Webhooks.

Paso 2.2: Generar grupos de suscripción LINE en Braze

1. Ve a la página de socios tecnológicos de Braze para LINE e introduce la información que anotaste de la pestaña Providers de LINE:
   • Provider ID
   • Channel ID
   • Channel secret
   • Channel access token

Si deseas agregar lista blanca de IP en tu cuenta LINE, agrega todas las direcciones IP listadas para tu clúster en Lista de IP permitidas a tu lista de permitidos.

2. Después de conectar, Braze generará automáticamente un grupo de suscripción de Braze para cada integración LINE que se agregue exitosamente a tu espacio de trabajo.
   
   Cualquier cambio en tu lista de seguidores (como nuevos seguidores o personas que dejan de seguir) se enviará automáticamente a Braze.

Paso 3: Reconciliar ID de usuario

Combina los ID de LINE de tus usuarios con sus perfiles de usuario de Braze existentes siguiendo los pasos en Reconciliación de ID de usuario.

Paso 4: Cambiar tus métodos de actualización de usuarios

Suponiendo que ya tienes un método para proporcionar actualizaciones de usuario a Braze, necesitarás actualizarlo para incluir el nuevo campo native_line_id de modo que las actualizaciones de usuario posteriores enviadas a Braze incluyan ese campo.

Pueden existir perfiles de usuario no identificados con un native_line_id en Braze que fueron creados como parte del proceso de sincronización del estado de suscripción, o cuando un nuevo seguidor siguió tu canal.

Cuando un usuario de LINE es identificado en tu aplicación a través de la reconciliación de usuarios u otros medios, puedes dirigirte a un perfil de usuario no identificado potencial en Braze usando el punto de conexión /users/identify. Cada perfil de usuario no identificado con un native_line_id también tiene un alias de usuario line_id que se puede usar para dirigirse al perfil de usuario a identificar.

Aquí hay un ejemplo de carga útil para /users/identify que se dirige a un perfil de usuario no identificado por el alias de usuario line_id:

1
2
3
4
5
6
7
8
9
10
11
{
   "aliases_to_identify": [
       {
           "external_id": "known_external_id_from_your_application",
           "user_alias": {
               "alias_name": "U89f4a626548ccd48482f529a482f138b",
               "alias_label": "line_id"
           }
       }
   ]
}

Si no existe un perfil de usuario para tu external_id proporcionado, se agregará al perfil de usuario no identificado, convirtiéndolo en identificado. Si existe un perfil de usuario para el external_id, todos los atributos que están exclusivamente en el perfil de usuario no identificado se copiarán al perfil de usuario conocido, incluido native_line_id y el estado de suscripción del usuario.

Puedes actualizar usuarios de LINE que son conocidos en tu aplicación a través del punto de conexión /users/track pasando sus identificadores externos y native_line_id. Si ya existe un perfil de usuario no identificado para un usuario y el mismo native_line_id se agrega a un perfil de usuario diferente a través de /users/track, 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 a partir de actualizaciones de eventos actualizará todos los perfiles en consecuencia.

Aquí hay un ejemplo de carga útil para /users/track que actualiza un perfil de usuario por el ID de usuario externo para agregar un native_line_id:

1
2
3
4
5
6
7
8
9
{
   "attributes": [
       {
           "external_id": "known_external_id_from_your_application",
           "native_line_id": "U89f4a626548ccd48482f529a482f138b",
           "other": "attribute"
       }
   ]
}

Paso 5: Fusionar perfiles (opcional)

Como se describió anteriormente, existe la posibilidad de que múltiples perfiles de usuario existan con el mismo native_line_id. Si tus métodos de actualización crean perfiles de usuario duplicados, puedes fusionar perfiles de usuario no identificados con perfiles de usuario identificados con el punto de conexión /user/merge.

Aquí hay un ejemplo de carga útil para /users/merge que se dirige a un perfil de usuario no identificado por el alias de usuario line_id:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
 "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"
     }
   }
 ]
}

Configuración de usuario

LINE es la fuente de verdad para los estados de suscripción de los usuarios. Incluso si tienes el ID de LINE de un usuario (native_line_id), si ese usuario no ha seguido el canal LINE desde el que estás enviando, LINE no entregará mensajes al usuario.

Para ayudar a gestionar esto, Braze ofrece herramientas y lógica que soportan una base de usuarios bien integrada, incluida la sincronización de suscripciones y actualizaciones de eventos para seguimientos y cancelaciones de seguimiento en LINE.

Sincronización de suscripciones y lógica de eventos

1. Herramienta de sincronización de suscripciones: Esta herramienta se despliega automáticamente después de una integración exitosa del canal LINE. Úsala para actualizar perfiles existentes y crear nuevos perfiles.
   
   Todos los perfiles de usuario de Braze que tengan un native_line_id que siga el canal LINE se actualizarán para tener un estado de grupo de suscripción de subscribed. Cualquier seguidor del canal LINE que no tenga un perfil de usuario de Braze con el native_line_id tendrá:
   
   - Un perfil de usuario anónimo creado con native_line_id establecido como el ID de LINE del usuario que sigue el canal
   - Un alias de usuario line_id establecido como el ID de LINE del usuario que sigue el canal
   - Un estado de grupo de suscripción de subscribed

2. Actualizaciones de eventos: Se utilizan para actualizar el estado de suscripción de un usuario. Cuando Braze recibe actualizaciones de eventos de usuario para el canal LINE integrado y el evento es un seguimiento, el perfil de usuario tendrá un estado de grupo de suscripción de subscribed. Si el evento es dejar de seguir, el perfil de usuario tendrá un estado de grupo de suscripción de unsubscribed.
   
   - Todos los perfiles de usuario de Braze con un native_line_id coincidente se actualizarán automáticamente.
   - Si no existe un perfil de usuario coincidente para un evento, Braze creará un usuario anónimo.

Casos de uso

Estos son casos de uso de cómo los usuarios pueden ser actualizados después de seguir los pasos de configuración anteriores.

Un perfil de usuario de Braze existente ya sigue el canal LINE

1. El perfil de usuario de Braze se actualiza con un atributo native_line_id. Su estado de suscripción predeterminado es unsubscribed.
2. Se ejecuta la herramienta de sincronización de suscripciones, encuentra que el usuario está siguiendo el canal LINE y luego actualiza el perfil de usuario con el estado de suscripción subscribed.
3. Si ocurre algún cambio en el estado de suscripción (como que el usuario bloquee, elimine de amigos o vuelva a seguir el canal), Braze recibe la actualización de LINE y actualiza el perfil de usuario con el native_line_id en consecuencia.

Un perfil de usuario existente ha bloqueado, eliminado de amigos o dejado de seguir el canal LINE

1. El perfil de usuario de Braze se actualiza con un atributo native_line_id. Su estado de suscripción predeterminado es unsubscribed.
2. La herramienta de sincronización de suscripciones no encuentra que el usuario esté siguiendo el canal LINE y el estado de suscripción del usuario permanece como unsubscribed.
3. Si el usuario sigue el canal posteriormente, 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 ocurre después de seguir LINE

1. El canal obtiene un nuevo seguidor de LINE.
2. Braze crea un perfil de usuario anónimo con el atributo native_line_id establecido como el ID de LINE del seguidor, y un alias de usuario de line_id establecido como el ID de LINE del seguidor. El perfil tiene un estado de suscripción de subscribed.
3. El usuario es identificado como poseedor del ID de LINE a través de la reconciliación de usuarios.
   • El perfil de usuario anónimo puede ser identificado usando el punto de conexión /users/identify. Las actualizaciones posteriores (a través del punto de conexión /users/track, importación CSV o Ingesta de datos de Cloud) a este perfil de usuario pueden dirigirse al usuario por este external_id conocido.

1
2
3
4
5
6
7
8
9
10
11
{
   "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 punto de conexión /users/track, importación CSV o Ingesta de datos de Cloud) estableciendo el native_line_id. Este nuevo perfil heredará el estado de suscripción del perfil de usuario anónimo existente. Ten en cuenta que esto resultará en múltiples perfiles compartiendo el mismo native_line_id. Estos se pueden fusionar en cualquier momento usando el punto de conexión /users/merge en el proceso descrito en el Paso 5.

La creación del perfil de usuario ocurre antes de seguir LINE

1. Adquieres un nuevo usuario y envías la información a Braze. Se crea un nuevo perfil de usuario (perfil 1).
2. El usuario sigue tu cuenta LINE.
3. Braze recibe un evento de seguimiento y crea un perfil de usuario anónimo (perfil 2).
4. El usuario es identificado como poseedor del ID de LINE a través de la reconciliación de usuarios.
5. 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. Estos se pueden fusionar en cualquier momento usando el punto de conexión /users/merge en el proceso descrito en el Paso 5.

Reconciliación de ID de usuario

Los ID de LINE son recibidos automáticamente por Braze cuando un usuario sigue tu canal, o cuando usas el flujo de trabajo único de “sincronizar seguidores”. Los ID de LINE también son específicos del canal que los usuarios siguen, por lo que es poco probable que los usuarios puedan proporcionar sus ID de LINE.

Hay dos formas de combinar un ID de LINE con un perfil de usuario de Braze existente:

• Inicio de sesión con LINE
• Vinculación de cuenta de usuario

Inicio de sesión con LINE

Este método utiliza inicios de sesión de redes sociales para la reconciliación. Cuando un usuario inicia sesión en tu aplicación, se le da la opción de usar LINE Login para crear una cuenta de usuario o iniciar sesión.

1. Ve a la consola de 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.

2. Sigue los pasos apropiados proporcionados por LINE para implementar LINE Login:
   
   

   • Instrucciones para aplicaciones web
   • Instrucciones para aplicaciones nativas
     
     Asegúrate de incluir email en la configuración de alcance para las solicitudes de verificación.

3. Usa la llamada de verificación de token de ID para adquirir el correo electrónico del usuario.

4. Guarda el ID de LINE del usuario (native_line_id) en el perfil del usuario con un 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.

5. Envía la información de usuario nueva o actualizada a Braze usando el punto de conexión /user/track, importación CSV o Ingesta de datos de Cloud.

Flujos de trabajo

Un seguidor existente usa LINE Login

Escenario: 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 “seguimiento”.

1. El usuario inicia sesión en tu aplicación usando LINE Login.
2. LINE te proporciona el correo electrónico del usuario.
3. Envías a Braze el usuario actualizado (el perfil de usuario existente con ese correo electrónico para agregar el ID de LINE) o actualizas el usuario anónimo con el correo electrónico.

Un nuevo seguidor usa LINE Login

Escenario: No existe un perfil de usuario en Braze con el ID de LINE del usuario.

1. El usuario inicia sesión en tu aplicación usando LINE Login.
2. LINE te proporciona el correo electrónico del usuario.
3. 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.
4. 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 cuenta de usuario

Este método permite a los usuarios vincular su cuenta LINE con la cuenta de usuario de tu aplicación. Luego puedes usar Liquid en Braze, como {{line_id}}, para crear una URL personalizada para el usuario que pase el ID de LINE del usuario de vuelta a tu sitio web o aplicación, donde puede asociarse con un usuario conocido.

1. Crea un Canvas basado en acciones que se base en un cambio de estado de suscripción y se desencadene cuando un usuario se suscribe a tu canal LINE.
   
2. Crea un mensaje que incentive a los usuarios a iniciar sesión en tu sitio web o aplicación, pasando el ID de LINE del usuario como parámetro de consulta (a través de Liquid), como:

1
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=

3. Crea un mensaje de seguimiento que entregue el código de cupón.
4. (Opcional) Crea una campaña o Canvas basado en acciones que se desencadene cuando el usuario de LINE sea identificado para enviarle su código de cupón.
   

Cómo funciona

Después de que el usuario inicia 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 para asociarlo con el ID de LINE que se pasó como parte de la URL, con código de ejemplo como:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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 LINE

Escenario: Un usuario existente en Braze sigue tu canal en LINE.

1. LINE envía a Braze un evento de seguimiento.
2. Braze crea un perfil de usuario anónimo con el ID de LINE, alias de usuario line_id y estado de grupo de suscripción LINE de subscribed.
3. El usuario recibe un mensaje LINE con un enlace a tu sitio web y aplicación e inicia sesión. Su perfil de usuario ahora es conocido.
4. El perfil de usuario anónimo que se creó es identificado y se fusiona a través del punto de conexión /users/identify con el perfil de usuario conocido del usuario. El perfil de usuario conocido ahora contiene el ID de LINE y tiene un estado de suscripción de subscribed.
5. (Opcional) El usuario recibe un mensaje 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 LINE en Braze

Puedes probar tu canal LINE antes de configurar la reconciliación de usuarios creando un Canvas o campaña de “Quién soy”.

1. Configura un Canvas que devuelva el ID de usuario de Braze de un usuario con una palabra desencadenante específica.
   
   Ejemplo de desencadenante
   
   
   
   Ejemplo de mensaje
   
   
   
   

2. En Braze, puedes usar el ID de Braze para buscar usuarios específicos y modificarlos según sea necesario.