Como o Uptime Kuma envia as notificações
O Uptime Kuma envia notificações sobre os monitores aos destinos configurados por você. As integrações levam os avisos de falha e recuperação ao Telegram, ao Discord, ao email ou a um webhook.
Ficha e sumário da página
- Referência técnica
- Uptime Kuma 2.5.11
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O vínculo entre o monitor e o destino
O Uptime Kuma guarda as configurações de notificação separadamente dos monitores. Uma configuração identifica o serviço de mensagem e os campos necessários para alcançá-lo. Você associa essa configuração aos monitores que devem usar o destino, por isso o mesmo canal pode receber avisos de vários apps.
Essa associação também permite separar mensagens por serviço. O monitor do atendimento pode usar um canal acompanhado durante o expediente, enquanto uma verificação de laboratório fica em outro destino. A distinção está no vínculo entre monitor e notificação, não no endereço testado. Cadastrar um destino sem associá-lo ao monitor deixa esse monitor sem aquele canal de aviso.
O painel oferece um envio de teste para conferir a integração. Esse envio verifica o caminho até o destino e as credenciais informadas. Ele não reproduz necessariamente o conteúdo de uma queda real, porque um teste pode chegar sem um monitor ou heartbeat associado. Você interpreta o resultado como confirmação do transporte da mensagem.
Da mudança de estado ao envio
O processamento do monitor distingue verificações consecutivas do mesmo estado de mudanças relevantes para notificação. Uma sequência de respostas normais não precisa produzir uma mensagem a cada execução. A passagem para indisponível e a recuperação são eventos que podem gerar avisos, conforme a configuração e as condições do monitor.
As tentativas adicionais participam desse caminho. Uma falha inicial pode manter o estado pendente antes de confirmar a indisponibilidade. O intervalo entre verificações e o número de tentativas alteram o tempo até o aviso, então o horário recebido no celular não corresponde necessariamente ao primeiro instante da falha.
O reenvio permite repetir o aviso enquanto a indisponibilidade continua. Na implementação da versão 2.5.11, esse comportamento depende da configuração de reenvio e das verificações acumuladas durante a queda. Você diferencia uma nova interrupção de um aviso repetido consultando o estado e o histórico do mesmo monitor. Na saída de uma manutenção, o retorno ao estado disponível não gera aviso de recuperação, mas uma resposta que confirme a queda pode gerar uma notificação.
Verificação
O teste produz um estado e uma mensagem.
Mudança
O Uptime Kuma identifica um evento que deve gerar aviso.
Integração
O provedor usa o destino e as credenciais configurados.
Mensagem
O serviço externo aceita o envio para o canal escolhido.
Telegram, Discord e email
O Telegram recebe mensagens por um bot configurado com token e identificação do chat. O bot precisa ter acesso ao destino para enviar o aviso. Um token válido com um chat incorreto pode falhar no envio, por isso a confirmação inclui a conversa que realmente recebe a mensagem.
A integração do Discord usa um webhook do canal. O endereço desse webhook autoriza o envio e deve permanecer restrito à configuração da notificação. Colocar a URL numa captura pública permite que terceiros enviem mensagens pelo mesmo webhook, mesmo sem acesso ao painel do Uptime Kuma.
O email usa um servidor SMTP, com conexão e autenticação conforme o provedor. O aceite pelo servidor SMTP confirma uma etapa do transporte, mas a mensagem ainda pode ser filtrada no destino. Você confere a caixa que recebe os avisos, além do resultado exibido pelo teste no painel.
Esses canais têm credenciais e permissões próprias. A renovação de um token ou a exclusão de um webhook afeta os alertas mesmo quando o monitor continua verificando normalmente. O estado do app acompanhado e o estado da integração de mensagens precisam ser observados separadamente.
O webhook ligado ao n8n
O provedor webhook envia uma requisição para a URL configurada. No formato padrão, o conteúdo inclui a mensagem e os objetos do monitor e do heartbeat quando estão disponíveis. O código também oferece opções de corpo personalizado e cabeçalhos adicionais, que permitem adaptar o envio ao serviço receptor.
Num fluxo do n8n, o Node Webhook recebe esse evento. Os Nodes seguintes podem selecionar o destino ou preparar uma mensagem para outro canal. O Uptime Kuma continua responsável pela verificação, enquanto o n8n executa o encaminhamento definido no fluxo. O envio ao WhatsApp depende da integração escolhida no n8n.
A automação precisa considerar que o teste da notificação pode chegar sem os mesmos campos de um evento real. Um fluxo que acessa diretamente uma propriedade de heartbeat pode falhar quando o objeto não existe. Essa diferença aparece no formato aceito pelo provedor e precisa ser considerada na interpretação do evento.
Quando o caminho do alerta falha
Uma VPS sem conectividade não consegue alcançar Telegram, Discord ou o endpoint de webhook. Se o Uptime Kuma roda na mesma máquina dos apps, a queda completa dessa VPS também interrompe a execução dos monitores. O silêncio do canal não comprova disponibilidade dos serviços.
Você observa essa limitação pelo desenho da rede: o processo que verifica precisa continuar ativo e alcançar tanto o app quanto o provedor de mensagens. Uma instância em outro servidor pode acompanhar o endereço público da VPS principal. A página Onde o Uptime Kuma roda explica o alcance desse posicionamento.
As janelas de manutenção suspendem notificações dos monitores selecionados durante o período definido. Elas registram uma intervenção planejada e evitam que a parada prevista produza os mesmos avisos de uma queda inesperada. A comunicação pública desse período aparece nas páginas de status, conforme a seleção feita na manutenção.