Notificações

A seção Notificações, dentro do submenu de Configurações, concentra todos os canais de saída pelos quais o PrimeForge avisa você sobre o que acontece na sua frota: servidores que ficaram offline, deploys que falharam, disco cheio, certificados expirando, Modo de Pânico ativado e muito mais. Você pode entregar esses eventos a sistemas externos via webhooks assinados e/ou recebê-los diretamente por Email, Telegram e Discord. É também por esses canais que chegam os alertas das suas regras de alerta — a seção guarda as duas coisas, e Alertas é a última entrada dela.

Você chega aqui pelo menu do avatar → Configurações, seção Notificações (Email, Webhooks, Telegram, Discord e Alertas). Links antigos para /admin/notifications/… continuam funcionando e redirecionam para cá. Nada aqui se confunde com o Meu sino (menu do avatar → Conta), que é a sua preferência pessoal: quais eventos desta organização aparecem no sino do painel, e quais servidores ficam silenciados para você — sem afetar os outros membros.

Esta página cobre os endpoints de webhook e a configuração de cada canal de notificação.

#Webhooks

Um webhook endpoint é uma URL sua que recebe, por POST, um payload JSON sempre que um evento assinado por você acontece. É a forma mais flexível de integrar o PrimeForge a outros sistemas — Slack, Discord, PagerDuty, um serviço interno de plantão, o que você precisar.

#Criando um endpoint

1. Acesse Configurações → Notificações → Webhooks e clique em Criar endpoint de webhook.
2. Preencha:
   • Nome — um identificador amigável (ex.: "Slack #ops").
   • URL — o endpoint HTTPS que receberá os POSTs.
   • Segredo de assinatura (opcional) — quando definido, cada entrega é assinada com HMAC e leva o cabeçalho X-PrimeForge-Signature: sha256=<hex>, para que o seu receptor confirme que a requisição veio mesmo do PrimeForge.
   • Ativo — liga ou desliga o endpoint sem precisar apagá-lo.
   • Eventos (seção Assinaturas) — escolha eventos específicos ou deixe vazio para receber todos.

Você pode criar quantos endpoints precisar, cada um com o seu próprio conjunto de eventos e o seu próprio segredo. Isso permite, por exemplo, mandar apenas alertas críticos para o PagerDuty e o feed completo para um canal do Slack.

Depois de salvo, use Testar entrega para mandar um evento de teste e ver na hora o código HTTP e o tempo de resposta do receptor. A página do endpoint também mostra as Entregas recentes — cada tentativa, com o evento, se foi entregue, o código HTTP, a duração e o erro, quando houver.

#Eventos disponíveis

Alguns dos eventos que você pode assinar:

#Formato do payload

Os webhooks são enviados como requisições POST com corpo JSON:

{
  "event": "server.offline",
  "server": {
    "id": "01JRVW...",
    "name": "Servidor Principal",
    "ip": "203.0.113.10"
  },
  "message": "O servidor 'Servidor Principal' está offline há 10 minutos",
  "timestamp": "2026-07-13T14:30:00Z"
}

Toda entrega é assinada com HMAC-SHA256 quando o endpoint tem um segredo configurado. Para os exemplos de verificação da assinatura em Node.js, PHP e Go, consulte a página de Segurança.

Integração rápida. Para o Slack, crie um incoming webhook no Slack e cole a URL aqui. Para o Discord, use a URL de webhook do Discord com /slack no final para formatação compatível. Para qualquer outro sistema, basta um endpoint HTTP que aceite POST com corpo JSON.

#Canais de notificação

Além dos webhooks para sistemas externos, o PrimeForge oferece canais prontos para receber os eventos e alertas da frota diretamente em ferramentas de comunicação, sem que você precise escrever um receptor. Cada canal tem a sua própria página em Configurações → Notificações, e cada um escolhe a quais eventos responde.

#Email

O canal Email entrega notificações da frota para os endereços que você configurar. Na página do canal, você liga o canal (Ativo), informa os Destinatários (pressione Enter depois de cada endereço), opcionalmente um Nome do remetente, e marca quais Eventos ele assina (vazio = todos) — e pode clicar em Enviar teste para conferir antes de depender dele. É o canal mais simples de ativar e não exige nenhuma integração externa — ideal para garantir que a equipe seja avisada de incidentes mesmo sem uma ferramenta de chat conectada.

#Telegram

O canal Telegram envia as notificações para um chat ou grupo do Telegram por meio de um bot. Na página do canal, você liga o Telegram, informa o Token do bot (criado com o @BotFather) e o ID do chat, grupo ou canal de destino, e escolhe os eventos assinados. Depois de configurado, os eventos da frota chegam como mensagens no Telegram, o que é prático para receber alertas no celular em tempo real.

#Discord

O canal Discord entrega as notificações a um canal do Discord através de um webhook do servidor. Na página do canal, você liga o Discord, cola a URL do webhook do canal desejado (criada nas integrações do canal, no Discord) e escolhe os eventos assinados. É uma boa opção para equipes que já centralizam a comunicação no Discord e querem um canal dedicado a eventos de infraestrutura.

Cada canal pode ser ligado ou desligado de forma independente, tem o seu próprio Enviar teste, e você pode usar mais de um ao mesmo tempo — por exemplo, email para registro formal e Telegram para avisos imediatos no celular.

#Próximos passos

• Alertas e Monitoramento — crie regras de alerta por métrica, cuja entrega acontece por estes canais.
• Logs e Auditoria — o feed de incidentes e a trilha de auditoria da organização.
• Segurança — como verificar a assinatura HMAC das entregas de webhook.