Skip to content

Configuração do LINE

Este artigo aborda como configurar o canal LINE na Braze, incluindo como configurar usuários, reconciliar IDs de usuários e criar usuários teste do LINE na Braze.

Pré-requisitos

Você precisará do seguinte para integrar o LINE com a Braze:

O envio de mensagens do LINE pela Braze consome os créditos de mensagem ou ação da sua conta.

Tipos de contas LINE

Tipo de conta Descrição
Conta não verificada Uma conta não revisada que pode ser obtida por qualquer pessoa (física ou jurídica). Essa conta é representada por um badge cinza e não aparecerá nos resultados de pesquisa dentro do app LINE.
Conta verificada Uma conta que passou pela análise do LINE Yahoo. Essa conta é representada por um badge azul e aparecerá nos resultados de pesquisa dentro do app LINE.

Essa conta está disponível apenas para contas baseadas no Japão, Taiwan, Tailândia e Indonésia.
Conta premium Uma conta que passou pela análise do LINE Yahoo. Essa conta é representada por um badge verde e aparecerá nos resultados de pesquisa dentro do app LINE. Esse tipo de conta é concedido automaticamente durante a análise, a critério do LINE.

Tipo de conta necessário

Para sincronizar seguidores com a Braze, sua conta LINE precisa ser verificada ou premium. Ao criar uma conta, o status padrão será não verificada. Você precisará solicitar a verificação da conta.

Solicitando uma conta LINE verificada

  1. Na página Official Account do LINE, selecione Settings.
  2. Em Information Disclosure Verification Status, selecione Request Account Verification.
  3. Insira as informações necessárias.
  4. Aguarde uma notificação com os resultados da análise.

Integração com o LINE

Para configurar atualizações consistentes de usuários, importar os LINE IDs de usuários existentes e sincronizá-los com os estados de inscrição do LINE:

  1. Importar ou atualizar usuários LINE existentes conhecidos
  2. Integrar o canal LINE
  3. Reconciliar IDs de usuários
  4. Alterar os métodos de atualização de usuários
  5. (Opcional) Mesclar perfis de usuários

Etapa 1: Importar ou atualizar usuários LINE existentes

Esta etapa é necessária se você tem um usuário LINE existente e identificado, pois a Braze irá automaticamente buscar o status de inscrição e atualizar o perfil de usuário correto. Se você não reconciliou anteriormente os usuários com o LINE ID deles, pule esta etapa.

Você pode importar ou atualizar usuários usando qualquer um dos métodos que a Braze suporta, incluindo o endpoint /users/track, importação por CSV ou Cloud Data Ingestion.

Independentemente do método utilizado, atualize o native_line_id para fornecer o LINE ID do usuário. Para saber mais sobre o native_line_id, consulte Configuração do usuário.

Etapa 2: Integrar o canal LINE

Após a conclusão do processo de integração, a Braze automaticamente importará os seguidores desse canal LINE para a Braze. Para quaisquer IDs LINE que já estejam associados a um perfil de usuário da Braze, cada perfil será atualizado com o status “subscribed”, e quaisquer IDs LINE restantes gerarão usuários anônimos. Além disso, novos seguidores do seu canal LINE terão perfis de usuário não identificados criados quando seguirem o canal.

Etapa 2.1: Editar configurações de webhook

  1. No LINE, acesse a guia Messaging API e edite suas Webhook settings:
    • Defina a Webhook URL como https://anna.braze.com/line/events.
      • A Braze alterará automaticamente essa URL para uma diferente durante a integração, com base no cluster do seu dashboard.
    • Ative Use webhook e Webhook redelivery.

      Página de configurações de webhook para verificar ou editar a URL do webhook, com opções para ativar ou desativar "Use webhook", "Webhook redelivery" e "Error statistics aggregation".
  2. Anote as seguintes informações na guia Providers:
Tipo de informação Localização
Provider ID Selecione seu provedor e acesse Settings > Basic information
Channel ID Selecione seu provedor e acesse Channels > seu canal > Basic settings
Channel secret Selecione seu provedor e acesse Channels > seu canal > Basic settings.
Channel access token Selecione seu provedor e acesse Channels > seu canal > Messaging API. Se não houver um channel access token, selecione Issue.
  1. Acesse a página Settings > Response settings e faça o seguinte:
    • Desative Greeting message. Isso pode ser gerenciado na Braze disparando com base no follow.
    • Desative Auto-response messages. Todo envio de mensagens disparado deve ser feito pela Braze. Isso não impedirá que você envie diretamente pelo console do LINE.
    • Ative Webhooks.

Página de configurações de resposta com opções para gerenciar como sua conta lidará com chats.

Etapa 2.2: Gerar grupos de inscrições LINE na Braze

A Braze cria um grupo de inscrições para cada canal LINE que você integrar. Para saber como os grupos de inscrições LINE funcionam, consulte Grupos de inscrições LINE.

  1. Acesse a página de parceiros de tecnologia da Braze para LINE e insira as informações que você anotou da guia Providers do LINE:
    • Provider ID
    • Channel ID
    • Channel secret
    • Channel access token

Se você quiser adicionar lista de permissões de IP na sua conta LINE, adicione todos os endereços IP listados para o seu cluster em Lista de permissões de IP à sua lista de permissões.

Página de integração de envio de mensagens LINE com a seção de integração LINE.

  1. Após a conexão, a Braze gerará automaticamente um grupo de inscrições da Braze para cada integração LINE adicionada com sucesso ao seu espaço de trabalho.

    Quaisquer alterações na sua lista de seguidores (como novos seguidores ou pessoas que deixaram de seguir) serão automaticamente enviadas para a Braze.

Seção de grupos de inscrições LINE exibindo um grupo de inscrições para o canal "LINE".

Etapa 3: Reconciliar IDs de usuário

Combine os IDs do LINE dos seus usuários com os perfis de usuário existentes da Braze seguindo as etapas em Reconciliação de ID de usuário.

Etapa 4: Altere seus métodos de atualização de usuários

Supondo que você já tenha um método para fornecer atualizações de usuários à Braze, será necessário atualizá-lo para incluir o novo campo native_line_id, de modo que as atualizações de usuários subsequentes enviadas à Braze incluam esse campo.

Perfis de usuários não identificados com um native_line_id podem existir na Braze, tendo sido criados como parte do processo de sincronização de status de inscrição ou quando um novo seguidor seguiu seu canal.

Quando um usuário do LINE é identificado no seu aplicativo por meio da reconciliação de usuários ou de outros meios, você pode direcionar um possível perfil de usuário não identificado na Braze usando o endpoint /users/identify. Todo perfil de usuário não identificado com um native_line_id também possui um alias de usuário line_id que pode ser usado para direcionar o perfil de usuário a ser identificado.

Veja um exemplo de carga útil para /users/identify que direciona um perfil de usuário não identificado pelo alias de usuário 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"
           }
       }
   ]
}

Se nenhum perfil de usuário existente for encontrado para o external_id fornecido, ele será adicionado ao perfil de usuário não identificado, tornando-o identificado. Se um perfil de usuário já existir para o external_id, todos os atributos exclusivos do perfil de usuário não identificado serão copiados para o perfil de usuário conhecido, incluindo native_line_id e o status de inscrição do usuário.

Você pode atualizar usuários do LINE conhecidos no seu aplicativo por meio do endpoint /users/track, passando seus identificadores externos e native_line_id. Se um perfil de usuário não identificado já existir para um usuário e o mesmo native_line_id for adicionado a um perfil de usuário diferente por meio de /users/track, ele herdará todos os estados de inscrição do perfil de usuário não identificado. No entanto, perfis de usuários duplicados existirão com o mesmo native_line_id. Quaisquer atualizações de inscrição subsequentes provenientes de atualizações de eventos atualizarão todos os perfis correspondentes.

Veja um exemplo de carga útil para /users/track que atualiza um perfil de usuário pelo ID externo de usuário para adicionar um 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"
       }
   ]
}

Etapa 5: Mesclar perfis (opcional)

Conforme descrito anteriormente nesta seção, existe a possibilidade de vários perfis de usuário existirem com o mesmo native_line_id. Se seus métodos de atualização criarem perfis de usuário duplicados, você pode mesclar perfis de usuário não identificados com perfis de usuário identificados usando o endpoint /user/merge.

Veja um exemplo de carga útil para /users/merge que tem como alvo um perfil de usuário não identificado pelo alias de usuário 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"
     }
   }
 ]
}

Configuração de usuários

O LINE é a fonte da verdade para os estados de inscrição dos usuários. Mesmo que você tenha o LINE ID de um usuário (native_line_id), se esse usuário não tiver seguido o canal do LINE de onde você está enviando, o LINE não entregará mensagens a esse usuário.

Para ajudar a gerenciar isso, a Braze oferece ferramentas e lógica que dão suporte a uma base de usuários bem integrada, incluindo sincronização de inscrições e atualizações de eventos para seguidores e cancelamentos de seguimento no LINE.

Sincronização de inscrições e lógica de eventos

Para saber como a ferramenta de sincronização de inscrições e as atualizações de eventos de seguimento e cancelamento de seguimento mantêm o status de inscrição do LINE alinhado com a Braze, consulte Status de inscrição.

Reintegrar um canal LINE em outro espaço de trabalho

Para usar um canal LINE em um espaço de trabalho diferente da Braze:

  1. No espaço de trabalho original, arquive o grupo de inscrições desse canal.
  2. No espaço de trabalho de destino, integre o canal usando a Etapa 2: Integrar canal LINE.

Confirme que você tem a permissão Manage Subscription Groups em ambos os espaços de trabalho. Sem permissões em ambos os espaços de trabalho, a integração falhará com um erro indicando que o canal já está conectado.

Para saber como o arquivamento afeta os grupos de inscrições, consulte Grupos de inscrições LINE.

Casos de uso

Estes são casos de uso de como os usuários podem ser atualizados após você seguir as etapas de configuração.

Perfil de usuário existente na Braze que já segue o canal LINE

  1. O perfil de usuário da Braze é atualizado com um atributo native_line_id. Seu status de inscrição padrão é unsubscribed.
  2. A ferramenta de sincronização de inscrição é executada, identifica que o usuário está seguindo o canal LINE e então atualiza o perfil de usuário com o status de inscrição subscribed.
  3. Se ocorrerem alterações no status de inscrição (como o usuário bloquear, remover ou voltar a seguir o canal), a Braze recebe a atualização do LINE e atualiza o perfil de usuário com o native_line_id adequadamente.

Perfil de usuário existente que bloqueou, removeu ou deixou de seguir o canal LINE

  1. O perfil de usuário da Braze é atualizado com um atributo native_line_id. Seu status de inscrição padrão é unsubscribed.
  2. A ferramenta de sincronização de inscrição não identifica que o usuário está seguindo o canal LINE, e o status de inscrição do usuário permanece como unsubscribed.
  3. Se o usuário seguir o canal posteriormente, a Braze recebe a atualização do LINE e atualiza o perfil de usuário com o status de inscrição subscribed.

Criação do perfil de usuário ocorre após seguir o LINE

  1. O canal ganha um novo seguidor no LINE.
  2. A Braze cria um perfil de usuário anônimo com o atributo native_line_id definido como o ID do LINE do seguidor e um alias de usuário line_id definido como o ID do LINE do seguidor. O perfil tem um status de inscrição subscribed.
  3. O usuário é identificado como possuindo o ID do LINE por meio da reconciliação de usuários. 
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"
           }
       }
   ]
}
  • Um novo perfil de usuário pode ser criado (por meio do endpoint /users/track, importação de CSV ou ingestão de dados na nuvem) definindo o native_line_id. Esse novo perfil herdará o estado do status de inscrição do perfil de usuário anônimo existente. Observe que isso resultará em vários perfis compartilhando o mesmo native_line_id. Eles podem ser mesclados a qualquer momento usando o endpoint /users/merge no processo descrito na Etapa 5.

Criação do perfil de usuário ocorre antes de seguir o LINE

  1. Você adquire um novo usuário e envia as informações para a Braze. Um novo perfil de usuário é criado (perfil 1).
  2. O usuário segue sua conta LINE.
  3. A Braze recebe um evento de seguir e cria um perfil de usuário anônimo (perfil 2).
  4. O usuário é identificado como possuindo o ID do LINE por meio da reconciliação de usuários.
  5. Você atualiza o perfil 1 para definir o atributo native_line_id. Esse perfil herda o estado do status de inscrição do perfil 2.
    • Agora existem dois perfis de usuário com o mesmo native_line_id. Eles podem ser mesclados a qualquer momento usando o endpoint /users/merge no processo descrito na Etapa 5.

Reconciliação de ID de usuário

Os IDs do LINE são recebidos automaticamente pela Braze quando um usuário segue seu canal ou quando você usa o fluxo de trabalho único de “sincronização de seguidores”. Os IDs do LINE também são específicos do canal que os usuários seguem, então é improvável que os usuários consigam fornecer seus IDs do LINE.

Existem duas formas de combinar um ID do LINE com um perfil de usuário existente na Braze:

Login pelo LINE

Esse método utiliza logins de redes sociais para reconciliação. Quando um usuário faz login no seu app, ele tem a opção de usar o LINE Login para criar uma conta de usuário ou fazer login.

  1. Acesse o Console de Desenvolvedores do LINE e solicite permissão para obter os endereços de e-mail dos usuários que fazem login no seu app pelo LINE Login.

  2. Siga as etapas apropriadas fornecidas pelo LINE para implementar o LINE Login:

  1. Use a chamada de verificação de token de ID para obter o e-mail do usuário.

  2. Salve o ID do LINE do usuário (native_line_id) no perfil do usuário com um e-mail correspondente no seu banco de dados, ou crie um novo perfil de usuário com o e-mail e o ID do LINE.

  3. Envie as informações novas ou atualizadas do usuário para a Braze usando o endpoint /user/track, importação por CSV ou ingestão de dados na nuvem.

Fluxos de trabalho

Seguidor existente usa o LINE Login

Cenário: Um usuário anônimo foi criado durante a sincronização inicial de inscritos ou após a integração por meio de um evento de “seguir”.

  1. O usuário faz login no seu app usando o LINE Login.
  2. O LINE fornece o e-mail do usuário.
  3. Você envia para a Braze o usuário atualizado (o perfil de usuário existente com aquele e-mail para adicionar o ID do LINE) ou atualiza o usuário anônimo com o e-mail.
Novo seguidor usa o LINE Login

Cenário: Não existe um perfil de usuário na Braze com o ID do LINE do usuário.

  1. O usuário faz login no seu app usando o LINE Login.
  2. O LINE fornece o e-mail do usuário.
  3. Você pode:
    • Atualizar um perfil de usuário existente com aquele e-mail para incluir também o ID do LINE do usuário.
    • Criar um novo perfil de usuário com o e-mail e o ID do LINE.
  4. Quando o usuário segue sua conta oficial do LINE, a Braze recebe um evento de seguir e atualiza o status de inscrição do usuário para subscribed.

Vinculação de conta de usuário

Esse método permite que os usuários vinculem sua conta do LINE à conta de usuário do seu app. Você pode então usar Liquid na Braze, como {{line_id}}, para criar uma URL personalizada para o usuário que envia o ID do LINE de volta para o seu website ou app, onde pode ser associado a um usuário conhecido.

  1. Crie um Canvas baseado em ação que é acionado por uma mudança de estado de inscrição e dispara quando um usuário se inscreve no seu canal LINE.
    Canvas que dispara quando um usuário se inscreve no canal LINE.
  2. Crie uma mensagem incentivando os usuários a fazerem login no seu website ou app, passando o ID do LINE do usuário como parâmetro de consulta (via 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=
  1. Crie uma mensagem de acompanhamento que entrega o código do cupom.
  2. (Opcional) Crie uma Campaign ou Canvas baseada em ação que dispara quando o usuário do LINE é identificado, para enviar o código do cupom ao usuário.
    Campaign baseada em ação que dispara quando o usuário do LINE é identificado.

Como funciona

Depois que o usuário faz login, uma alteração é feita no seu website ou app para que o ID do usuário seja enviado de volta para a Braze e associado ao ID do LINE que foi passado como parte da URL, com um código de exemplo 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");
}

Fluxos de trabalho

Usuário existente segue seu canal LINE

Cenário: Um usuário existente na Braze segue seu canal no LINE.

  1. O LINE envia um evento de seguir para a Braze.
  2. A Braze cria um perfil de usuário anônimo com o ID do LINE, alias de usuário line_id e status do grupo de inscrições do LINE como subscribed.
  3. O usuário recebe uma mensagem do LINE com um link para seu website e app e faz login. O perfil de usuário agora é conhecido.
  4. O perfil de usuário anônimo que foi criado é identificado e mesclado por meio do endpoint /users/identify ao perfil de usuário conhecido. O perfil de usuário conhecido agora contém o ID do LINE e tem status de inscrição subscribed.
  5. (Opcional) O usuário recebe uma mensagem do LINE com o código do cupom e a Braze registra o envio no perfil de usuário da Braze.

Criando usuários teste do LINE na Braze

Você pode testar seu canal do LINE antes de configurar a reconciliação de usuários criando um Canvas ou uma Campaign do tipo “Quem sou eu”.

  1. Configure um Canvas que retorne o ID de usuário Braze de um usuário com base em uma palavra-gatilho específica.

    Exemplo de gatilho

    Gatilho para enviar a Campaign para usuários que enviaram uma mensagem LINE de entrada para um grupo de inscrições específico.

    Exemplo de mensagem

    Mensagem do LINE informando o ID de usuário Braze.

  2. Na Braze, você pode usar o ID Braze para buscar usuários específicos e modificá-los conforme necessário.
New Stuff!