Webhooks y eventos de email
Cada email pasa por una serie de eventos. Consúltalos cuando quieras o recibe un POST firmado en tu servidor en cuanto ocurren.
Revisado el
curl -X POST https://api.vemudo.com/v1/webhooks \
-H "Authorization: Bearer $VEMUDO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://api.tienda.es/webhooks/vemudo",
"eventTypes": ["email.delivered", "email.bounced"],
"description": "Producción"
}'Eventos disponibles
email.sent , email.delivered , email.deferred , email.bounced , email.complained , email.suppressed , email.rejected , email.failed y email.cancelled . Los de rebote incluyen su tipo (permanente, transitorio o indeterminado) y los de queja, el tipo de queja. Las aperturas y clics de campañas no generan webhooks: se ven en el informe de la campaña .
GET /v1/emails/{id}/events , con una clave de lectura. Nunca incluye cuerpos de email.
Seguridad y reintentos
La URL debe ser HTTPS y resolver a una dirección IP pública. Cada petición lleva Vemudo-Signature(t=yv1=), calculada con HMAC-SHA256 sobre el cuerpo tal como llega; rechaza las de hace más de 5 minutos.Responde con un 2xx en menos de 10 segundos. Los fallos se reintentan con esperas crecientes durante 72 horas. Si un endpoint falla durante 72 horas con al menos 10 fallos, se desactiva y se avisa a propietarios y administradores. Una entrega puede llegar más de una vez y sin orden garantizado: deduplica por Vemudo-Event-Id.Puedes rotar el secreto; durante 24 horas se firma con el nuevo y el anterior.
Preguntas frecuentes
¿Cómo compruebo que un webhook viene de Vemudo?
Calcula HMAC-SHA256 con tu secreto sobre la marca de tiempo, un punto y el cuerpo crudo, y compáralo con la cabecera Vemudo-Signature. La documentación incluye un ejemplo en Node.
¿Qué pasa si mi servidor está caído?
Vemudo reintenta con esperas crecientes durante 72 horas. Si el endpoint sigue fallando, se desactiva y se avisa por email; puedes reactivarlo desde el panel.
¿Se envían webhooks de aperturas y clics?
No. Las aperturas y los clics de las campañas se consultan en el informe de cada campaña.
Prueba Vemudo en la beta
Pide acceso, conecta tu dominio y envía. Revisamos cada cuenta antes de activarla.