Pular para o conteúdo principal

​
Configurar a integração do aplicativo Line na sua máquina local

Siga os passos se você estiver tentando trabalhar com a integração do Line em sua máquina local.

​
Pré-requisitos

  • Conta de Desenvolvedor Line
  • Acesso ao Line Developer Console
  • Ngrok ou serviço de tunelamento semelhante
  • Ambiente de desenvolvimento AirysChat em execução

​
Passos de Configuração

​
1. Iniciar Servidor Ngrok

Inicie um servidor Ngrok escutando na porta 3000 ou na porta em que você executará a instalação do AirysChat: 
# Install ngrok if you haven't already
# Download from https://ngrok.com/download

# Start ngrok tunnel
ngrok http 3000

​
2. Atualizar Variáveis de Ambiente

Atualize a variável FRONTEND_URL do .env no AirysChat com a versão https da URL do Ngrok: 
# In your .env file
FRONTEND_URL=https://your-ngrok-subdomain.ngrok.io

​
3. Configurar Line Developer Console

  1. Acessar Line Developer Console: Vá para Line Developer Console
  2. Criar um Provedor (Provider) (se você não tiver um)
  3. Criar um Novo Canal (Channel) e selecione “Messaging API”
  4. Definir Configurações Básicas:
    • Nome do canal
    • Descrição do canal
    • Categoria
    • Subcategoria

​
4. Obter Credenciais Necessárias

No Line Developer Console, no canal “Messaging API”, colete os seguintes valores:
  1. Nome do Canal (Channel Name)
  2. ID do Canal LINE (LINE Channel ID)
  3. Segredo do Canal LINE (LINE Channel Secret)
  4. Token do Canal LINE (LINE Channel Token)

​
5. Iniciar Servidor AirysChat

Inicie o servidor do AirysChat e crie um novo canal do Line com os valores obtidos no Line Developer Console: 
# Start the development server
make run
# or
foreman start -f Procfile.dev

​
6. Criar Canal do Line no AirysChat

  1. Acessar o AirysChat: Vá para a sua instância do AirysChat (http://localhost:3000)
  2. Navegar para Configurações → Caixas de Entrada → Adicionar Caixa de Entrada
  3. Selecionar Line como o tipo de canal
  4. Inserir Credenciais do Line:
    • Nome do Canal
    • ID do Canal LINE
    • Segredo do Canal LINE
    • Token do Canal LINE
  5. Salvar Configuração

​
Configurar Webhook no Line Developer Console

Depois de criar o canal, o AirysChat fornecerá uma URL de webhook para o canal. Você precisa configurar esta URL de webhook no Line Developer Console:

​
Passos para Configurar o Webhook

  1. Vá para o Line Developer Console → Seu Canal → Messaging API
  2. Encontrar Configurações de Webhook
  3. Definir URL do Webhook: Use a URL fornecida pelo AirysChat 
    https://your-ngrok-subdomain.ngrok.io/webhooks/line/your-channel-id
  4. Ativar Webhook: Alterne o webhook para “Ativado” (Enabled)
  5. Verificar Webhook: Use o botão “Verificar” (Verify) para testar a conexão

​
Configurações Adicionais do Line

Defina estas configurações no Line Developer Console:
  • Mensagens de resposta automática (Auto-reply messages): Desativar (para que o AirysChat possa lidar com as respostas)
  • Mensagens de saudação (Greeting messages): Opcional
  • Reenvio de webhook (Webhook redelivery): Ativar para confiabilidade

​
Testando a Integração

Se o webhook for registrado corretamente com o Line, seu servidor Ngrok deverá receber eventos para novas mensagens do Line, e novas conversas serão criadas no AirysChat.

​
Passos de Teste

  1. Adicione seu bot do Line como amigo usando o código QR ou ID do bot
  2. Envie uma mensagem para seu bot do Line
  3. Verifique os logs do Ngrok para ver se a solicitação de webhook foi recebida
  4. Verifique o AirysChat para ver se uma nova conversa foi criada
  5. Responda do AirysChat para testar a comunicação bidirecional

​
Solução de Problemas

Problema: A verificação do webhook do Line falha no Developer ConsoleSolução:
  • Certifique-se de que a URL do Ngrok esteja acessível publicamente
  • Verifique se a FRONTEND_URL está definida corretamente em seu arquivo .env
  • Verifique se o formato da URL do webhook está correto
  • Reinicie o AirysChat após atualizar as variáveis de ambiente
Problema: As mensagens do Line não criam conversas no AirysChatSolução:
  • Verifique os logs do Ngrok para solicitações de webhook recebidas
  • Verifique se o webhook está ativado no Line Developer Console
  • Verifique os logs do AirysChat para quaisquer mensagens de erro
  • Certifique-se de que todas as credenciais do Line foram inseridas corretamente
  • Verifique se o canal está ativado no AirysChat
Problema: Problemas de certificado SSL com o webhookSolução:
  • Use a versão https de sua URL do Ngrok
  • Certifique-se de que o Ngrok esteja funcionando corretamente
  • O Line requer HTTPS para URLs de webhook
  • Tente reiniciar o Ngrok e atualizar o webhook
Problema: Falhas de autenticação na API do LineSolução:
  • Verifique se o ID do Canal, Segredo do Canal e Token do Canal estão corretos
  • Verifique se o canal está publicado e não no modo de desenvolvimento
  • Certifique-se de que a Messaging API esteja ativada para seu canal
  • Gere um novo Token de Canal (Channel Token) se necessário

​
Recursos da API do Line

O Line oferece vários recursos que você pode integrar:
  • Rich Messages: Cartões, carrosséis, respostas rápidas
  • Flex Messages: Layouts personalizados
  • LIFF (Line Frontend Framework): Aplicativos da web dentro do Line
  • Line Login: Autenticação de usuário

​
Próximos Passos

Após a configuração bem-sucedida:
  1. Teste o fluxo de mensagens entre o Line e o AirysChat
  2. Configure as atribuições de agentes para conversas do Line
  3. Configure respostas automatizadas se necessário
  4. Explore recursos de mensagens ricas (rich messages) para aprimorar a experiência do usuário
  5. Revise os logs do webhook para depuração

​
Obtendo Ajuda

Se você encontrar problemas:

​
Recursos Úteis

Sua integração com o Line agora está pronta para desenvolvimento e testes! 💬