O que é
Bot API. O bot já precisa estar no chat, e o chat id vai na rota ou no endereço do contato — não aqui.
Configurar
Cerca de 5 minutos até um canal funcionando.
- 01Crie o bot com o @BotFather. Abra o Telegram, fale com o @BotFather, mande /newbot, escolha um nome de exibição e um username terminado em “bot”. Ele responde com um token no formato 123456789:AAE… .
- 02Cole o token e clique em Testar. O Testar chama o getMe: prova que o token é válido. Ele não envia mensagem, porque o chat de destino fica na rota.
- 03Coloque o bot onde o relatório deve chegar. Conversa direta: mande qualquer mensagem para ele. Grupo: adicione como membro e mande uma mensagem. Canal: adicione como administrador.
- 04Descubra o chat_id. Use o botão Chat ids neste canal: ele lista todo chat que já falou com o bot, com o id para copiar. (O mesmo dado está em https://api.telegram.org/bot<TOKEN>/getUpdates, mas isso coloca o token do bot numa URL do navegador.) Grupo vem negativo — copie o sinal de menos junto.
- 05Coloque o chat_id na rota. Relatório → Destinos → Canal, e cole o chat_id em Destino. Destino vazio falha com “Telegram route Target is empty (need chat_id)”.
Campos
| Campo | Obrigatório | O que é |
|---|---|---|
| Bot token | Sim | O que o @BotFather respondeu ao /newbot. O chat id não vai aqui — vai na rota. (123456789:AAE…) |
O que vai em Target
O chat_id numérico. Pessoa: número positivo, e ela precisa ter mandado mensagem para o bot antes — um bot não abre conversa. Grupo ou supergrupo: negativo, normalmente começando com -100, e o bot precisa ser membro. Canal ou supergrupo PÚBLICO é o único caso em que @nome funciona; o @nome de uma pessoa nunca funciona.
Target é obrigatório neste canal: uma rota sem Target não sai. — chat_id, ex.: -1001234567890
Testar
Cada canal tem o botão Testar na lista de canais (Configurações → Canais). O resultado fica guardado — data, status e o erro do provedor quando houve — e um canal nunca testado aparece marcado na lista.
Testar chama getMe com o token: prova que o bot existe. Não prova o chat id — se o bot não estiver no grupo, ou ninguém tiver falado com ele, a primeira entrega real falha com "chat not found".
Conferir de ponta a ponta
- 01Relatório: abra um relatório, adicione este canal em Destinos (com o Target, se o canal pede), clique em Executar agora e abra a execução. O log diz por qual canal cada destinatário foi e o que o provedor respondeu.
- 02Alerta: em Monitoramento → Rotas de alerta, crie uma rota com este canal como passo de escalação. A rota casa por severidade e origem; a primeira que casar vence.
- 03Para disparar um alerta sem derrubar nada: crie um monitor HTTP apontando para uma URL que responde erro (por exemplo https://httpstat.us/500) com intervalo curto. Quando ele cair, o alerta sai pela rota; apague o monitor depois. A mensagem traz um link de reconhecimento — clique nele e a escalação para.
- 04Regras de relatório (linhas novas, valor fora da faixa) chegam pela mesma rota, com origem "regra de relatório".
O que mais costuma dar errado
O @nome de uma pessoa não é endereçável por um bot — “@fulano” sempre volta como “chat not found”. Use o id numérico. E o bot não enxerga mensagens anteriores à entrada dele: mande uma depois, senão não há chat id para ler.