Pular para o conteúdo principal

​
Configurar a integração com aplicativo Telegram na sua máquina local

Siga as etapas abaixo se você estiver tentando trabalhar com a integração do Telegram em sua máquina local.

​
Pré-requisitos

  • Token do Bot do Telegram do BotFather
  • Ngrok ou serviço de tunelamento similar
  • Ambiente de desenvolvimento do AirysChat em execução

​
Passos da Configuração

​
1. Iniciar Servidor Ngrok

Inicie um servidor Ngrok ouvindo na porta 3000 ou na porta que você executará a instalação do AirysChat: 
# Instale o ngrok se você ainda não tiver instalado
# Faça o download em https://ngrok.com/download

# Inicie o túnel ngrok
ngrok http 3000

​
2. Atualizar Variáveis de Ambiente

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

​
3. Iniciar Servidor AirysChat

Inicie o servidor do AirysChat e crie um novo canal do Telegram com o token obtido do BotFather do Telegram. 
# Iniciar o servidor de desenvolvimento
make run
# ou
foreman start -f Procfile.dev

​
4. Criar Canal no Telegram

  1. Acessar o AirysChat: Acesse sua instância do AirysChat (http://localhost:3000)
  2. Navegar até Settings (Configurações) → Inboxes (Caixas de Entrada) → Add Inbox (Adicionar Caixa de Entrada)
  3. Selecione Telegram como o tipo de canal
  4. Inserir o Token do Bot: Cole o token que você recebeu do BotFather
  5. Configurar o Canal: Configure o nome do canal e outras definições

​
Verificar o Registro do Webhook

Ao criar o canal, o AirysChat deve ter registrado uma URL de callback do webhook no Telegram para o seu Bot. Você pode verificar se esse registro de URL foi feito com sucesso chamando a API do Telegram: 
GET https://api.telegram.org/bot{your_bot_token}/getWebhookInfo

​
Testando a Integração

Se o webhook estiver registrado corretamente no Telegram, o seu servidor Ngrok deverá receber eventos de novas mensagens do Telegram e novas conversas serão criadas no AirysChat.

​
Passos para Teste

  1. Envie uma mensagem para o seu bot do Telegram
  2. Verifique os logs do Ngrok para ver se a requisição do webhook foi recebida
  3. Verifique o AirysChat para ver se uma nova conversa foi criada
  4. Responda a partir do AirysChat para testar a comunicação bidirecional

​
Resolução de Problemas

Problema: O registro do webhook no Telegram falhaSolução:
  • Certifique-se de que a sua URL do Ngrok esteja acessível publicamente
  • Verifique se FRONTEND_URL está configurado corretamente no seu arquivo .env
  • Verifique se o token do bot está correto
  • Reinicie o AirysChat após atualizar as variáveis de ambiente
Problema: As mensagens do Telegram não criam conversas no AirysChatSolução:
  • Verifique os logs do Ngrok em busca de requisições de webhook de entrada
  • Verifique a URL do webhook no Telegram usando a chamada de API acima
  • Verifique os logs do AirysChat em busca de mensagens de erro
  • Certifique-se de que o canal esteja devidamente configurado e ativado
Problema: Problemas de certificado SSL com o webhookSolução:
  • Use a versão https da sua URL do Ngrok
  • Certifique-se de que o Ngrok esteja funcionando corretamente
  • Tente reiniciar o Ngrok e atualizar o webhook

​
Próximos Passos

Após a configuração bem-sucedida:
  1. Teste o fluxo de mensagens entre o Telegram e o AirysChat
  2. Configure a atribuição de agentes para as conversas do Telegram
  3. Configure as respostas automáticas se necessário
  4. Revise os logs do webhook para depuração

​
Obtendo Ajuda

Se você encontrar problemas:
Sua integração com o Telegram agora está pronta para desenvolvimento e testes! 📱