LINE #

Conecte sua própria LINE Official Account para que suas conversas no LINE fluam para o aplicativo e um Agente de IA possa responder. Você conecta colando suas credenciais da LINE Messaging API (Channel secret + access token) e configurando uma URL de webhook — sem necessidade de programação.

O que é a integração com o LINE? #

A integração com o LINE vincula uma LINE Official Account (OA) que você possui à plataforma usando a Messaging API oficial do LINE — o próprio sistema do LINE para enviar e receber mensagens automaticamente, em vez de você digitá-las manualmente no aplicativo LINE. Seus chats individuais com pessoas que adicionaram sua OA como amiga ficam disponíveis dentro do aplicativo, e um Agente de IA, transmissões e uma caixa de entrada compartilhada funcionam sobre eles.

Ao contrário do Telegram ou do WhatsApp Web, esta é uma integração oficial — ela usa a própria API de Mensagens do LINE, portanto, é estável e está dentro das regras do LINE. Como o LINE não possui um botão de “conectar” com um clique para ferramentas de terceiros, você cola as credenciais da sua OA uma vez durante a configuração.

Disponibilidade. As Contas Oficiais do LINE são mais comuns no Japão, Taiwan, Tailândia e Indonésia, e não estão disponíveis na UE. Você precisa de uma Conta Oficial do LINE registrada em uma região suportada para usar este canal.

Antes de começar #

Você criará (ou usará) três coisas nos próprios consoles do LINE. Esta é uma configuração única de cerca de 5 minutos.

1. Uma LINE Official Account (criada no LINE Official Account Manager). Se você ainda não tem uma, faça login com seu LINE Business ID e crie uma nova conta — dê um nome a ela e preencha o formulário curto.
2. Um canal de Messaging API para essa OA. A maneira mais fácil é ativá-lo dentro do OA Manager (veja o Passo 1 abaixo) — você não precisa criar o canal manualmente no Developers Console primeiro. Quando solicitado, escolha um provedor existente ou crie um novo.
3. Desse canal, três valores que você colará no aplicativo:
   • Channel ID (aba Basic settings) — opcional, apenas informativo
   • Channel secret (aba Basic settings)
   • Channel access token — um token de longa duração que você emite na aba Messaging API

Nenhum documento comercial é necessário para uma Conta Oficial padrão (não verificada) — apenas um LINE Business ID. A verificação (o selo azul) é opcional e oferecida apenas em algumas regiões.

Configurando o LINE #

Passo 1: Ative a Messaging API para sua Official Account #

1. Faça login no LINE Official Account Manager (ou crie uma nova Official Account primeiro).
2. Abra sua OA.
3. Clique em Settings (canto superior direito).
4. No menu de configurações, clique em Messaging API.
5. O status começa como Disabled — clique para ativá-lo.
6. Escolha o provedor para este canal (a empresa/desenvolvedor que o possui). Se você ainda não tem um, crie um novo provedor e confirme.

Passo 2: Obtenha suas credenciais no Developers Console #

Ativar a Messaging API cria um canal sob seu provedor no LINE Developers Console.

1. Abra a conta de desenvolvedor / provedor.
2. Clique no canal de Messaging API.
3. Abra a aba Basic settings e copie seu Channel ID e Channel secret.
4. Abra a aba Messaging API, emita (ou gere novamente) um Channel access token de longa duração e copie-o.

Mantenha esses valores à mão — você os colará no aplicativo em seguida.

Passo 3: Conecte o LINE no aplicativo #

1. Na barra lateral esquerda, clique em Settings próximo à parte inferior.
2. Na barra lateral de Settings, em Channels, clique em Channels.
3. Encontre o cartão LINE e clique em Connect.
4. Opcionalmente, cole seu Channel ID — apenas para fins informativos.
5. Cole seu Channel secret.
6. Cole seu Channel access token.
7. Clique em Connect.
8. O aplicativo valida as credenciais com o LINE e exibe “Connected to: <seu nome OA>”. Se as credenciais estiverem incorretas, você receberá um erro — gere novamente o token de acesso no LINE Developers Console e tente novamente.

Passo 4: Defina a Webhook URL no LINE #

Após conectar, o aplicativo mostra uma seção Finish setup in LINE com uma webhook URL — copie-a. (Uma webhook URL é apenas um endereço web; colá-la no LINE diz ao LINE para onde enviar automaticamente novas mensagens.) Então, no LINE Developers Console para seu canal de Messaging API:

1. Abra a aba Messaging API.
2. Cole a URL em Webhook URL.
3. Clique em Update.
4. Ative Use webhook (ON).

Passo 5: Ajuste as configurações do Official Account Manager (Importante) #

Por padrão, uma LINE OA gerencia chats e respostas automáticas por conta própria, o que impede que as mensagens cheguem à IA. De volta ao LINE Official Account Manager, abra as configurações da sua OA e defina:

Se o aplicativo avisar que sua conta está no Chat mode, alterne para Bot mode aqui — o bot não poderá receber ou enviar mensagens até que você faça isso.

Passo 6: Teste o bot #

1. De um telefone diferente (por exemplo, seu próprio aplicativo LINE), adicione sua Official Account como amiga e envie uma mensagem.
2. Abra o aplicativo e vá para Chats — a mensagem recebida aparece na lista de conversas.
3. Se um Agente de IA estiver gerenciando este canal, você o verá responder automaticamente à mensagem de teste.

Uma vez conectado com o webhook configurado e as opções acima corretas, sua conta LINE aparece como Connected na página Channels e a IA responde às mensagens recebidas.

Custo #

O LINE é um canal gratuito no aplicativo — não há cobrança por mensagem nem taxa de conexão mensal da nossa parte. Observe que os planos do próprio LINE têm seus próprios limites mensais de mensagens push (envios proativos), que variam por região e tipo de conta. As respostas enviadas logo após um cliente enviar uma mensagem para você são gratuitas no LINE; envios proativos/transmissões contam contra a cota do seu plano LINE.

Mensagens de mídia #

Fotos, vídeos, notas de voz, arquivos, figurinhas e localizações recebidos são reconhecidos para que a IA saiba que uma mídia foi enviada (uma breve nota é adicionada à conversa). As respostas da IA enviadas são texto e imagens nesta versão. Respostas longas são automaticamente cortadas para o limite de 5.000 caracteres do LINE.

Gerenciamento de Sessão #

Verificando o Status da Conexão #

O status da sua conexão LINE é exibido no cartão LINE na página Canais:

O cartão também verifica novamente a configuração de Modo de chat da sua conta toda vez que você abre a página de Canais. Se sua conta LINE tiver sido alterada de volta para o Modo de chat (o que impede o bot de receber ou enviar mensagens), um aviso âmbar aparecerá no cartão informando que você deve alterá-la de volta para o Modo de bot no LINE Official Account Manager — verifique novamente as opções do Passo 5 lá e o aviso desaparecerá na próxima visita.

Desconectando #

Abra o cartão LINE e clique em Gerenciar, depois clique em Desconectar no painel que se abre e confirme Remover LINE?. Isso remove a conexão do nosso lado. Para impedir totalmente que o LINE envie eventos, também desative Usar webhook (ou exclua a URL do webhook) no Console de Desenvolvedores do LINE.

Limitações #

• Uma Official Account por conexão. Conecte cada OA separadamente; uma OA só pode ser vinculada a uma conta.
• Envio de texto + imagem. A IA responde com texto e imagens; mensagens ricas do tipo “Flex”, modelos ou carrosséis não são enviados nesta versão.
• Região. As LINE Official Accounts não estão disponíveis na UE; você precisa de uma OA em uma região suportada (por exemplo, Japão, Taiwan, Tailândia, Indonésia).
• Tempo de resposta. As respostas instantâneas gratuitas do LINE possuem uma janela de tempo curta; mensagens enviadas posteriormente são entregues automaticamente como mensagens push (contabilizadas na cota).

Solução de problemas #

Credenciais Rejeitadas ao Conectar #

• Certifique-se de ter criado um canal de Messaging API (não “LINE Login”).
• Gere novamente um token de acesso de canal de longa duração na aba Messaging API e cole o novo valor.
• Confirme se você copiou o Channel secret da aba de configurações básicas (não o Channel ID).

O bot não está respondendo #

• Confirme se Webhooks está Ativado tanto no Developers Console quanto no OA Manager.
• Confirme se a Webhook URL corresponde à exibida no aplicativo.
• Confirme se o Modo de resposta está como Bot (não Chat) no OA Manager.

O cliente recebe duas respostas #

• Desative as Mensagens de resposta automática e as Mensagens de saudação no OA Manager — as respostas automáticas nativas do LINE estão sendo enviadas junto com a IA.

As mensagens não chegam ao aplicativo #

• Verifique se o contato adicionou sua Conta Oficial como amigo (o LINE só entrega mensagens de amigos).
• Verifique novamente a URL do webhook e se a opção Usar webhook está ativada.

Melhores práticas #

• Conclua as configurações no OA Manager (modo Bot, Webhooks ativados, Saudação + Resposta automática desativadas) — a maioria dos problemas de configuração vem daqui.
• Responda prontamente para manter as respostas dentro da janela gratuita do LINE e conservar sua cota de push.
• Mantenha seu token de acesso seguro — qualquer pessoa com ele pode enviar mensagens como sua Conta Oficial. Gere-o novamente no Developers Console caso ele vaze.