====== Notificações por Telegram ======

O Ello Backup pode enviar alertas automáticos pelo Telegram quando há clientes com versão desatualizada do agente.

===== O que dispara uma notificação =====

Uma vez por dia, o sistema verifica automaticamente se algum cliente está usando uma versão antiga do agente de backup. Se encontrar algum, envia uma mensagem no Telegram listando quais clientes precisam ser atualizados e qual versão cada um está usando.

===== Configurar as notificações =====

Para ativar as notificações, é necessário ter:

  * Um **bot do Telegram** criado pelo @BotFather
  * O **token do bot** (fornecido pelo BotFather ao criar o bot)
  * O **identificador do chat** onde as mensagens serão enviadas (ID do grupo ou canal)

No servidor de backup, essas informações são configuradas pelo administrador do sistema. Consulte a equipe técnica da Ello para obter ou alterar essas credenciais.

===== O que a notificação informa =====

A mensagem enviada pelo Telegram lista:

  * A versão atual do agente que deveria estar instalada
  * Os clientes que estão com versão antiga, agrupados por versão que possuem

Exemplo de mensagem recebida:

  📌 CLIENTES DESATUALIZADOS

  ⬆️ Versão atual: v26.01.22

  Versão antiga: v25.12.10
    • EMPRESA ABC
    • EMPRESA XYZ

  Versão antiga: v25.11.05
    • EMPRESA DEF

===== O que fazer ao receber um alerta =====

  - Acesse o **Painel Web** → tela **Versões** para ver a lista completa de clientes desatualizados.
  - Entre em contato com cada cliente afetado para agendar a atualização do agente.
  - Após a atualização, o cliente deixará de aparecer na lista automaticamente.

===== Testar o envio de notificação =====

Para verificar se as notificações estão funcionando sem esperar pelo próximo ciclo diário, a equipe técnica pode executar um teste pelo servidor. Consulte o administrador do sistema para realizar esse teste.

===== Solução de problemas com notificações =====

^ Problema ^ Causa provável ^ Solução ^
| Nenhuma mensagem recebida mesmo com clientes desatualizados | Token ou identificador de chat não configurados no servidor | Solicitar ao administrador que configure as credenciais do Telegram |
| Mensagem enviada mas conteúdo com erro | Token inválido ou expirado | Verificar o token com o @BotFather no Telegram |
| Bot não envia mensagem para o grupo | Identificador do chat incorreto | Usar o @userinfobot no Telegram para obter o identificador correto do grupo |

===== Páginas relacionadas =====

  * [[ello_backup:painel_web|Usar o Painel Web]]
  * [[ello_backup:solucao_de_problemas|Solução de Problemas]]