Receber alertas instantâneos quando um funcionário clica em um link de phishing ou insere credenciais, sem precisar entrar na plataforma.
Integrar o Whalemate com seu SIEM, plataforma de segurança, LMS ou ferramentas de comunicação interna como Slack ou Microsoft Teams.
Manter dashboards externos atualizados com os resultados das campanhas em tempo real.
Automatizar respostas a incidentes de conscientização sem intervenção manual.
Eliminar a necessidade de consultar a API periodicamente: o Whalemate envia os dados ao seu sistema quando ocorrem.
Navegação: Configuração → Integrações → cartão Webhooks → Configurar
Criar um webhook:
Clique em Novo Webhook.
Preencha o Nome do webhook e a URL do endpoint (deve começar com https://).
Em Eventos para assinar, escolha um ou mais dos cinco eventos disponíveis (Enviado, Aberto, Clique, Credenciais capturadas, Reportado), ou use Selecionar tudo.
Clique em Salvar Webhook.
O segredo HMAC é exibido uma única vez ao salvar. Copie-o e guarde-o: não pode ser recuperado depois. Seu sistema precisa dele para validar que as notificações vêm do Whalemate.
Gerenciar um webhook:
Editar: modifica nome, URL ou eventos assinados. A partir daí você também pode Rotacionar segredo (invalida o anterior imediatamente) ou Excluir o webhook.
Testar: envia um payload de teste e mostra o resultado na mesma tela — sucesso (HTTP 200 · {ms} ms), erro HTTP (HTTP {código} · {ms} ms), ou "Sem resposta" em caso de timeout ou erro de conexão.
Desativar / Ativar: pausa ou retoma as notificações.
⚠️ Se um endpoint acumular 20 falhas consecutivas, o Whalemate o desativa automaticamente (selo vermelho "Desativado" + quantidade de falhas). Ao clicar em Ativar, os envios são retomados sem verificação prévia e o contador de falhas é zerado. Recomendamos usar Testar antes de reativar para confirmar que o endpoint responde com 2xx.
Novas tentativas automáticas
Se o seu servidor não responder com um código 2xx ou exceder o tempo limite, o Whalemate tenta novamente automaticamente com o seguinte esquema:
Tentativa | Espera |
|---|---|
1 (envio original) | — |
2 | 1 minuto |
3 | 5 minutos |
4 | 30 minutos |
5 (último) | 2 horas |
Após a tentativa 5, a entrega fica com status falhou
Se o seu endpoint acumular 20 falhas consecutivas, o Whalemate o desativa automaticamente. Para reativá-lo, resolva o problema no seu servidor e entre em contato conosco.
Posso receber o mesmo evento mais de uma vez?
Sim, em casos excepcionais de rede o Whalemate pode entregar o mesmo evento duas vezes. Para evitar processá-lo duplicado, use o campo X-Whalemate-Delivery-Id como chave de idempotência no seu sistema.
O que acontece com os eventos que ocorreram enquanto meu endpoint estava desativado?
Eles não são realimentados automaticamente. Se precisar desses dados, você pode consultá-los através da API REST do Whalemate.
Por que meu endpoint foi desativado?
O Whalemate desativa automaticamente os endpoints que acumulam 20 entregas falhadas consecutivas. Ao reativá-lo com Ativar, os envios são retomados sem verificação prévia (o contador de falhas é zerado). Se o endpoint continuar fora do ar, ele voltará a acumular falhas e será desativado novamente ao chegar a 20. Recomendamos usar Testar antes de reativar para confirmar que ele responde 2xx.
Tem feedback ou quer solicitar melhorias? Nos avise em roadmap.whalemate.com/roadmap
