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
Para integrar o LINE com a Braze, você precisará do seguinte:
- Conta comercial 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 envio de mensagens do LINE
O envio de mensagens do LINE pela Braze consome os créditos de mensagem ou de ação da sua conta.

Definição de native_line_id: Você pode definir native_line_id enviando atualizações de usuário para a Braze (por exemplo, com o endpoint /users/track, a importação de CSV ou a ingestão de dados na nuvem). Se o SDK do seu app não tiver um campo dedicado para native_line_id, envie-o em atualizações de usuário do lado do servidor usando um desses métodos.
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 selo cinza e não aparece nos resultados de pesquisa do app LINE. |
| Conta verificada | Uma conta que passou pela triagem da LINE Yahoo. Essa conta é representada por um selo azul e aparece nos resultados de pesquisa do app LINE. Essa conta está disponível apenas para contas sediadas no Japão, em Taiwan, na Tailândia e na Indonésia. |
| Conta premium | Uma conta que passou pela triagem da LINE Yahoo. Essa conta é representada por um selo verde e aparece nos resultados de pesquisa do app LINE. Esse tipo de conta é concedido automaticamente durante a triagem, a critério da LINE. |
Tipo de conta necessário
Para sincronizar seguidores com a Braze, sua conta LINE precisa ser verificada ou premium. Quando você cria uma conta, o status padrão dela é não verificada. Então, você precisará solicitar a verificação da conta.
Solicitação de uma conta LINE verificada

As contas verificadas estão disponíveis apenas para contas sediadas no Japão, em Taiwan, na Tailândia e na Indonésia.
- Na página Official Account da LINE, selecione Settings.
- Em Information Disclosure Verification Status, selecione Request Account Verification.
- Insira as informações necessárias.
- Aguarde uma notificação com os resultados da revisão.
Integração do LINE
Para configurar atualizações consistentes de usuários, importar os IDs do LINE dos usuários existentes e sincronizá-los com os estados de inscrição do LINE, siga estas etapas:
- Importe ou atualize os usuários conhecidos existentes
- Integre o canal do LINE
- Reconcilie os IDs de usuário
- Altere os métodos de atualização de usuários
- (Opcional) Mescle os perfis de usuário

Cada espaço de trabalho aceita um provedor do LINE. Você pode conectar várias contas do LINE em um mesmo provedor do LINE. Se precisar de mais de um provedor, use um espaço de trabalho separado para cada um.
Etapa 1: Importar ou atualizar usuários existentes do LINE
Esta etapa é necessária se você tiver um usuário do LINE existente e identificado, pois a Braze vai extrair automaticamente o status da inscrição dele e atualizar o perfil de usuário correto. Se você ainda não reconciliou usuários com o ID do LINE deles, pule esta etapa.
Você pode importar ou atualizar usuários usando qualquer um dos métodos compatíveis com a Braze, incluindo o endpoint /users/track, a importação de CSV ou a ingestão de dados na nuvem.
Independentemente do método usado, atualize o native_line_id para fornecer o ID do LINE do usuário. Para saber mais sobre o native_line_id, consulte Configuração de usuários.

Não especifique o status do grupo de inscrições, pois ele será ignorado. O LINE é a fonte da verdade para o status de inscrição do usuário, que é sincronizado com a Braze pela ferramenta de sincronização de inscrições ou por atualizações de eventos.
Etapa 2: Integrar o canal LINE
Depois que o processo de integração terminar, a Braze vai puxar automaticamente os seguidores do LINE desse canal para a Braze. Os IDs do LINE que já estão associados a um perfil de usuário da Braze são atualizados com o status “subscribed”. Os IDs do LINE restantes geram usuários anônimos. Além disso, quando novos seguidores começam a seguir seu canal LINE, perfis de usuário não identificados são criados para eles.
Etapa 2.1: Editar as configurações de webhook
- No LINE, acesse a guia Messaging API e edite as Webhook settings:
- Defina a Webhook URL como
https://anna.braze.com/line/events.- Durante a integração, a Braze muda automaticamente essa URL para outra, com base no cluster do seu dashboard.
- Ative Use webhook e Webhook redelivery.

- Defina a Webhook URL como
- Anote as seguintes informações da guia Providers:
| Tipo de informação | Local |
|---|---|
| ID do provedor | Selecione seu provedor e acesse Settings > Basic information |
| ID do canal | Selecione seu provedor e acesse Channels > seu canal > Basic settings |
| Segredo do canal | Selecione seu provedor e acesse Channels > seu canal > Basic settings. |
| Token de acesso do canal | Selecione seu provedor e acesse Channels > seu canal > Messaging API. Se não houver um token de acesso do canal, selecione Issue. |

Você pode atualizar ou alternar o segredo do canal e o token de acesso do canal de um canal LINE já integrado. Para isso, acesse Integrações de parceiros > Parceiros de tecnologia > LINE e selecione sua integração.
- Acesse a página Settings > Response settings e faça o seguinte:
- Desative Greeting message. Isso pode ser feito na Braze com um disparo quando o usuário seguir o canal.
- Desative Auto-response messages. Todas as mensagens disparadas devem passar pela Braze. Isso não impede que você envie mensagens diretamente pelo console do LINE.
- Ative Webhooks.

Etapa 2.2: Gerar grupos de inscrições do 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 do LINE funcionam, consulte Grupos de inscrições do LINE.

Você pode adicionar até 450 grupos de inscrições por espaço de trabalho.
- Acesse a página de parceiros de tecnologia da Braze para o LINE e insira as informações que você anotou na guia Providers do LINE:
- ID do provedor
- ID do canal
- Segredo do canal
- Token de acesso do canal
Se quiser adicionar uma lista de permissões de IP na sua conta do LINE, adicione à lista todos os endereços IP do seu cluster indicados em Lista de permissões de IP.

Durante a integração, confira se o segredo do canal está correto. Se estiver incorreto, pode haver inconsistências no status de inscrição.

- Depois da conexão, a Braze gera automaticamente um grupo de inscrições da Braze para cada integração do LINE adicionada com sucesso ao seu espaço de trabalho.
Qualquer alteração na sua lista de seguidores (como novos seguidores ou pessoas que deixaram de seguir) será enviada automaticamente para a Braze.

Etapa 3: Reconciliar IDs de usuário
Combine os IDs LINE dos seus usuários com os perfis de usuário que eles já têm na Braze seguindo as etapas em Reconciliação de IDs de usuário.
Etapa 4: Altere seus métodos de atualização de usuários
Se você já tem um método para enviar atualizações de usuários para a Braze, precisará atualizá-lo para incluir o novo campo native_line_id. Assim, as próximas atualizações de usuários enviadas para a Braze incluirão esse campo.
Podem existir na Braze perfis de usuário não identificados com um native_line_id. Eles são criados durante o processo de sincronização do status de inscrição ou quando um novo seguidor passa a seguir seu canal.
Quando um usuário do LINE é identificado no seu aplicativo por meio da reconciliação de usuários ou de outra forma, 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 tem um alias de usuário line_id, que pode ser usado para direcionar o perfil de usuário a ser identificado.
Veja a seguir 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:
{
"aliases_to_identify": [
{
"external_id": "known_external_id_from_your_application",
"user_alias": {
"alias_name": "U89f4a626548ccd48482f529a482f138b",
"alias_label": "line_id"
}
}
]
}
Se não houver um perfil de usuário para o external_id informado, ele será adicionado ao perfil de usuário não identificado, que passará a ser identificado. Se já existir um perfil de usuário para o external_id, todos os atributos presentes exclusivamente no perfil de usuário não identificado serão copiados para o perfil de usuário conhecido, incluindo o native_line_id e o status de inscrição do usuário.
Você pode atualizar usuários do LINE conhecidos no seu aplicativo pelo endpoint /users/track, informando os identificadores externos e o native_line_id deles. Se já existir um perfil de usuário não identificado para um usuário e o mesmo native_line_id for adicionado a outro perfil de usuário por meio de /users/track, esse perfil herdará todos os estados de inscrição do perfil de usuário não identificado. No entanto, haverá perfis de usuário duplicados com o mesmo native_line_id. Todas as atualizações de inscrição posteriores, vindas de atualizações de eventos, vão atualizar todos os perfis correspondentes.

Os estados de inscrição do LINE são rastreados pelo native_line_id, e não pelo external_id. Por exemplo, se o perfil do Usuário B for criado com o mesmo native_line_id do Usuário A, mas não com o mesmo external_id, o Usuário B herdará o status de inscrição do LINE do Usuário A.
Veja a seguir um exemplo de carga útil para /users/track que atualiza um perfil de usuário pelo ID externo do usuário para adicionar um native_line_id:
{
"attributes": [
{
"external_id": "known_external_id_from_your_application",
"native_line_id": "U89f4a626548ccd48482f529a482f138b",
"other": "attribute"
}
]
}
Etapa 5: Mesclar perfis (opcional)
Como descrito anteriormente nesta seção, é possível que existam vários perfis de usuário com o mesmo native_line_id. Se os 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 direciona um perfil de usuário não identificado pelo alias de usuário 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 saber mais sobre como gerenciar usuários duplicados na Braze, consulte Usuários duplicados.
Configuração do usuário
O LINE é a fonte da verdade para os status de inscrição dos usuários. Mesmo que você tenha o ID do LINE de um usuário (native_line_id), o LINE não vai entregar mensagens a esse usuário se ele não seguir o canal do LINE que você usa para enviar.
Para ajudar nesse gerenciamento, a Braze oferece ferramentas e lógica que apoiam uma base de usuários bem integrada. Isso inclui a sincronização de inscrições e atualizações de eventos quando usuários seguem ou deixam de seguir o canal 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 seguir e deixar de seguir 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:
- No espaço de trabalho original, arquive o grupo de inscrições desse canal.
- No espaço de trabalho de destino, integre o canal seguindo a Etapa 2: Integrar o canal LINE.
Confirme que você tem a permissão Gerenciar grupos de inscrições nos dois espaços de trabalho. Sem permissões em ambos, a integração falha com um erro informando que o canal já está conectado.
Para saber como o arquivamento afeta os grupos de inscrições, consulte Grupos de inscrições do LINE.
Casos de uso
Estes são casos de uso que mostram como os usuários podem ser atualizados depois que você segue as etapas de configuração.
O perfil de usuário existente da Braze já segue o canal LINE
- O perfil de usuário da Braze é atualizado com um atributo
native_line_id. O status de inscrição padrão éunsubscribed. - A ferramenta de sincronização de inscrições é executada e descobre que o usuário segue o canal LINE. Então, ela atualiza o perfil de usuário com o status de inscrição
subscribed. - Se ocorrer alguma mudança no status de inscrição (por exemplo, se o usuário bloquear, desfazer a amizade 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_idde acordo.
O perfil de usuário existente bloqueou, desfez a amizade ou deixou de seguir o canal LINE
- O perfil de usuário da Braze é atualizado com um atributo
native_line_id. O status de inscrição padrão éunsubscribed. - A ferramenta de sincronização de inscrições não encontra o usuário como seguidor do canal LINE, e o status de inscrição do usuário permanece
unsubscribed. - Se o usuário seguir o canal mais tarde, 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 depois de seguir o LINE
- O canal ganha um novo seguidor no LINE.
- A Braze cria um perfil de usuário anônimo com o atributo
native_line_iddefinido como o ID do LINE do seguidor e um alias de usuárioline_idtambém definido como o ID do LINE do seguidor. O perfil tem o status de inscriçãosubscribed. - O usuário é identificado como portador do ID do LINE por meio da reconciliação de usuários.
- O perfil de usuário anônimo pode ser identificado usando o endpoint
/users/identify. As atualizações seguintes desse perfil de usuário (pelo endpoint/users/track, por importação de CSV ou pela ingestão de dados na nuvem) podem direcionar o usuário por esseexternal_idconhecido.
- O perfil de usuário anônimo pode ser identificado usando o endpoint
{
"aliases_to_identify": [
{
"external_id": "known_external_id_from_your_application",
"user_alias": {
"alias_name": "U89f4a626548ccd48482f529a482f138b",
"alias_label": "line_id"
}
}
]
}
- Também é possível criar um novo perfil de usuário definindo o
native_line_id(pelo endpoint/users/track, por importação de CSV ou pela ingestão de dados na nuvem). Esse novo perfil herda o status de inscrição do perfil de usuário anônimo existente. Observe que isso resulta em vários perfis com o mesmonative_line_id. Eles podem ser mesclados a qualquer momento usando o endpoint/users/merge, conforme o processo descrito na Etapa 5.
A criação do perfil de usuário ocorre antes de seguir o LINE
- Você adquire um novo usuário e envia as informações para a Braze. Um novo perfil de usuário é criado (perfil 1).
- O usuário segue sua conta do LINE.
- A Braze recebe um evento de seguir e cria um perfil de usuário anônimo (perfil 2).
- O usuário é identificado como portador do ID do LINE por meio da reconciliação de usuários.
- Você atualiza o perfil 1 para definir o atributo
native_line_id. Esse perfil herda o 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, conforme o processo descrito na Etapa 5.
- Agora existem dois perfis de usuário com o mesmo
Reconciliação de IDs de usuário
A Braze recebe os IDs do LINE automaticamente quando um usuário segue seu canal ou quando você usa o fluxo de trabalho único de “sincronizar seguidores”. Os IDs do LINE são específicos de cada provedor do LINE, então é pouco provável que os usuários consigam informar seus próprios IDs do LINE.
Há duas maneiras de vincular um ID do LINE a um perfil de usuário existente na Braze:
Login do LINE
Esse método usa logins de redes sociais para a reconciliação. Quando um usuário faz login no seu app, ele tem a opção de usar o Login do LINE para criar uma conta de usuário ou entrar.

Para obter o ID do LINE correto de cada usuário, configure o Login do LINE no mesmo provedor da sua conta oficial ou canal do LINE integrado à Braze.
-
Acesse o console de desenvolvedor do LINE e solicite permissão para obter os endereços de e-mail dos usuários que fazem login no seu app pelo Login do LINE.
-
Siga as etapas indicadas pelo LINE para implementar o Login do LINE:
- Instruções para web app
- Instruções para app nativo
Incluaemailna configuração de escopo das solicitações de verificação.
-
Use a chamada Verify ID token para obter o e-mail do usuário.
-
Salve o ID do LINE do usuário (
native_line_id) no perfil do usuário com o 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. -
Envie as informações novas ou atualizadas do usuário para a Braze usando o endpoint
/user/track, a importação de CSV ou a ingestão de dados na nuvem.
Fluxos de trabalho
Seguidor existente usa o Login do LINE
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”.
- O usuário faz login no seu app usando o Login do LINE.
- O LINE fornece a você o e-mail do usuário.
- Você envia à Braze o usuário atualizado (o perfil de usuário existente com esse e-mail, para adicionar o ID do LINE) ou atualiza o usuário anônimo com o e-mail.
Novo seguidor usa o Login do LINE
Cenário: Não existe nenhum perfil de usuário na Braze com o ID do LINE do usuário.
- O usuário faz login no seu app usando o Login do LINE.
- O LINE fornece a você o e-mail do usuário.
- Você pode:
- Atualizar um perfil de usuário existente com esse 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.
- 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 contas de usuário
Esse método permite que os usuários vinculem a conta do LINE à conta de usuário do seu app. Depois, você pode usar Liquid na Braze, como {{line_id}}, para criar um URL personalizado que envia o ID do LINE do usuário de volta ao seu site ou app. Assim, esse ID pode ser associado a um usuário conhecido.
- Crie um Canvas baseado em ação, com base em uma mudança no estado de inscrição, que seja disparado quando um usuário se inscrever no seu canal do LINE.

- Crie uma mensagem que incentive os usuários a fazer login no seu site ou app, passando o ID do LINE do usuário como parâmetro de consulta (via Liquid), por exemplo:
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=
- Crie uma mensagem de acompanhamento que entregue o código do cupom.
- (Opcional) Crie uma Campaign ou um Canvas baseado em ação que seja disparado quando o usuário do LINE for identificado, para enviar o código do cupom ao usuário.

Como funciona
Depois que o usuário faz login, seu site ou app envia o ID do usuário de volta à Braze para associá-lo ao ID do LINE passado no URL, com um código de exemplo 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");
}
Fluxos de trabalho
Usuário existente segue seu canal do LINE
Cenário: Um usuário existente na Braze segue seu canal no LINE.
- O LINE envia à Braze um evento de “seguir”.
- A Braze cria um perfil de usuário anônimo com o ID do LINE, o alias de usuário
line_ide o statussubscribedno grupo de inscrições do LINE. - O usuário recebe uma mensagem do LINE com um link para seu site e app e faz login. Agora, o perfil desse usuário é conhecido.
- O perfil de usuário anônimo criado é identificado e mesclado ao perfil conhecido do usuário por meio do endpoint /users/identify. O perfil de usuário conhecido passa a conter o ID do LINE e tem o status de inscrição
subscribed. - (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.
Criação de usuários teste do LINE na Braze
Você pode testar seu canal LINE antes de configurar a reconciliação de usuários criando um Canvas ou Campaign “Who am I”.
-
Configure um Canvas que retorne o ID de usuário da Braze quando alguém enviar uma palavra de gatilho específica.
Exemplo de gatilho
Exemplo de mensagem
-
Na Braze, você pode usar o ID da Braze para pesquisar usuários específicos e modificá-los conforme necessário.

Confira se o Canvas não tem controle global nem grupos de controle que impeçam os envios.