Con un webhook, Xendy envía automáticamente una solicitud POST a tu URL cuando ocurre algo. Puedes elegir entre tres eventos:
- Registros DNS incorrectos (
dns-records.failed)
- Registros DNS recuperados (
dns-records.recovered)
- Importación de tienda online fallida (
webshop-import.failed)
- En la pestaña Webhooks, haz clic en Añadir webhook.
- Introduce la URL (solo https) y elige los Eventos.
- Haz clic en Añadir. Copia el secreto del webhook que aparece: solo lo verás una vez.
Cada mensaje es JSON con id, event, created_at y data, y lleva las cabeceras Xendy-Event, Xendy-Delivery y Xendy-Signature. Con la firma verificas que el mensaje proviene realmente de Xendy. Xendy-Signature tiene la forma t=<momento>,v1=<firma>: la firma es un HMAC-SHA256 de <t>.<body> con tu secreto. Rechaza los mensajes cuyo t sea anterior a 5 minutos. En la documentación encontrarás un ejemplo en JavaScript.
Responde en 10 segundos con un código de estado 2xx. Si la entrega falla, Xendy lo reintenta después de 1, 5 y 30 minutos. Si cinco eventos consecutivos fallan por completo, Xendy pone el webhook en Desactivado. Cada intento queda registrado en la pestaña Actividad, bajo Webhook saliente.