# 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](https://manager.line.biz)). 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](https://manager.line.biz) (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](https://developers.line.biz/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: \"**. 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](https://manager.line.biz), abra as configurações da sua OA e defina: | Configuração | Valor necessário | Por que | |---|---|---| | **Chat** | **On** | Ativa o chat para que a conversa flua (permite usar o filtro de chat). | | **Response mode** | **Bot** | Permite que a API (seu Agente de IA) gerencie as mensagens. O modo "Chat" apenas as bloqueia. | | **Response hours / Auto-response messages** | **Off** | Desativa as respostas automáticas do próprio LINE para que a IA gerencie as respostas (a causa nº 1 de "respostas duplicadas"). | | **Greeting messages** | **Off** | Impede que a saudação automática do LINE compita com a IA. | | **Webhooks** | **On** | Para que o LINE encaminhe mensagens para o aplicativo. | > 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**: | Status | Significado | |---|---| | **Connected** | Uma conta oficial do LINE está vinculada a esta conta | | **Not connected** | Nenhuma conexão configurada | 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.