Ir al contenido

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:

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

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

  1. En la página Official Account de LINE, selecciona Settings.
  2. En Information Disclosure Verification Status, selecciona Request Account Verification.
  3. Introduce la información requerida.
  4. 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:

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

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.

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

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

      Página de configuración del webhook para verificar o editar la URL del webhook y activar o desactivar “Use webhook”, “Webhook redelivery” y “Error statistics aggregation”.
  2. 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.
  1. 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.

Página de configuración de respuestas con opciones para alternar cómo tu cuenta gestionará los chats.

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.

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

Página de integración de mensajería de LINE con la sección de integración de LINE.

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

Sección de grupos de suscripción de LINE que muestra un grupo de suscripción para el canal “LINE”.

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.

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"
     }
   }
 ]
}

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:

  1. En el espacio de trabajo original, archiva el grupo de suscripción de ese canal.
  2. 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

  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, que detecta que el usuario sigue el canal de LINE y actualiza el perfil de usuario con el estado de suscripción subscribed.
  3. 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_id en consecuencia.

El perfil de usuario existente ha bloqueado, eliminado de amigos o dejado de seguir el canal de 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 detecta que el usuario siga el canal de LINE, y el estado de suscripción del usuario se mantiene como unsubscribed.
  3. 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

  1. El canal obtiene un nuevo seguidor en 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 line_id establecido como el ID de LINE del seguidor. El perfil tiene el estado de suscripción subscribed.
  3. El usuario se identifica como poseedor del ID de LINE mediante la conciliación de usuarios.
{
   "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 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 hará que varios perfiles compartan el mismo native_line_id. Puedes fusionarlos en cualquier momento con el endpoint /users/merge siguiendo el proceso descrito en el paso 5.

La creación del perfil de usuario se produce antes de seguir en 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 de LINE.
  3. Braze recibe un evento de seguimiento y crea un perfil de usuario anónimo (perfil 2).
  4. El usuario se identifica como poseedor del ID de LINE mediante la conciliació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. Puedes fusionarlos en cualquier momento con el endpoint /users/merge siguiendo el proceso descrito en el paso 5.

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.

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

  2. Sigue los pasos correspondientes que proporciona LINE para implementar LINE Login:

  1. Usa la llamada Verify ID token para obtener el correo electrónico del usuario.

  2. 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.

  3. 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”.

  1. El usuario inicia sesión en tu aplicación con 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 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.

  1. El usuario inicia sesión en tu aplicación con 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 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.

  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 suscriba a tu canal de LINE.
    Canvas que se desencadena cuando un usuario se suscribe al canal de LINE.
  2. 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=
  1. Crea un mensaje de seguimiento que entregue el código de cupón.
  2. (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.
    Campaign basada en acciones que se desencadena cuando se identifica al usuario de LINE.

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.

  1. LINE envía a Braze un evento de seguimiento.
  2. Braze crea un perfil de usuario anónimo con el ID de LINE, el alias de usuario line_id y el estado del grupo de suscripción de LINE subscribed.
  3. 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.
  4. 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.
  5. (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?”.

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

    Desencadenante para enviar la campaña a los usuarios que enviaron un mensaje entrante de LINE a un grupo de suscripción específico.

    Ejemplo de mensaje

    Mensaje de LINE que indica el ID de usuario de Braze.

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

New Stuff!