Canais de Alerta

O HelloCron 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.

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 gratuitos e instantâneos, e conectar leva um clique.

1. No painel, adicione um canal do tipo Telegram e clique em Conectar Telegram.
2. Escaneie o código QR com o celular (ou clique em Abrir no Telegram) e toque em Iniciar no chat aberto. Para um grupo, use Adicionar a um grupo e escolha o grupo.
3. O formulário se preenche sozinho e mostra “Conectado”. Salve o canal e clique em Test.

Os alertas são entregues pelo bot oficial do HelloCron. Sem tokens, sem chat ID, sem procurar nada.

Avançado: seu próprio bot. Se preferir que os alertas venham de um bot sob seu controle, expanda Avançado: seu próprio bot no formulário: crie um bot via @BotFather (/newbot, copie o token no formato 123456789:AAF...), obtenha o chat ID em https://api.telegram.org/bot<TOKEN>/getUpdates (IDs de grupos são negativos) e preencha os dois campos. Um canal com token próprio sempre envia por esse bot. O HelloCron guarda o token apenas para a entrega e nunca o registra 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.

PagerDuty

Os alertas do PagerDuty usam a Events API v2: falhas abrem incidentes e recuperações os resolvem automaticamente.

1. No PagerDuty, crie um serviço (ou abra um existente) e adicione uma integração Events API v2: Service -> Integrations -> Add integration -> Events API v2.
2. Copie a Integration Key (também chamada de routing key, 32 caracteres).
3. No painel, adicione um canal do tipo PagerDuty e cole a chave.
4. Clique em Test.

Como os eventos são mapeados:

• Failed, Missed e Timeout disparam um incidente com severidade critical; Degraded e Still failing usam warning.
• Recovered resolve o incidente aberto para aquele monitor por meio de uma chave de deduplicação compartilhada, então um monitor instável nunca acumula incidentes.
• Cada incidente traz um link de volta para o monitor no painel do HelloCron.

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.

Grupos de notificações

Um grupo de notificações é um conjunto nomeado de canais. Um monitor atribuído a um grupo alerta apenas os canais desse grupo; monitores sem grupo mantêm o comportamento padrão e alertam todos os canais ativos da conta.

Configuração típica: um grupo “backups” apontando para um chat dedicado do Telegram e um grupo “www” apontando para o webhook de plantão. Como uma conta pode ter vários canais do mesmo tipo, cada grupo pode mirar seu próprio chat do Telegram.

Gerencie os grupos em Configurações -> Canais de notificação -> Gerenciar grupos: crie um grupo, marque seus canais e anexe monitores (ping e checks HTTP/SSL) na mesma página. O grupo também pode ser escolhido na edição de um monitor.

Dois detalhes importantes:

• Um grupo sem canais silencia seus monitores fora do painel (o sino do aplicativo continua funcionando). O painel avisa sobre isso.
• Excluir um grupo não apaga mais nada: seus monitores voltam a todos os canais da conta.

Nos manifestos de config-as-code, o grupo viaja como notification_group (o nome do grupo). Omitir a chave desanexa o grupo; nomes desconhecidos são rejeitados com o código de erro notification_group_invalid.

Tipos de evento

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