Canais de Alerta

O Cronitorex pode notificar você sobre eventos de monitores (falhas, execuções perdidas, timeouts, recuperações) por meio de vários canais. Você pode configurar qualquer quantidade de canais e escolher quais tipos de evento cada canal recebe.

Todos os canais são gerenciados no painel em Configurações -> Canais de Notificação. Cada canal tem um botão Testar que envia uma notificação de teste apenas para aquele canal, para que você possa validar a configuração antes de depender dela.

Canal	Disponibilidade
Email	todos os planos
Telegram	todos os planos
Discord	todos os planos
Webhook	plano com alertas via webhook
Slack	plano com alertas via Slack

Email

O canal mais simples. Deixe o campo de endereço vazio para usar o email da sua conta, ou informe um endereço diferente (por exemplo, um alias de equipe).

Telegram

Os alertas do Telegram são entregues pelo seu próprio bot, então são gratuitos e instantâneos.

1. Abra @BotFather no Telegram e envie /newbot. Siga as instruções e copie o token do bot (formato 123456789:AAF...).
2. Adicione o bot ao chat ou grupo onde você quer receber alertas, ou abra uma conversa direta com ele, e envie qualquer mensagem (por exemplo /start).
3. Obtenha o chat ID: abra https://api.telegram.org/bot<TOKEN>/getUpdates em um navegador e leia chat.id na resposta. IDs de grupo são números negativos (por exemplo -1001234567890).
4. No painel, adicione um canal do tipo Telegram e cole o token do bot e o chat ID.
5. Clique em Testar para confirmar que a mensagem chega.

Nota: o token do bot concede controle sobre o seu bot. O Cronitorex o armazena apenas para entrega e nunca o inclui em logs.

Discord

Os alertas do Discord usam webhooks de canal, sem necessidade de bot.

1. No Discord, abra as configurações do canal desejado: Integrações -> Webhooks -> Novo Webhook.
2. Copie a URL do webhook (ela começa com https://discord.com/api/webhooks/).
3. No painel, adicione um canal do tipo Discord e cole a URL.
4. Clique em Testar. Os alertas chegam como embeds, verde para recuperações e vermelho para falhas.

Slack

1. Crie um webhook de entrada no seu workspace do Slack.
2. No painel, adicione um canal do tipo Slack e cole a URL do webhook (começa com https://hooks.slack.com/services/).
3. Clique em Testar.

Webhook

Envia um payload JSON para qualquer endpoint HTTP, útil para integrar com seus próprios sistemas, ferramentas de plantão ou automações.

{
  "id": 123,
  "type": "failed",
  "monitor_name": "db-backup",
  "message": "Monitor db-backup failed",
  "metadata": {},
  "occurred_at": "2026-07-24T18:00:00+00:00"
}

• Método: POST (padrão) ou GET (payload como parâmetros de query).
• Headers customizados: um por linha no formato Header-Name: value, por exemplo um header Authorization para o seu endpoint.
• URLs de webhook do Slack e do Discord são rejeitadas aqui de propósito: as APIs deles esperam um formato de payload diferente. Use o tipo de canal dedicado Slack ou Discord no lugar.

Tipos de evento

Cada canal se inscreve em um subconjunto de tipos de evento:

Evento	Significado
Failed	o job reportou uma falha
Missed	uma execução esperada não chegou a tempo
Timeout	o job iniciou mas não terminou a tempo
Degraded	a checagem está falhando intermitentemente
Recovered	o monitor está saudável novamente
Still failing	lembrete periódico enquanto uma falha continua ocorrendo