Integração com o canal LINE

Atualizado em 20 de out. de 20265 min de leitura

Português

Nesta página

Conecta sua LINE Official Account ao Deskwoot pra tratar mensagens de cliente LINE na sua inbox compartilhada. Três valores da LINE Developers Console (Channel Access Token de longa duração, Channel Secret e Bot User ID), uma URL de webhook colada de volta no LINE, e você está ao vivo. Grande ganho pra times suportando Japão, Tailândia, Taiwan ou Indonésia onde LINE é dominante.

O LINE é uma das plataformas de mensagens mais populares no Japão, na Tailândia, em Taiwan e na Indonésia. Ao conectar uma Conta Oficial do LINE à Deskwoot, sua equipe pode receber e responder mensagens do LINE diretamente da sua caixa de entrada compartilhada, junto com todos os outros canais de suporte que você usa. Este guia mostra os pré-requisitos, os passos de configuração e dicas para uma integração tranquila.

Pré-requisitos

Conta Oficial do LINE. Se você ainda não tem uma, crie-a no LINE Official Account Manager.
Acesso ao LINE Developers Console. Faça login em developers.line.biz com a mesma conta que possui ou administra sua Conta Oficial.
Canal da Messaging API. Dentro do LINE Developers Console, crie um canal da Messaging API vinculado à sua Conta Oficial. Isso gera as credenciais de que a Deskwoot precisa.

Conectar à Deskwoot

Faça login no seu painel da Deskwoot e acesse Configurações > Caixas de entrada > Adicionar caixa de entrada.
Selecione LINE na lista de tipos de canal disponíveis.
Digite as seguintes credenciais do seu canal da Messaging API no LINE Developers Console:
- Channel Access Token (recomenda-se um token de longa duração)
- Channel Secret (Basic settings)
- Bot User ID (Messaging API > Bot info; necessário para que as mensagens recebidas cheguem a esta caixa de entrada)
O formulário também mostra a URL de webhook (https://deskwoot.com/api/webhooks/line). Copie-a e clique em Criar caixa de entrada.
Volte ao LINE Developers Console e cole-a no campo Webhook URL do seu canal da Messaging API. Verifique se a opção Use webhook está ativada.

Assim que o webhook for verificado, as mensagens recebidas pelo LINE aparecerão na sua caixa de entrada da Deskwoot em tempo real.

Solução de problemas e armadilhas comuns

Mensagens não chegam: confirme se a URL do webhook foi colada corretamente no LINE Developers Console, se a opção Use webhook está ativada e se o Bot User ID na Deskwoot é deste canal. Até um espaço sobrando no final da URL pode causar falhas.
Erro de credenciais inválidas: confira novamente se você está copiando o Channel Secret, o Channel Access Token e o Bot User ID do canal da Messaging API, e não de um canal de LINE Login ou de outro provedor.
Conflitos de resposta automática: se as respostas automáticas ou mensagens de boas-vindas integradas do LINE ainda estiverem ativas, os clientes podem receber respostas duplicadas. Desative-as no LINE Official Account Manager em Response settings.

Dicas de boas práticas

Use um Channel Access Token de longa duração para não precisar trocar as credenciais com frequência.
Atribua a caixa de entrada do LINE a uma equipe ou grupo de agentes dedicado para garantir que as mensagens do seu público do LINE recebam respostas pontuais e adequadas à região.
Aproveite os recursos do bot de IA da Deskwoot para lidar automaticamente com dúvidas comuns do LINE, liberando seus agentes para conversas mais complexas.

Perguntas frequentes

Preciso de LINE Official Account?

Sim. Cria uma no LINE Official Account Manager (manager.line.biz) se ainda não tem. Tier gratuito é ok pra começar.

Onde acho Channel Secret, Token e Bot User ID?

LINE Developers Console (developers.line.biz) → seu Messaging API channel. Channel secret na aba Basic settings; Channel access token (gera long-lived) e, em Bot info, o Bot User ID ficam na aba Messaging API.

Por que Messaging API channel e não LINE Login channel?

Messaging API trata conversas two-way de cliente. LINE Login é pra OAuth user sign-in. Produtos diferentes apesar da UI parecida na Developers Console.

Mensagens não estão chegando. O que está errado?

Mais comum: URL de webhook tem espaço final, OU 'Use webhook' não está ligado na LINE Developers Console. Confere também que colou a URL exatamente como Deskwoot mostrou e que o Bot User ID é deste canal.

E se o auto-reply built-in do LINE está ligado?

Desativa no LINE Official Account Manager → Response settings. Senão clientes ganham tanto o auto-reply do LINE QUANTO a resposta do agente Deskwoot, o que é confuso.

Posso conectar várias LINE Official Accounts?

Sim. Cada vira uma inbox Deskwoot separada. Repete o setup por conta e usa a mesma URL de webhook em cada channel; o Deskwoot direciona as mensagens pelo Bot User ID. O plano Hacker inclui 1 inbox além das de chat ao vivo e encaminhamento de e-mail.

Stickers e imagens são suportados?

Stickers, imagens, vídeo, áudio, arquivos e localizações de entrada aparecem na conversa como uma nota curta ([Sticker], [Image] etc.), não como a mídia em si. Saída: pode mandar texto, imagens JPEG e PNG e outros arquivos como link; tipos de mensagem LINE-específicos (flex, carousel) não estão na UI de reply.

E se meu token expira?

Long-lived tokens (recomendado) não expiram sozinhos. Short-lived sim. Sem token válido o Deskwoot não consegue mandar respostas nessa inbox, e as configurações da inbox não têm campo pra trocar o token, então começa com um long-lived.

Tem custo por mensagem LINE?

Pricing próprio do LINE vale (grátis pras primeiras N mensagens/mês, depois por mensagem). Deskwoot não adiciona fee; é o contador padrão de AI conversation se o bot responder.

O bot pode responder mensagens LINE?

Sim. É o mesmo Fynn (a partir do plano Startup), com respostas em vários idiomas, como japonês, tailandês ou chinês, conforme a mensagem recebida. O Fynn responde mensagens de texto; figurinhas, imagens, mensagens de voz e outras mídias ficam para a sua equipe, porque o áudio do LINE não é transcrito. Acima da primeira resposta do Fynn, o cliente vê uma linha como "Fynn, o assistente de IA de Acme". Muito útil para cobrir horários fora do expediente nos fusos da Ásia e do Pacífico.

E sobre rich menus LINE?

Rich menus são configurados do lado LINE, e o Deskwoot não mostra nem edita eles. Um botão do menu que manda uma mensagem de texto chega no Deskwoot como qualquer mensagem do cliente; ações de postback não são repassadas ao Deskwoot.

Este guia foi útil?

Continue lendo

Perguntar ao Fynn sobre este guia

Receba uma resposta curta deste guia e do resto da Central de Ajuda.