Ir para o conteúdo
Promovaweb

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
  1. O vínculo entre o monitor e o destino
  2. Da mudança de estado ao envio
  3. Telegram, Discord e email
  4. O webhook ligado ao n8n
  5. Quando o caminho do alerta falha

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.

  1. Verificação

    O teste produz um estado e uma mensagem.

  2. Mudança

    O Uptime Kuma identifica um evento que deve gerar aviso.

  3. Integração

    O provedor usa o destino e as credenciais configurados.

  4. Mensagem

    O serviço externo aceita o envio para o canal escolhido.

O destino recebe o aviso depois da avaliação do monitor, usando a integração associada a ele.

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.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.