Configurar Webhooks

Los webhooks te permiten enviar notificaciones de alertas a cualquier URL externa, como tus propios sistemas de monitorización, plataformas de automatización o integraciones a medida.

Requisitos

Los webhooks están disponibles a partir del plan Pro.

Crear un webhook

Ve a Ajustes > Alertas
Baja hasta la sección de Webhooks
Pulsa Añadir Webhook
Introduce la URL de destino y un nombre para el webhook
Guarda la configuración

Para cada webhook se genera automáticamente una clave secreta. Puedes usar este secreto para verificar la autenticidad de las peticiones que recibes.

Los webhooks reciben todos los tipos de eventos de alerta automáticamente. Al crear un webhook no se pueden seleccionar tipos de eventos concretos.

Límites

Máximo 5 webhooks por organización
Los webhooks se desactivan automáticamente tras 10 fallos de entrega consecutivos. Puedes volver a activar un webhook desactivado desde la página de ajustes después de resolver el problema.

Formato del payload

DMARC Examiner envía una petición HTTP POST con este formato JSON:

{
  "event": "dmarc_fail",
  "domain": "yourdomain.com",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "severity": "critical",
    "details": "..."
  }
}

Tipos de evento

Los cinco tipos de alerta se envían a todos los webhooks activos:

Evento	Descripción
`dmarc_fail`	Hay mensajes que fallan la autenticación DMARC
`new_sender`	Se detecta una nueva IP enviando correo en nombre de tu dominio
`volume_spike`	Incremento inusual en el volumen de correo
`dns_change`	Se han modificado los registros DNS de tu dominio
`compliance_drop`	Ha caído la tasa de cumplimiento DMARC

Seguridad

Cada petición del webhook incluye una cabecera X-DMARC-Signature con una firma HMAC-SHA256. Puedes verificar esta firma con el secreto que aparece en la configuración del webhook para asegurarte de que la petición viene de DMARC Examiner.