Compartilhe:

Normalmente os administradores de sistemas possuem a comodidade de receber em seu smartphone alertas via SMS ou e-mail sobre o ambiente monitorado. Atualmente com a proliferação dos apps de bate-papo como Telegram e WhatsApp, bem como mídias sociais em geral, começaram a surgir outras utilidades para estes apps.

Então o que acha de receber notificações de seu servidor em um dos apps de bate-papo mais popular da atualidade?

O Telegram além de ser multi-plataforma possui um recurso ainda não encontrado nos concorrentes: o uso de bots. Bots são interessantes, pois podem ser associados a conta de uma pessoa real, e enviar/receber mensagens de/para uma conta individual ou um grupo.

Neste post explicarei de forma fácil como configurar um servidor para enviar notificações para o Telegram utilizando o script Telegram-Notify. Com ele você poderá enviar textos, fotos, documentos, logs, etc.

OBS: Para todos os procedimentos aqui mostrados, utilize as informações de acordo com o seu ambiente, como o nome do bot, canal, etc.

1 – Pré-Requisitos

1.1 – Criar um bot no Telegram

  • Primeiramente procure pelo contato botfather e inicie uma conversa com ele;
  • Nas opções que aparecerem, escolha a /newbot;
    Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

    Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

  • Em seguida será solicitado que você informe um nome para o bot. Em nosso exemplo digitei OAnalistaBot,
    Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

    Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

  • Após escolher o nome, será necessário que você informe um nome de usuário que termine com a palavra bot. Vamos utilizar o mesmo do passo anterior, mas tudo em minúsculo (oanalistabot):
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

  • Por último o Telegram mostrará um token que será utilizado para acessar a API http (353417269:AAE83uouL6joVytjTCz_4_w3QS3xV4VTOJQ):
    Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

    Telegram-Notify: Envie notificações de seu servidor para o Telegram / Pré-requisitos

  • Este token será utilizado nos passos seguintes.

1.2 – Obter o ID de seu usuário

Para que você saiba qual o ID de seu usuário no Telegram, você precisará:

  • Enviar uma mensagem para o bot que criou anteriormente. Procure nos contatos pelo username referente ao bot criado e envie qualquer texto;
  • Abrir a seguinte url em qualquer navegador web:
  • E terá a seguinte resposta:
  • Veja no exemplo acima que o seu ID é o 49622666. Este é o ID para qual o Telegram enviará as notificações. 

1.3 – Obtendo o ID de um canal

Se várias pessoas são responsáveis por um servidor, então as notificações deverão ser enviadas para um canal.

Este canal deverá ser criado com o objetivo de reunir as pessoas que receberão as notificações.

  • Acesse a opção Novo Canal:
Telegram-Notify: Envie notificações de seu servidor para o Telegram

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Escolha um nome para o canal e toque na parte em destaque:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Neste primeiro momento, mantenha o canal como Público e escolha um endereço para o link conforme solicitado. O restante do endereço será uma identificação do canal, como se fosse um usuário:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Acesse o grupo recém-criado e toque sobre o nome conforme mostrado na imagem abaixo:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Em seguida no ícone de engrenagem:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Toque na opção Administradores, pois adicionaremos o nosso bot como administrador do canal:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Na janela seguinte toque em Adicionar Administrador:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Procure pelo bot. Após o nome do bot aparecer, toque sobre ele:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • Em seguida aparecerá a janela abaixo. Vamos permitir que o bot possa somente postar mensagens no canal.
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

  • O bot já está pronto para enviar mensagens ao nosso canal, mas ainda não temos o ID do canal. Digite o comando abaixo em qualquer navegador (repare que 353417269:AAE83uouL6joVytjTCz_4_w3QS3xV4VTOJQ é o token para acessar a API HTTP, referente ao bot criado anteriormente). Não esqueça de informar o nome do canal:

  • Aparecerá a seguinte informação no navegador:

Repare no resultado acima que o ID do canal é -1001138671050, seguido da palavra “id”.

  • Mensagem recebida no canal:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Obtendo o ID do canal

1.4 – Converter o canal para privado

É necessário converter o seu canal para privado, a fim de que ele seja acessível somente pelas pessoas autorizadas, ou seja, as que devem receber os alertas referente ao servidor que envia as notificações:

  • Acesse o canal e toque sob o nome dele;
  • Em seguida no ícone de uma engrenagem;
  • Em seguida em Info do canal;
  • Marque a opção Canal Privado;
  • Confirme a alteração efetuada.

Após convertido o canal para privado, o bot poderá enviar as notificações para o ID do canal e não mais para o nome.

1.5 – Enviando uma mensagem de teste para o ID do canal

  • De posse do token para acessar a API e o id do canal, digite a sequência abaixo na barra de endereços de seu navegador:

  • Terá um retorno parecido com este:

  • Mensagem recebida no canal:

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Convertendo o canal para privado

2 – Utilizando o script ‘Telegram-Notify’

Agora é hora de instalar e configurar o script de notificação em seu servidor.

2.1 – Funcionalidades

  • Mostrar uma mensagem em texto plano ou o conteúdo de um arquivo (log, etc);
  • Mostrar um título;
  • Mostrar um emoji como um ícone principal (os códigos podem ser encontrados nesta tabela de emoji);
  • Adicionar uma foto ou um documento;
  • Selecionar estilo de formatação como Markdown (default) ou HTML;
  • Desativar mensagens de notificação no lado do cliente;
  • Selecionar bot para enviar mensagem (através da chave/token de API);
  • Selecionar o ID que receberá a mensagem.
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Funcionalidades

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Funcionalidades

2.2 – Instalação

A instalação pode ser realizada de forma simples, bastando executar a seguinte sequência de comandos:

  • No terminal do Linux, acesse o diretório de seu usuário com o comando cd ~;
  • Download do instalador com o comando:

  • Execute a instalação:

2.3 – Configuração

Iremos configurar o arquivo /etc/telegram-notify.conf com o comando:

Dentre dele, altere os parâmetros:

Você pode escolher se quer que seu usuário ou canal receba diretamente as notificações.

Após alterar, pressione :wq! para salvar e sair.

À título de informação, o script principal está localizado em /usr/local/sbin/telegram-notify.

2.4 – Enviando notificações

Utilize os exemplos abaixo e acompanhe as mensagens recebidas no canal ou no contato do bot criado anteriormente.

  • Recebido no canal:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Enviando notificações

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Enviando notificações

  • Recebido diretamente pelo bot:
Telegram-Notify: Envie notificações de seu servidor para o Telegram / Enviando notificações

Telegram-Notify: Envie notificações de seu servidor para o Telegram / Enviando notificações

Outros exemplos:

sudo telegram-notify –error –title “Error” –text “Error message with a title”
sudo telegram-notify –question –title “File content display” –text “/tmp/log.txt”
sudo telegram-notify –icon 1F355 –text “Message with custom icon 1F355 and embedded image” –photo “/tmp/icon.png”
sudo telegram-notify –text “Result is available in the embedded document” –document “/tmp/result.log”

3 – Conclusão

Vimos acima os passos necessários para utilizar o script Telegram-Notify. O uso pode ir mais adiante. Você pode configurar na cron de seu Linux um horário para que o Telegram-Notify envie uma notificação contendo determinado arquivo de log ou texto, por exemplo. Use sua imaginação. Use os comentários para enviar as suas dúvidas, elogios, etc.

Referências

http://bernaerts.dyndns.org/linux/75-debian/351-debian-send-telegram-notification

https://core.telegram.org/bots

Compartilhe: