Alertas no Telegram

Receba alertas instantâneos do TheAlert diretamente no Telegram — em um grupo, canal ou conversa privada com um bot.

Visão geral

A integração com Telegram requer dois passos:

1. Criar um bot via @BotFather e obter o token
2. Obter o Chat ID do destino (grupo, canal ou conversa privada)

Passo 1: Criar o bot via @BotFather

1. Abra o Telegram e pesquise por @BotFather
2. Inicie uma conversa e envie o comando /newbot
3. BotFather vai perguntar o nome do bot (ex: TheAlert Notificações)
4. Em seguida, vai perguntar o username do bot (deve terminar em bot, ex: minhaempresa_thealert_bot)
5. Ao finalizar, o BotFather retorna o token do bot no formato:

1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghi

Passo 2: Obter o Chat ID

O Chat ID identifica para onde as mensagens serão enviadas. O processo varia conforme o destino.

Opção A: Conversa privada com o bot

1. Pesquise seu bot pelo username no Telegram
2. Inicie uma conversa e envie qualquer mensagem (ex: /start)
3. Acesse no browser:

   https://api.telegram.org/bot<SEU-TOKEN>/getUpdates
4. Procure o campo "chat": {"id": NÚMERO} — esse é seu Chat ID

Opção B: Grupo do Telegram

1. Adicione o bot ao grupo (pesquise pelo username e adicione como membro)
2. Envie uma mensagem no grupo
3. Acesse https://api.telegram.org/bot<SEU-TOKEN>/getUpdates
4. O Chat ID do grupo começa com - (negativo), ex: -1001234567890

Opção C: Usar @userinfobot

1. Adicione o bot @userinfobot ao grupo ou inicie conversa
2. Envie /start ou qualquer mensagem
3. O @userinfobot responde com as informações, incluindo o Chat ID

Passo 3: Configurar no TheAlert

1. Acesse "Integrações" no TheAlert
2. Clique em "+ Nova Integração" → Telegram
3. Preencha:
   • Nome: identificação (ex: Telegram — Equipe Infra)
   • Bot Token: token obtido do BotFather
   • Chat ID: ID do destino (grupo ou conversa)
4. Clique em "Salvar"
5. Clique em "Testar" para enviar uma mensagem de teste

O que aparece no Telegram

Alerta de queda:

🔴 *Monitor DOWN*

*Monitor:* API de Pagamentos
*URL:* https://api.pagamentos.com.br
*Erro:* connect ETIMEDOUT
*Horário:* 15:32:10 BRT

Alerta de recuperação:

🟢 *Monitor RECOVERED*

*Monitor:* API de Pagamentos
*Duração:* 8 minutos
*Horário:* 15:40:22 BRT

Usando canais Telegram (broadcast)

Se preferir usar um canal Telegram (não um grupo):

1. Crie o canal no Telegram
2. Adicione o bot como administrador do canal
3. O Chat ID do canal começa com -100 (ex: -1009876543210)
4. Use esse Chat ID na configuração do TheAlert

Planos

Solução de problemas

Mensagem de teste não chegou

• Confirme que o token do bot está correto (sem espaços)
• Certifique-se de que o bot foi adicionado ao grupo/canal
• Para grupos, verifique se o bot não foi removido ou bloqueado
• Execute getUpdates novamente para confirmar que o bot está recebendo mensagens

"Bad Request: chat not found"

• O Chat ID está incorreto. Repita o processo de obtenção do Chat ID.
• Para grupos, certifique-se de usar o ID negativo completo, incluindo o -.

Bot não responde

• Bots novos precisam receber pelo menos uma mensagem antes de getUpdates funcionar. Envie /start para o bot.

Próximos passos

• Configurar Slack →
• Configurar Webhooks →
• Visão geral de alertas →