Nueva guía: cómo calentar una IP dedicada sin dañar tu reputación. Leer ahora →
MigoSMTP
Webhooks y eventos

Entérese en el momento en que ocurra algo

Reciba eventos firmados de cada entrega, rebote, apertura, clic y queja, y reproduzca lo que se le haya pasado.

La IA resume los flujos de eventos y señala patrones de rebote inusuales en cuanto aparecen.

Añadir endpoint
URL
https://example.com/hook
Secreto
••••••••••
Guardar
Endpoint añadido
Solo HTTPS
Verificado
Añada un endpoint HTTPSIndíquenos una URL que pueda recibir solicitudes POST. Confirmamos que responde antes de enviar cualquier evento real.
Eventos suscritos
deliveredMensaje aceptado
bouncedDefinitivos y temporales
complainedReportes de spam
clickedActividad de enlaces
Por evento
Por flujo
Elija los eventos que quiereSuscríbase solo a lo que le sirva para actuar: entregado, rebotado, queja, abierto o clic.
Eventos de entrega
Eventos firmados
/hooks/mail
200 OK
Analítica
200 OK
Sincronización con CRM
200 OK
En tiempo real
Varios endpoints
Los eventos se distribuyen en tiempo realCada evento se envía a todos los endpoints suscritos, de modo que analítica, CRM y alertas se mantienen sincronizados.
Payload
{ "event": "delivered" }
Cabecera de firma
sha256=9f2c41…
Secreto compartido
Con marca de tiempo
Comparación en tiempo constante
Rechace todo lo que no supere la verificación
HMAC-SHA256
Protegido contra repeticiones
Verifique cada solicitudCada solicitud lleva una firma HMAC creada con su secreto, para que pueda comprobar que procede de nosotros.
Estado del endpoint · /hooks/mail
IA
hace 1 h
Ahora
Errores en aumentoLa mayoría de los fallos son 502 tras su último despliegue.
Sugerencia: ponga los eventos en cola y reprodúzcalos cuando /hooks/mail se recupere
Agrupa los fallos
Pausar o reproducir
La IA detecta pronto un endpoint que fallaEn lugar de esperar a que se agoten los reintentos, la IA detecta que la tasa de errores de su endpoint sube y agrupa los fallos por causa. Propone una solución y puede pausar el evento que genera ruido.
Handler de webhook
Node
Python
PHP
Go
PHP
app.post("/hook", (req, res) => {
verify(req, SECRET)
res.sendStatus(200)
})
200 OK
Confirme rápido
Idempotente
Un handler en pocas líneasVerifique la firma, confirme rápido y procese después. Es todo lo que necesita un consumidor fiable.
Endpoint
Eventos
Distribución
Firma
Triaje con IA
Handler
Relay SMTPAPI RESTWebhooksIP dedicadasFirma DKIMInbound parsePlantillasAnalíticaListas de supresiónMonitorización de reputaciónValidación de correoRoles de equipo y registro de auditoríaRelay SMTPAPI RESTWebhooksIP dedicadasFirma DKIMInbound parsePlantillasAnalíticaListas de supresiónMonitorización de reputaciónValidación de correoRoles de equipo y registro de auditoría
Funcionalidades

Entrega fiable de eventos

Cada resultado

Entregado, diferido, rebotado, abierto, con clic, con queja y baja.

Payloads firmados

Verifique que cada solicitud procede de MigoSMTP.

Reintentos con espera progresiva

Las entregas fallidas se reintentan automáticamente.

Reproducción

Reenvíe eventos desde el log tras una interrupción.

Filtros de eventos

Suscríbase solo a los eventos que necesite.

Logs de entrega

Vea la solicitud, la respuesta y el estado de cada intento.

Cómo funciona

Se produce un eventoUn mensaje se entrega, se difiere, rebota, se abre, recibe un clic o se reporta como spam.
MigoSMTP firma y envíaEl evento se empaqueta en un payload JSON firmado y se envía a su endpoint HTTPS.
Su endpoint verificaSu handler comprueba la firma y confirma con una respuesta 2xx.
Reintento y reproducciónLas entregas fallidas se reintentan, y puede reproducir los eventos desde el log tras una interrupción.
PASO 1

Añada un endpoint

Introduzca su URL HTTPS y elija los eventos.

PASO 2

Verifique la firma

Compruebe la cabecera de firma en cada solicitud.

PASO 3

Procese y confirme

Devuelva una respuesta 2xx para confirmar la recepción.

Véalo en acción

Una plataforma, del primer envío a la bandeja de entrada

Cambie entre etapas para ver qué controla en cada paso. Interfaz ilustrativa. Todas las cifras y direcciones mostradas son datos de ejemplo.

app.migosmtp.com / sendDatos de ejemplo
En cola
184,320
Enviados hoy
6,418,905
Tasa
412/s
aceptadomensaje para you@example.com
aceptadomensaje para team@example.com
en colalote de 25 000 destinatarios
aceptadomensaje para ops@example.com
Operaciones

Mantenga sus sistemas al ritmo de su correo

Actualice su base de datos, lance flujos de trabajo y avise a su equipo sin necesidad de sondeo.

  • Selección de eventos por endpoint
  • Reintentos automáticos y reproducción manual
  • Logs completos de solicitudes y respuestas
  • Secretos que puede rotar
De un vistazo
TransporteHTTPS POST
FormatoJSON
SeguridadCabecera de firma
ReintentosAutomáticos, con espera progresiva
Resumen

¿Qué son los webhooks y los eventos?

Los webhooks de correo son callbacks HTTP que avisan a su aplicación cuando ocurre algo con un mensaje que envió. MigoSMTP envía un payload JSON firmado a su endpoint HTTPS para eventos como entregado, diferido, rebotado, abierto, con clic, con queja y baja. Su sistema reacciona de inmediato, en lugar de consultar la API una y otra vez para conocer el estado. Los payloads incluyen el ID del mensaje, el destinatario, el tipo de evento, la marca de tiempo y, en los fallos, el motivo devuelto por el servidor receptor. Estos campos le permiten relacionar los eventos con sus propios registros sin consultas adicionales ni conjeturas.

Usted registra un endpoint, elige qué eventos debe recibir y verifica la cabecera de firma en cada solicitud. Devuelva una respuesta 2xx para confirmar la recepción. Si su endpoint falla, las entregas se reintentan con espera progresiva y puede reproducir los eventos desde el log tras una interrupción. Se conservan los detalles de solicitud y respuesta de cada intento para que depure con rapidez. Los secretos pueden rotarse y los filtros de eventos mantienen cada endpoint centrado. Los intentos fallidos muestran la solicitud, la respuesta y la hora, lo que hace que depurar un handler sea rápido y se base en evidencias.

Los datos de eventos son la forma en que un sistema de envío aprende. Actualizar la supresión, pausar una campaña ante un pico de quejas o avisar a soporte de un recibo rebotado dependen de recibir los eventos a tiempo. Nuestra capa de IA puede resumir flujos de gran volumen y señalar patrones inusuales, para que su equipo detecte un problema en minutos y no cuando un cliente se queje. La reproducción y los logs hacen que una laguna en sus propios sistemas no se convierta en una laguna en sus datos.

Casos de uso

Casos de uso habituales de webhooks y eventos

Mantener su base de datos sincronizada

Marque los pedidos como notificados al entregarse y señale los contactos cuando llegue un rebote definitivo. Los webhooks eliminan la necesidad de tareas de sondeo y mantienen exacto el estado de la aplicación.

Gestión automática de supresión

Ante un evento de rebote o queja, añada la dirección de inmediato a su propia tabla de exclusión, para que otros sistemas que escriben a esa misma persona también dejen de hacerlo.

Alertas para los equipos de soporte

Envíe una alerta a Slack o un ticket cuando rebote un restablecimiento de contraseña. Así soporte puede contactar con el cliente por otro canal antes de que desista. Ahorra horas de trabajo manual.

Recuperación tras una caída

Si su endpoint estaba fuera de línea durante un despliegue, reproduzca los eventos perdidos desde el log y devuelva sus registros al estado correcto. Entretanto no se pierde nada.

Actualizar el estado de pedidos y tickets

Marque un pedido como notificado o un ticket de soporte como respondido en cuanto llegue el evento de entrega.

Alimente su almacén de datos

Envíe los eventos a su propia analítica para que los resultados del correo queden junto a los datos de producto e ingresos.

Elegir un método

¿Webhooks o sondeo de la API?

Ambos le dan datos de eventos. Se adaptan a situaciones distintas.

WebhooksSondeo de la API
Cómo funcionaEnviamos los eventos a su endpointSu código consulta según un calendario
VelocidadCasi en tiempo realDepende de su intervalo de sondeo
CargaSolo cuando ocurre algoSolicitudes constantes, casi siempre vacías
FiabilidadLos reintentos y la reproducción cubren las interrupcionesUsted debe llevar la cuenta de lo ya leído
Ideal paraEstado en vivo y automatizaciónRecuperación de históricos e informes programados

Muchos equipos usan webhooks para las actualizaciones en vivo y la API para recuperar lo que se les haya pasado.

Funciones de IA

Webhooks y eventos asistidos por IA

Copiloto

Resúmenes del flujo de eventos

Un copiloto condensa miles de eventos en un resumen breve, por ejemplo qué proveedor está difiriendo y qué campaña genera quejas, con enlaces a los mensajes que respaldan cada punto.

Predictivo

Detección de anomalías en eventos

Los modelos aprenden las tasas normales de rebote, queja y diferimiento y le avisan cuando un flujo se aparta de ellas. Usted define a quién se notifica y si se ejecuta alguna automatización.

Asistencia

Asistente de depuración de payloads

Pegue el log de una entrega fallida y el asistente explica la causa probable, como una firma que no coincide o un timeout, y sugiere una solución para probar. El cambio lo hace usted.

Listo para agentes

Acceso a eventos preparado para agentes

A través de un servidor MCP, los agentes de IA pueden leer el historial de eventos y los logs de entrega con alcances de solo lectura. Las acciones de escritura requieren alcances explícitos y, si lo desea, aprobación humana.

Las funciones de IA son de apoyo: resumen y alertan, y cualquier acción automatizada la configura y aprueba su equipo.

Buenas prácticas

Buenas prácticas para webhooks y eventos

Verifique siempre la firma

Rechace las solicitudes cuya cabecera de firma no coincida. Rote el secreto periódicamente y de inmediato si pudo haberse expuesto.

Responda rápido, trabaje de forma asíncrona

Confirme con un 2xx en cuanto el payload esté guardado de forma segura y procéselo después desde una cola. Los handlers lentos provocan timeouts y reintentos duplicados.

Diseñe para duplicados y desorden

Las entregas pueden repetirse y llegar desordenadas. Use el ID del mensaje y la marca de tiempo para deduplicar e ignorar cambios de estado obsoletos.

Suscríbase solo a lo que use

Filtre los eventos por endpoint. Menos solicitudes irrelevantes significan menos carga en sus servidores y una monitorización más sencilla. Mantenga las integraciones ligeras y fáciles de depurar.

Monitorice su propio endpoint

Configure alertas ante fallos repetidos en el log de entrega. Una caída silenciosa supone una deriva silenciosa de los datos hasta que alguien reproduce el hueco.

Confirme rápido, procese después

Devuelva un 2xx rápido y pase el trabajo pesado a una cola, para que los handlers lentos no provoquen reintentos.

Preguntas frecuentes

Webhooks y eventos: preguntas frecuentes

¿Necesita ayuda para conectar un endpoint? Nuestro equipo puede revisarlo con usted antes del lanzamiento.

¿Qué es un webhook de correo?

Un webhook de correo es una solicitud HTTP que su proveedor de correo envía a su servidor cuando ocurre un evento, como que un mensaje se entregue o rebote. Permite que su aplicación reaccione en tiempo real sin consultar la API repetidamente. Sustituye las tareas de sondeo y mantiene al día sus registros.

¿Cómo verifico la firma de un webhook?

Cada solicitud incluye una cabecera de firma generada con el secreto de su endpoint. Recalcule la firma a partir del cuerpo bruto de la solicitud en su lado y compárela. Rechace la solicitud si difieren. La documentación incluye ejemplos de código.

¿Qué eventos puedo recibir?

Entregado, diferido, rebotado, abierto, con clic, con queja y baja. Puede suscribir cada endpoint a un subconjunto, de modo que un servicio reciba los rebotes y otro los eventos de interacción. Elija solo aquellos con los que actúen sus sistemas, como los rebotes para la supresión y los clics para la analítica, para que el tráfico hacia su endpoint sea reducido y relevante.

¿Qué pasa si mi endpoint está caído?

Las entregas fallidas se reintentan con espera progresiva y, una vez recuperado, puede reproducir los eventos desde el log. Cada intento, con su solicitud y respuesta, queda registrado para que vea qué falló. Compruebe que su handler responde rápido y registra los fallos.

¿Los eventos de webhook se entregan en orden?

No cuente con un orden estricto. Cree handlers que toleren duplicados y eventos desordenados usando el ID del mensaje y la marca de tiempo. El orden de los eventos puede variar según el proveedor y los reintentos, y un solo mensaje puede generar varios eventos.

¿Qué son las aperturas de bots?

Algunos sistemas de correo descargan las imágenes automáticamente, lo que se registra como una apertura aunque ninguna persona haya leído el mensaje. Las separamos de las aperturas humanas cuando podemos, pero el seguimiento de aperturas sigue siendo una estimación. Trate las aperturas como un indicador aproximado. Considere los clics y las respuestas como señales más sólidas de interacción.

¿Cómo pruebo un endpoint de webhook?

Envíe un evento de ejemplo desde el panel a su URL y compruebe que su handler verifica la firma y devuelve un 2xx. Revise el log de entrega para ver la solicitud y su respuesta. Use un endpoint de staging con un secreto de prueba antes de pasar a producción. Hágalo antes de apuntar producción al endpoint.

¿Cómo funciona la IA con los webhooks y los eventos?

La IA puede resumir flujos de eventos, señalar patrones inusuales de rebotes o quejas y ayudar a depurar entregas fallidas. Recomienda acciones, pero no cambia su configuración a menos que usted establezca una regla. Revise los logs recientes antes de conectar nuevos endpoints.

¿Cómo pruebo un endpoint?

Envíe un evento de ejemplo desde el panel.

¿Está garantizado el orden?

Cree handlers que toleren duplicados y eventos desordenados, usando el ID del mensaje y la marca de tiempo para deduplicar.

Empieza a enviar en minutos.

Crea una cuenta, añade tu dominio y envía tu primer correo.