# LINE Ligue a sua própria **Conta Oficial LINE** para que as suas conversas no LINE fluam para a aplicação e um Agente de IA possa responder. Pode ligá-la colando as suas credenciais da API de Mensagens do LINE (segredo do canal + token de acesso) e definindo um URL de webhook — não é necessária programação. --- ## O que é a integração com o LINE? A integração com o LINE liga uma **Conta Oficial LINE (OA)** que possui à plataforma utilizando a API de Mensagens oficial do LINE — o sistema do próprio LINE para enviar e receber mensagens automaticamente, em vez de as escrever manualmente na aplicação LINE. As suas conversas individuais com pessoas que adicionaram a sua OA como amiga ficam disponíveis dentro da aplicação, e um Agente de IA, Transmissões e uma caixa de entrada partilhada funcionam sobre elas. Ao contrário do Telegram ou do WhatsApp Web, esta é uma integração **oficial** — utiliza a própria API de Mensagens do LINE, pelo que é estável e cumpre as regras do LINE. Como o LINE não tem um botão de "ligar" com um clique para ferramentas de terceiros, cola as credenciais da sua OA uma vez durante a configuração. > **Disponibilidade.** As Contas Oficiais LINE são mais comuns no Japão, Taiwan, Tailândia e Indonésia, e **não estão disponíveis na UE**. Precisa de uma Conta Oficial LINE registada numa região suportada para utilizar este canal. --- ## Antes de começar Irá criar (ou utilizar) três coisas nas consolas do próprio LINE. Esta é uma configuração única de cerca de 5 minutos. 1. Uma **Conta Oficial LINE** (criada no [LINE Official Account Manager](https://manager.line.biz)). Se ainda não tiver uma, inicie sessão com o seu LINE Business ID e **crie uma nova conta** — dê-lhe um nome e preencha o formulário curto. 2. Um **canal da API de Mensagens** para essa OA. A forma mais fácil é ativá-lo a partir do interior do OA Manager (consulte o Passo 1 abaixo) — não precisa de criar o canal manualmente na Consola de Programadores primeiro. Quando solicitado, escolha um **fornecedor** existente ou crie um novo. 3. Desse canal, três valores que irá colar na aplicação: - **ID do canal** (separador Definições básicas) — opcional, apenas informativo - **Segredo do canal** (separador Definições básicas) - **Token de acesso ao canal** — um token de longa duração que emite no separador **API de Mensagens** Não são necessários documentos comerciais para uma Conta Oficial padrão (não verificada) — apenas um LINE Business ID. A verificação (o emblema azul) é opcional e apenas oferecida em algumas regiões. --- ## Configurar o LINE ### Passo 1: Ativar a Messaging API para a sua Official Account 1. Inicie sessão no [LINE Official Account Manager](https://manager.line.biz) (ou crie primeiro uma nova Conta Oficial). 2. Abra a sua OA. 3. Clique em **Definições** (canto superior direito). 4. No menu de definições, clique em **API de Mensagens**. 5. O estado começa como **Desativado** — clique para o ativar. 6. Escolha o **fornecedor** para este canal (a empresa/programador que o detém). Se ainda não tiver um, **crie um novo fornecedor** e confirme. ### Passo 2: Obter as suas credenciais da Developers Console Ativar a API de Mensagens cria um canal sob o seu fornecedor na [Consola de Programadores LINE](https://developers.line.biz/console/). 1. Abra a **conta de programador / fornecedor**. 2. Clique no **canal da API de Mensagens**. 3. Abra o separador **Definições básicas** e copie o seu **ID do canal** e **Segredo do canal**. 4. Abra o separador **API de Mensagens**, emita (ou regenere) um **Token de acesso ao canal** de longa duração e copie-o. > Mantenha estes valores à mão — irá colá-los na aplicação a seguir. ### Passo 3: Ligar o LINE na aplicação 1. Na barra lateral esquerda, clique em **Settings** perto da parte inferior. 2. Na barra lateral de definições, em **Channels**, clique em **Channels**. 3. Encontre o cartão **LINE** e clique em **Connect**. 4. Opcionalmente, cole o seu **Channel ID** — apenas para fins informativos. 5. Cole o seu **Channel secret**. 6. Cole o seu **Channel access token**. 7. Clique em **Connect**. 8. A aplicação valida as credenciais com o LINE e apresenta **"Connected to: \"**. Se as credenciais estiverem incorretas, receberá um erro — volte a emitir o token de acesso na LINE Developers Console e tente novamente. ### Passo 4: Definir o URL do Webhook no LINE Após a ligação, a aplicação mostra uma secção **Concluir configuração no LINE** com um **URL de webhook** — copie-o. (Um URL de webhook é apenas um endereço web; colá-lo no LINE indica ao LINE para onde enviar automaticamente novas mensagens.) Depois, na **Consola de Programadores LINE** para o seu canal da API de Mensagens: 1. Abra o separador **API de Mensagens**. 2. Cole o URL em **URL de Webhook**. 3. Clique em **Atualizar**. 4. Coloque **Utilizar webhook** em **ATIVADO**. ### Passo 5: Corrigir as definições do Official Account Manager (Importante) Por predefinição, uma OA do LINE gere conversas e *respostas automáticas* por si própria, o que impede que as mensagens cheguem à IA. De volta ao [LINE Official Account Manager](https://manager.line.biz), abra as definições da sua OA e defina: | Definição | Valor necessário | Porquê | |---|---|---| | **Chat** | **Ligado** | Ativa o chat para que a conversa flua (permite usar o filtro de chat). | | **Modo de resposta** | **Bot** | Permite que a API (o seu Agente de IA) processe mensagens. O modo apenas "Chat" bloqueia-as. | | **Horário de resposta / Mensagens de resposta automática** | **Desligado** | Desativa as respostas automáticas do próprio LINE para que a IA processe as respostas (a causa n.º 1 de "respostas duplas"). | | **Mensagens de saudação** | **Desligado** | Impede que a saudação automática do próprio LINE compita com a IA. | | **Webhooks** | **Ligado** | Para que o LINE reencaminhe mensagens para a aplicação. | > Se a aplicação avisar que a sua conta está em **Chat mode**, altere-a para **Bot mode** aqui — o bot não consegue receber nem enviar mensagens até que o faça. ### Passo 6: Testar o bot 1. A partir de um telemóvel diferente (por exemplo, a sua própria aplicação LINE), adicione a sua Conta Oficial como amiga e **envie-lhe uma mensagem**. 2. Abra a aplicação e vá a **Conversas** — a mensagem recebida aparece na lista de conversas. 3. Se um Agente de IA estiver a gerir este canal, verá que ele **responde automaticamente** à mensagem de teste. Uma vez ligado com o webhook definido e os interruptores acima corretos, a sua conta LINE aparece como **Ligada** na página Canais e a IA responde às mensagens recebidas. --- ## Custo O LINE é um canal **gratuito** na aplicação — não há custos por mensagem nem taxas de ligação mensais da nossa parte. Tenha em atenção que os **planos do próprio LINE** têm os seus próprios limites mensais de mensagens *push* (envios proativos), que variam consoante a região e o tipo de conta. As respostas enviadas pouco tempo depois de um cliente lhe enviar uma mensagem são gratuitas no LINE; os envios proativos/transmissões contam para a quota do seu plano LINE. --- ## Mensagens de multimédia As fotografias, vídeos, notas de voz, ficheiros, stickers e localizações recebidos são reconhecidos para que a IA saiba que foi enviado conteúdo multimédia (é adicionada uma pequena nota à conversa). As respostas da IA enviadas são **texto e imagens** nesta versão. As respostas longas são automaticamente cortadas para o limite de 5.000 caracteres do LINE. --- ## Gestão de Sessão ### Verificar o Estado da Ligação O estado da sua ligação LINE é apresentado no cartão **LINE** na página **Canais**: | Estado | Significado | |---|---| | **Ligado** | Uma Conta Oficial LINE está associada a esta conta | | **Não ligado** | Nenhuma ligação configurada | O cartão também verifica novamente a definição de **Modo de chat** da sua conta sempre que abre a página de Canais. Se a sua conta LINE tiver sido alterada novamente para o Modo de chat (o que impede o bot de receber ou enviar mensagens), aparecerá um aviso âmbar no cartão a indicar-lhe para mudar novamente para o **Modo de bot** no LINE Official Account Manager — verifique novamente os interruptores do Passo 5 aí e o aviso desaparecerá na visita seguinte. ### Desligar Abra o cartão **LINE** e clique em **Gerir**, depois clique em **Desligar** no painel que se abre e confirme **Remover LINE?**. Isto remove a ligação do nosso lado. Para impedir totalmente que o LINE envie eventos, desative também **Utilizar webhook** (ou elimine o URL do webhook) na Consola de Programadores LINE. --- ## Limitações - **Uma Official Account por ligação.** Ligue cada OA separadamente; uma OA só pode estar ligada a uma conta. - **Envio de texto + imagem.** O bot de IA responde com texto e imagens; mensagens "Flex"/modelos/carrosséis complexos não são enviados nesta versão. - **Região.** As LINE Official Accounts não estão disponíveis na UE; necessita de uma OA numa região suportada (por exemplo, Japão, Taiwan, Tailândia, Indonésia). - **Tempo de resposta.** As respostas instantâneas gratuitas do LINE têm uma janela temporal curta; as mensagens enviadas mais tarde são entregues automaticamente como mensagens push (contabilizadas na quota). --- ## Resolução de Problemas ### Credenciais Rejeitadas ao Ligar - Certifique-se de que criou um canal **Messaging API** (não "LINE Login"). - Volte a emitir um **token de acesso ao canal de longa duração** no separador Messaging API e cole o novo valor. - Confirme que copiou o **Channel secret** do separador Basic settings (não o Channel ID). ### O bot não responde - Confirme que os **Webhooks** estão **Ativados** (On) tanto na Developers Console como no OA Manager. - Confirme que o **Webhook URL** corresponde ao apresentado na aplicação. - Confirme que o **Modo de resposta** (Response mode) está definido 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 integradas do LINE estão a ser enviadas juntamente com as da IA. ### As mensagens não chegam à aplicação - Verifique se o contacto **adicionou a sua Conta Oficial como amigo** (o LINE apenas entrega mensagens de amigos). - Volte a verificar o URL do webhook e se a opção **Use webhook** está ativada. --- ## Melhores práticas - **Conclua as definições no OA Manager** (modo Bot, Webhooks ativados, Saudação + Resposta automática desativadas) — a maioria dos problemas de configuração provém daqui. - **Responda prontamente** para manter as respostas dentro da janela gratuita do LINE e poupar a sua quota de envio. - **Mantenha o seu token de acesso seguro** — qualquer pessoa com acesso ao mesmo pode enviar mensagens em nome da sua Conta Oficial. Volte a emiti-lo na Developers Console caso ocorra uma fuga de dados.