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). 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 (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.

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: <o nome da sua OA>”. 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, abra as definições da sua OA e defina:

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:

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.