# Notificações de Telegram - Grupo de Monitoramento de Host
## Introdução

>[!TIP] O que é monitoramento de host?
>O monitoramento de host em concentradores refere-se ao acompanhamento e avaliação do desempenho e integridade desses dispositivos.

As Notificações em Grupo de Monitoramento de Host são alertas para manter a organização informada sobre o status dos hosts monitorados. Este documento descreve o processo de configuração e uso de notificações SMS para monitoramento de hosts no sistema. 

>[!NOTA] Acesso à funcionalidade
>Caminho: Sistema > Provedor > Monitoramento de ping > Grupo de monitoramento de host > aba Notificações > seção Telegram
### Requisitos de uso
- Necessário ter uma conta cadastrada na plataforma [Telegram](https://web.telegram.org/k/);
- Utilização do recurso de **Bot de Monitoramento no Telegram (BotFather)**.
## Entrega de Valor
- Alertas em tempo real sobre o status dos hosts;
- Redução do tempo de resposta a problemas de rede;
- Melhoria na disponibilidade e qualidade do serviço.
## Estrutura da Funcionalidade

>[!CAUTION] Atenção:
>É necessário realizar a configuração de [[grupos de monitoramento de hosts|Grupos de Monitoramento de Hosts]] para ativar as notificações de monitoramento SMS para monitoramento de host.

A configuração de envio de mensagens via **Telegram** está estruturada na aba de **Notificações**. Esta aba está relacionada ao formulário de [[grupos de monitoramento de hosts|Grupos de Monitoramento de Hosts]] e permite configurar o envio de notificações de alertas sobre o desempenho do grupo de monitoramento configurado.
## Configuração da funcionalidade
### Passo 1: Configuração do BotFather no Telegram
O **BotFather** é uma conta especial do [Telegram](https://web.telegram.org/k/) que permite que os usuários criem, configurem e gerenciem alguns bots na plataforma. Tem como objetivo auxiliar desenvolvedores a criar bots na plataforma. Neste caso, este recurso será utilizado como gerenciamento de host.

>[!TIP] Dica:
>Altere as configurações do seu navegador para facilitar o entendimento do passo a passo descrito no chat do Telegram.

Para realizar a configuração do BotFather, siga os passos a seguir:
1. Acesse o [Telegram](https://web.telegram.org/k/) e na barra de pesquisa insira a busca **BotFather**;
2. Selecione o perfil apresentado e abra um chat com o BotFather;
3. No chat, envie a mensagem de comando: /newbot;
4. Após, informe um nome ao seu bot conforme solicitado pela plataforma;
5. Inclua ao nome informado para o bot, o sufixo `_bot`. Exemplo: `ixchost_bot`.
6. Após definir o nome do Bot, um **token** será gerado. **Guarde-o em um bloco de notas, será utilizado nas próximas configurações.**
7. Com o bot cadastrado, é necessário cadastrar um grupo no Telegram com o Bot. Este processo visa extrair o ID do chat, dado importante para a comunicação entre as plataformas envolvidas. Clique no ícone de lápis em azul localizado no menu lateral esquerdo do Telegram e selecione a opção **New Group/Novo grupo** para o cadastro de um grupo;
8. Na criação do grupo, adicione como membro o bot cadastrado. Para localizá-lo, insira na barra de consulta o nome do bot (exemplo: `ixchost_bot`);
9. Com o grupo criado, abra o chat de conversa e envie o comando **/start** no chat, para iniciar o uso do bot;
10. Acesse uma nova guia em seu navegador e na barra de consulta, localizada na parte superior da tela, insira a busca: [https://api.telegram.org/bot(token)/getUpdates](https://api.telegram.org/bot(token)/getUpdates), substituindo o campo (token) pelo token adquirido ao definir um nome para o Bot (passo 6);
11. Após aplicar a busca no navegador, será retornada uma página contendo os dados do bot no Telegram. Localize a linha que contém as informações de "`my_chat_member`". Ao lado, será apresentado o Chat ID, na seguinte estrutura:  `{"id":--123456789, ...}` (exemplo ilustrativo). Copie somente a numeração do código e o traço que o antecede (**-123456789**) e armazene-o. 
### Passo 2: Cadastro Telegram Bot Marketing no IXC
Após configurar o Bot no Telegram, é necessário cadastrá-lo visando a comunicação do bot com o sistema. Siga os passos a seguir:
1. Acesse o formulário **[[mensagens telegram bot|Telegram Bot Marketing]] através do caminho: Sistema > CRM > Mensagens > Telegram Bot Marketing;
2. Clique em **Novo**;
3. Preencha os campos:
	- **Token Bot:** insira o token adquirido no passo 1;
	- **Mensagem:** informe uma mensagem demonstrativa. O sistema envia uma mensagem padrão na notificação enviada ao responsável;
	- **Chat ID:** insira o Chat ID adquirido no passo 1.
4. Clique em **Salvar** para validar as modificações.
### Passo 3: Configuração no grupo de monitoramento
Para a notificação ser enviada, é necessário vinculá-la ao grupo de monitoramento para identificação das condições do host.

1. Acesse o formulário de [[grupos de monitoramento de hosts|Grupos de Monitoramento de Hosts]] através do caminho: Sistema > Provedor > Monitoramento de ping > **Grupo de monitoramento de host**;
2. Edite um grupo já cadastrado e acesse a aba **Notificações**;
3. Localize a seção Telegram;
4. Preencha os campos:
	- **Token Bot Telegram:** clique na lupa e selecione a integração cadastrada;
	- **Telegram chat ID responsável:** insira o Chat ID adquirido no passo 1.
5. Clique em **Salvar** para finalizar as configurações de notificações.
### Passo 4: Configuração do Monitoramento de Host
Com as notificações configuradas no Grupo de Monitoramento de Host, é necessário relacionar o **Grupo de Monitoramento de Host** ao cadastro do host, em [[monitoramento de hosts|Monitoramento de Hosts]]. Siga os passos abaixo:
1. Acesse o formulário de [[monitoramento de hosts|Monitoramento de Hosts]] através do caminho: Sistema > Provedor > Monitoramento de ping > Monitoramento de host;
2. Clique em **Novo** para cadastrar o host que será monitorado ou clique em **Editar** para editar configurações já existentes;
3. Preencha o campo de **Grupo de Monitoramento** com o grupo cadastrado no passo anterior. Preencha os demais campos obrigatórios;
4. Clique em **Salvar** para validar as modificações.

>[!TIP] Manual:
>Confira o manual completo de cadastro de Monitoramento de Host: [[monitoramento de hosts|Monitoramento de Host]].
### Passo 5: Cadastro da [[tarefa - monitoramento de host|Tarefa - Monitoramento de Host]]
Com o cadastro de Monitoramento de Host, é necessário realizar o cadastro da tarefa responsável por atualizar o status do host.
Para realizar a configuração da tarefa, siga os passos abaixo:
1. Acesse o formulário de **Agenda de tarefas** através do caminho: Ferramentas > Ferramentas > Agenda de tarefas;
2. Clique no botão **Novo** para cadastrar a tarefa;
3. No campo **Tarefa**, selecione a opção **Monitoramento de Host**;
4. Preencha um intervalo de minutos de execução no campo **Minuto**, conforme a seguinte estrutura: `*/10`. Desta forma, a execução ocorrerá a cada 10 minutos, atualizando periodicamente. Identifique o melhor período de execução para monitoramento interno dos dispositivos e insira no campo ao realizar o cadastro da tarefa.
5. No campo **Hora**, marque a opção **Todos** para a tarefa executar em todos os horários;
6. Na seção **Dia do mês**, marque a opção **Todos** para a tarefa executar todos os dias do mês (irá respeitar o intervalo de semana caso não deva executar todos os dias);
7. Na seção **Mês**, marque a opção **Todos** para a tarefa executar todos os meses;
8. Na seção **Dia da semana**, marque a opção **Todos**, para o sistema executar a tarefa todos os dias da semana, 
9. Após preencher os campos, clique em **Salvar** para validar a criação da tarefa.
Após a configuração da tarefa, ela seguirá executando automaticamente e irá identificar os concentradores configurados e atualizar seus respectivos status.
## Fluxo de Trabalho
```mermaid
sequenceDiagram
    participant Sistema
    participant Telegram Bot
    participant Administrador
    Sistema->>Sistema: Detecta servidor inativo
    Sistema->>Telegram Bot: Envia requisição de Notificação push
    Telegram Bot ->>Administrador: Entrega notificação push de alerta
    Administrador->>Sistema: Verifica e resolve o problema
```
## Considerações Finais
As notificações via Telegram oferecem uma camada adicional de segurança ao monitoramento de hosts, permitindo respostas rápidas a incidentes. Ao implementar esse sistema, a empresa melhora significativamente sua capacidade de manter a infraestrutura estável e responder prontamente a problemas críticos.
## Etiquetas
#Monitoramento #SMS #Alertas #InfraestruturaDeRede
## Leia Também
- [[menu configuracoes/usuarios/usuarios/formulario usuarios|public/Menu Configurações/Usuários/Usuários/Formulário Usuários]]
- [[monitoramento de hosts|Monitoramento de Hosts]]
- [[grupos de monitoramento de hosts|Grupos de Monitoramento de Hosts]]
- [[mensagens telegram bot|Mensagens Telegram bot]]
- [[tarefa - monitoramento de host|Tarefa - Monitoramento de Host]]