Este artigo descreve como criar um bot do Telegram e receber nele as notificações das verificações de monitoramento dos hosts. Assim os alertas chegam ao smartphone e a outros dispositivos pela Internet.
1. Criar um chatbot e obter um token no Telegram
Primeiro, crie um chatbot no Telegram e obtenha o token:
- Abra o Telegram e procure o bot BotFather (@BotFather).
- Inicie a conversa com o BotFather pelo botão Start
- Envie o comando /newbot para criar um bot novo (ou escolha na lista).
- O BotFather pede o nome do bot (por exemplo, MyTestBot). Esse nome aparece nos contatos
- Em seguida, informe o nome de usuário do bot. Ele precisa terminar com bot (por exemplo, MyTestBot_bot).
Depois de criar o bot, o BotFather fornece o token (por exemplo, 123456789:ABCdefGhIJKlmNoPQRstuVWXyz).
2. Obter o chat ID
Para receber notificações no Telegram, você também precisa do chat ID. Veja como obtê-lo:
- Envie uma mensagem ao seu bot.
- Em seguida, abra este link: https://api.telegram.org/bot<YourBotToken>/getUpdates no navegador
Onde <YourBotToken> é o token do bot.
Se tudo estiver certo, a página do navegador mostra um objeto JSON. Para ler melhor, marque Pretty-print no navegador.
Copie o parâmetro "id" do objeto "chat".
3. Configurar as notificações no programa
Em seguida, copie os dados recebidos para o programa.
Clique em Program settings, selecione Messengers. Cole os dados nos campos correspondentes.
Na lista de verificações, ache a verificação cujos resultados você quer receber no Telegram. Clique com o botão direito e selecione Edit check no menu de contexto.
Clique em Next várias vezes até o passo 3. Marque Perform on passed check , Perform on failed check, ou os dois.
Indique o Telegram como método de notificação, como na imagem abaixo.
Se todos os avisos forem para um único chatbot, o campo Chat ID pode ficar em branco, porque esse identificador já está nas configurações gerais. Na verificação individual, o campo serve para enviar avisos a chatbots diferentes. Se houver vários bots, informe o ID do bot criado para os alertas desta verificação.
Nesta etapa, teste a notificação na hora. Com o botão Test, uma mensagem de teste deve chegar ao chatbot.
Pronto.
As notificações das verificações passam a chegar como mensagens no chatbot do Telegram que você criou.