Saltar al contenido

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

Crear un endpoint por API (clave full); el secreto de firma se muestra una vez
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

Los eventos son 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 .

También puedes pedir la línea de eventos de un email concreto con 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= y v1= ), 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.

Hasta 10 endpoints por organización. Cada endpoint es del entorno de la clave que lo crea y solo recibe eventos de ese entorno. Los eventos nacen en la API de envío y en las bajas automáticas .

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.

Pedir acceso a la beta