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:

• Conta empresarial do LINE
• Status de conta premium ou verificada (necessário para sincronizar seguidores existentes)
  • Consulte as diretrizes de conta do LINE
• Conta de desenvolvedor do LINE
• Canal da API de mensagens do LINE

O envio de mensagens LINE a partir da Braze consome os Créditos de Mensagem da sua conta.

Tipos de contas LINE

Tipo de conta necessário

Para sincronizar seguidores na Braze, sua conta LINE precisa ser verificada ou premium. Quando você cria uma conta, seu 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.

Integrando o LINE

Para configurar atualizações consistentes de usuários, trazer os IDs LINE 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ê já tem um usuário LINE existente e identificado, pois a Braze posteriormente extrairá automaticamente o estado de inscrição e atualizará o perfil de usuário correto. Se você não reconciliou previamente os usuários com seus IDs LINE, pule esta etapa.

Você pode importar ou atualizar usuários usando qualquer um dos métodos suportados pela Braze, incluindo o endpoint /users/track, importação CSV ou Ingestão de dados na nuvem.

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

Etapa 2: Integrar o canal LINE

Após a conclusão do processo de integração, a Braze extrairá automaticamente os seguidores LINE desse canal 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 “inscrito”, 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 isso para uma URL diferente durante a integração, com base no cluster do seu dashboard.
   • Ative Use webhook e Webhook redelivery.
     
     
2. Anote as seguintes informações na guia Providers:

3. Acesse sua página Settings > Response settings e faça o seguinte:
   • Desative Greeting message. Isso pode ser gerenciado na Braze por meio de gatilho ao seguir.
   • Desative Auto-response messages. Todas as mensagens disparadas devem ser feitas pela Braze. Isso não impedirá que você envie diretamente pelo console do LINE.
   • Ative Webhooks.

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

1. Acesse a página de Parceiros de tecnologia da Braze para o 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.

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

Etapa 3: Reconciliar IDs de usuários

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

Etapa 4: Alterar 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, você precisará 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 LINE é identificado no seu aplicativo por meio da reconciliação de usuários ou outros meios, você pode direcionar um perfil de usuário potencialmente 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.

Aqui está 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 que estão exclusivamente no 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 LINE que são 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 adequadamente.

Aqui está um exemplo de carga útil para /users/track que atualiza um perfil de usuário pelo ID de usuário externo 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 acima, existe a possibilidade de vários perfis de usuários existirem com o mesmo native_line_id. Se seus métodos de atualização criarem perfis de usuários duplicados, você pode mesclar perfis de usuários não identificados com perfis de usuários identificados usando o endpoint /user/merge.

Aqui está um exemplo de carga útil para /users/merge 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
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 de verdade para os estados de inscrição dos usuários. Mesmo que você tenha o ID LINE de um usuário (native_line_id), se esse usuário não seguir o canal LINE de onde você está enviando, o LINE não entregará mensagens ao usuário.

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

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

1. Ferramenta de sincronização de inscrições: Esta ferramenta é implantada automaticamente após uma integração bem-sucedida do canal LINE. Use-a para atualizar perfis existentes e criar novos perfis.
   
   Todos os perfis de usuários da Braze que possuem um native_line_id que segue o canal LINE serão atualizados para ter um status de grupo de inscrições de subscribed. Qualquer seguidor do canal LINE que não tenha um perfil de usuário da Braze com o native_line_id terá:
   
   - Um perfil de usuário anônimo criado com native_line_id definido como o ID LINE do usuário que segue o canal
   - Um alias de usuário line_id definido como o ID LINE do usuário que segue o canal
   - Um status de grupo de inscrições de subscribed

2. Atualizações de eventos: São usadas para atualizar o status de inscrição de um usuário. Quando a Braze recebe atualizações de eventos de usuários para o canal LINE integrado e o evento é um seguir, o perfil de usuário terá um status de grupo de inscrições de subscribed. Se o evento for um deixar de seguir, o perfil de usuário terá um status de grupo de inscrições de unsubscribed.
   
   - Todos os perfis de usuários da Braze com um native_line_id correspondente serão atualizados automaticamente.
   - Se nenhum perfil de usuário correspondente existir para um evento, a Braze criará um usuário anônimo.

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

Perfil de usuário existente na Braze 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ções é executada, encontra 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 da lista de amigos 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 bloqueou, removeu da lista de amigos 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ções não encontra 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 posteriormente seguir o canal, a Braze recebe a atualização do LINE e atualiza o perfil de usuário com o status de inscrição subscribed.

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

1. O canal recebe um novo seguidor LINE.
2. A Braze cria um perfil de usuário anônimo com o atributo native_line_id definido como o ID LINE do seguidor e um alias de usuário line_id definido como o ID LINE do seguidor. O perfil tem um status de inscrição de subscribed.
3. O usuário é identificado como tendo o ID LINE por meio da reconciliação de usuários.
   • O perfil de usuário anônimo pode ser identificado usando o endpoint /users/identify. Atualizações subsequentes (por meio do endpoint /users/track, importação CSV ou Ingestão de dados na nuvem) para este perfil de usuário podem direcionar o usuário por este external_id conhecido.

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 CSV ou Ingestão de dados na nuvem) definindo o native_line_id. Este novo perfil herdará o estado de 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.

A 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 tendo o ID LINE por meio da reconciliação de usuários.
5. Você atualiza o perfil 1 para definir o atributo native_line_id. Este perfil herda o estado de status de inscrição do perfil 2.
   • Agora existem dois perfis de usuários 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 IDs de usuários

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

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

• LINE Login
• Vinculação de conta de usuário

LINE Login

Este método usa 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 por meio do LINE Login.

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

   • Instruções para app web
   • Instruções para app nativo
     
     Certifique-se de incluir email na configuração de escopo para solicitações de verificação.

3. Use a chamada Verify ID token para adquirir o e-mail do usuário.

4. Salve o ID 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 LINE do usuário.

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

Fluxos de trabalho

Seguidor existente usa 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 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 LINE) ou atualiza o usuário anônimo com o e-mail.

Novo seguidor usa LINE Login

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

1. O usuário faz login no seu app usando 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 também ter o ID LINE do usuário.
   • Criar um novo perfil de usuário com o e-mail e o ID LINE.
4. Quando o usuário segue sua conta oficial 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

Este método permite que os usuários vinculem sua conta 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 passa o ID LINE do usuário de volta para seu site ou app, que pode então ser associado a um usuário conhecido.

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

Como funciona

Após o usuário fazer login, uma alteração é feita no seu site ou app para que o ID do usuário seja enviado de volta para a Braze para associá-lo ao ID LINE que foi passado como parte da URL, com 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 LINE, alias de usuário line_id e status de grupo de inscrições LINE de subscribed.
3. O usuário recebe uma mensagem LINE com um link para seu site e app e faz login. Seu 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 no perfil de usuário conhecido. O perfil de usuário conhecido agora contém o ID LINE e tem um status de inscrição de subscribed.
5. (Opcional) O usuário recebe uma mensagem LINE com o código do cupom e a Braze registra o envio no perfil de usuário da Braze.

Criando usuários teste LINE na Braze

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

1. Configure um Canvas que retorna o ID de usuário da Braze de um usuário em uma palavra-gatilho específica.
   
   Exemplo de gatilho
   
   
   
   Exemplo de mensagem
   
   
   
   

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