Webhooks y eventos
Cada correo avisa a tu sistema.
En cada entrega, apertura, clic o devolución, Postal envía un aviso automático a la dirección que elijas. Tu CRM, tu ERP o tu sitio se mantienen actualizados sin consultar nada.
- 30 tipos de evento
- Firma según el estándar Standard Webhooks
- Hasta 8 intentos en unas 27 horas
- Reenvío desde el panel
Cómo funciona
Del aviso al reenvío
Lo que hace Postal desde el momento en que algo ocurre hasta que tu sistema lo confirma.
Cada suceso se convierte en un aviso
Eliges qué eventos quieres recibir: entregado, abierto, enlace con clic, devuelto, marcado como spam, respuesta, correo recibido en un buzón de entrada y otros. También hay eventos de dominios, supresiones, contactos, formularios, campañas y buzones de entrada, y un aviso en el momento en que se pausan los envíos del equipo. Puedes enviarlo todo a una sola dirección o separarlo por sistema.
Ver la lista completa de eventosCómo llega el aviso
Un webhook es solo eso: un mensaje automático de un sistema a otro, en el momento en que algo ocurre.
Cada aviso llega firmado
Quien lo recibe puede comprobar que el aviso vino de Postal y no de otra persona. La firma sigue el estándar Standard Webhooks, y las bibliotecas oficiales de Postal ya lo comprueban todo por ti.
Cómo verificar la firma- Firma HMAC-SHA256 en cada entrega
- Los SDK rechazan avisos con más de 5 minutos de diferencia
- Cada webhook tiene su secreto, que se puede cambiar en el panel (el anterior deja de valer al instante)
webhook-id: <el mismo en todos los intentos>
webhook-timestamp: <segundos desde 1970>
webhook-signature: v1,<firma>
{
"type": "email.delivered",
"created_at": "2026-10-24T13:02:14.120Z",
"data": {
"email_id": "019a1b2c-4d5e-7f60-8a9b-0c1d2e3f4a5b",
"from": "Aurora Cosméticos <[email protected]>",
"to": ["[email protected]"],
"subject": "Tu pedido #10482 salió para la entrega",
"tags": {}
}
}Si tu sistema se cae, Postal lo intenta de nuevo
Tu sistema responde con cualquier estado 2xx para confirmar. Si no responde o da error, Postal repite con esperas cada vez mayores, siempre con el mismo identificador, para que puedas descartar duplicados.
- En el 8.º intento sin éxito, el evento queda como fallido y se puede reenviar desde el panel
- Si las entregas fallan durante 5 días sin ningún éxito, la dirección se desactiva y los propietarios y administradores del equipo reciben un correo electrónico
Mira lo que se entregó y reenvía lo que necesites
En el panel, cada webhook tiene su historial: qué se envió, cuántos intentos hubo y qué respondió tu sistema. ¿Corregiste el problema? Reenvía el evento con un clic o envía un evento de prueba, incluso con la dirección desactivada.
Ver la referencia de la API de webhooksPrueba sin enviar de verdad
Las direcciones de prueba generan avisos reales, firmados, sin enviar correo y sin consumir la cuota. Dependen del plan.
[email protected]email.sent y email.delivered[email protected]email.bounced, rebote permanente[email protected]email.complained
Con y sin webhooks
Sin webhooks
- Tu sistema tiene que consultar cada correo para saber qué pasó
- Los rebotes y las quejas pasan desapercibidos hasta que alguien mira el panel
- Si la consulta falla, nadie se entera
Con webhooks
- Un aviso firmado llega a la dirección que elegiste, en cada evento
- Si tu sistema está fuera de servicio, Postal lo intenta de nuevo durante unas 27 horas
- Cada entrega queda en el historial durante 30 días, con reenvío desde el panel
Páginas relacionadas
Preguntas frecuentes
¿Necesito saber programar?
Para recibir los avisos, alguien tiene que configurar la dirección de tu sistema que los recibe, y esa parte es técnica. En el panel de Postal, el resto es sencillo: pegar la URL y marcar los eventos que quieres.
¿Qué pasa si mi sistema se queda fuera de servicio?
Postal intenta entregar el aviso hasta 8 veces, en total durante unas 27 horas. Después de eso el evento queda como fallido, y puedes reenviarlo desde el panel. Si las entregas fallan durante 5 días sin ningún éxito, la dirección se desactiva y los propietarios y administradores del equipo reciben un correo electrónico.
¿Puedo probar sin enviar un correo de verdad?
Sí. El panel tiene el botón Enviar evento de prueba. Para ver eventos de correo, envía un mensaje a las direcciones de prueba, como [email protected] o [email protected], si tu plan lo incluye.
¿Cuántas direcciones puedo registrar?
Depende del plan. Al pasar del límite, Postal te avisa al crear una más. Mira los planes y precios.