Webhooks
Los webhooks te permiten recibir notificaciones HTTP en tiempo real cuando ocurren eventos en tu cuenta de Emailit, como cuando se entrega un correo, rebota, o cuando se crea un contacto.
En lugar de consultar constantemente la API para detectar cambios, los webhooks envían datos a tu servidor conforme ocurren los eventos, permitiéndote crear integraciones y flujos de trabajo reactivos.
Cómo funciona
- Creas un endpoint webhook en tu aplicación que acepta solicitudes
POST - Registras la URL en el panel de Emailit o a través de la API
- Cuando ocurre un evento al que estás suscrito, Emailit envía una solicitud
POSTa tu URL con los datos del evento - Tu endpoint responde con un código de estado
2xxpara confirmar la recepción
Estructura del evento
Todos los eventos webhook siguen una estructura consistente:
{
"event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
"type": "email.delivered",
"data": {
"object": {
...
}
}
}
| Campo | Descripción |
|---|---|
event_id | Identificador único para este evento |
type | El tipo de evento (ej. email.delivered, contact.created) |
data.object | El objeto del recurso asociado con el evento |
Eventos disponibles
Emailit envía notificaciones webhook para los siguientes tipos de recursos:
- Correos — eventos del ciclo de vida de entrega (aceptado, entregado, rebotado, etc.)
- Dominios — creación, actualizaciones y eliminación de dominios
- Audiencias — eventos de gestión de audiencias
- Suscriptores — eventos del ciclo de vida de suscriptores
- Contactos — eventos de gestión de contactos
- Plantillas — creación, actualizaciones y eliminación de plantillas
- Supresiones — cambios en listas de supresión
- Verificaciones de Correo — resultados de verificación
- Listas de Verificación de Correo — eventos de listas de verificación masiva
Consulta Tipos de Eventos para la lista completa.
Próximos pasos
- Tipos de Eventos — Lista completa de todos los tipos de eventos disponibles
- Solicitudes Webhook — Cómo se estructuran las solicitudes HTTP de webhook
- Firma de Solicitud — Verifica la autenticidad de webhooks usando firmas