Referencia
Tipos de eventos
Todos los tipos de eventos de webhook que envía Emailit, cuándo se dispara cada uno, qué objeto lleva y qué tipos no aparecen en el selector del panel.
Esta es la lista completa de los tipos de eventos que Emailit envía a los webhooks y registra en el flujo de eventos. El data.object de cada evento contiene el recurso al que se refiere; la columna Objeto muestra su valor object. Selecciona el nombre de un evento para ver su payload completo cuando existe una página de referencia.
Un webhook con All events activado recibe todos los tipos que aparecen a continuación. Cuando eliges eventos en el panel, algunos tipos no aparecen en el selector; están marcados con «No está en el selector» y puedes añadirlos con Actualizar un webhook.
Eventos de email
| Evento | Objeto | Cuándo se dispara |
|---|---|---|
email.accepted |
email |
Se aceptó y se puso en cola un email enviado con la API o con Compose. No se envía con SMTP. |
email.scheduled |
email |
Se guardó un email de la API con un scheduled_at futuro. Incluye scheduled_at. |
email.delivered |
email |
El servidor de correo del destinatario aceptó el mensaje. |
email.attempted |
email |
Un intento de entrega falló temporalmente y se reintentará. Se envía en cada intento; incluye smtp_code, smtp_enhanced_code y smtp_response. |
email.bounced |
email |
La entrega falló de forma permanente, llegó un informe de rebote después de la entrega o se agotaron los reintentos. |
email.failed |
email |
El procesamiento falló por un error, no por una respuesta del servidor del destinatario. Poco habitual. |
email.rejected |
email |
Emailit se negó a enviar a un destinatario porque el espacio de trabajo no está verificado. |
email.suppressed |
email |
El destinatario está en la lista de direcciones bloqueadas, así que el email no se envió. |
email.held |
email |
El email se retuvo y no se envió: espacio de trabajo suspendido, dominio pausado, créditos insuficientes, puntuación de spam de 7 o más, o una clave de API configurada para retener. No está en el selector. |
email.canceled |
email |
El email se canceló en el panel o con la API. Incluye status y previous_status. No está en el selector. |
email.received |
email |
Llegó un mensaje a tu subdominio de entrada. Solo lleva id, from, to, subject y created_at. |
email.complained |
email |
El destinatario marcó el email como spam a través del feedback loop de su proveedor. |
email.loaded |
load |
Se cargó la imagen de seguimiento. Se envía en cada carga, no solo en la primera. |
email.clicked |
click |
Se hizo clic en un enlace con seguimiento. Se envía en cada clic; incluye link.url. |
email.unsubscribed |
email |
Un destinatario se dio de baja con el enlace o la página de baja de un email de campaña. Incluye campaign, contact y unsubscribed_at. No está en el selector. |
email.resubscribed |
email |
Un destinatario volvió a suscribirse desde la página de baja. Incluye campaign, contact y resubscribed_at. No está en el selector. |
Los eventos de estado de email (de email.accepted a email.complained en la tabla anterior) llevan el id, from, to, subject, status y meta del email, además de marcas de tiempo. Los eventos de clic y de carga llevan su propio id, el email_id, un objeto email anidado (rcpt_to, mail_from, subject, campaign, meta), el contact correspondiente si existe, ip_address y user_agent. Para saber qué significa cada estado de email, consulta Estados de los emails.
Eventos de dominios
| Evento | Objeto | Cuándo se dispara |
|---|---|---|
domain.created |
domain |
Se añadió un dominio de envío. |
domain.updated |
domain |
Cambió la configuración de un dominio, por ejemplo el seguimiento o una clave de subdominio. Los resultados de la verificación DNS no envían este evento. |
domain.deleted |
domain |
Se eliminó un dominio. |
Eventos de listas de contactos y suscriptores
| Evento | Objeto | Cuándo se dispara |
|---|---|---|
audience.created |
audience |
Se creó una lista de contactos. |
audience.updated |
audience |
Se cambió el nombre de una lista de contactos. |
audience.deleted |
audience |
Se eliminó una lista de contactos. |
subscriber.created |
subscriber |
Se añadió un contacto a una lista de contactos. |
subscriber.updated |
subscriber |
Cambió un suscriptor, también cuando se da de baja de la lista o vuelve a suscribirse a ella. |
subscriber.deleted |
subscriber |
Se quitó un contacto de una lista de contactos, también cuando se eliminó el contacto. |
subscriber.resubscribed |
subscriber |
Se volvió a añadir a la lista un contacto dado de baja. Se envía junto con subscriber.updated. No está en el selector. |
Los objetos de suscriptor incluyen subscribed, subscribed_at, unsubscribed_at, audience (id, name) y contact (id, email, nombres y campos personalizados).
Eventos de contactos, plantillas y direcciones bloqueadas
| Evento | Objeto | Cuándo se dispara |
|---|---|---|
contact.created |
contact |
Se creó un contacto. |
contact.updated |
contact |
Cambiaron los campos, los campos personalizados o las listas de un contacto. |
contact.deleted |
contact |
Se eliminó un contacto. |
template.created |
template |
Se creó una plantilla o una nueva versión de plantilla. |
template.updated |
template |
Se editó o se publicó una plantilla. |
template.deleted |
template |
Se eliminó una plantilla. |
suppression.created |
suppression |
Se bloqueó una dirección en el panel, con la API, mediante una importación CSV o desde una automatización. |
suppression.updated |
suppression |
Cambió el motivo o la caducidad de un bloqueo. |
suppression.deleted |
suppression |
Se desbloqueó una dirección. |
Las direcciones que el proceso de entrega bloquea automáticamente tras un rebote o una queja no envían suppression.created. Para seguirlas, escucha email.bounced y email.complained.
Eventos de verificación de emails
| Evento | Objeto | Cuándo se dispara |
|---|---|---|
email_verification.created |
email_verification |
Se solicitó la verificación de una sola dirección. |
email_verification.updated |
email_verification |
Terminó una verificación y su resultado está disponible. |
email_verification_list.created |
email_verification_list |
Se creó una lista de direcciones (verificación masiva). |
email_verification_list.updated |
email_verification_list |
Una lista terminó de procesarse. Incluye status y stats. |
El selector del panel también muestra email_verification.deleted y email_verification_list.deleted. Emailit no envía estos eventos.
Eventos de campañas
Los eventos de campañas no están en el selector del panel. Llegan a los webhooks que tienen All events activado, o puedes añadirlos con la API. Cada uno lleva un objeto campaign con id, name, status, subject, from_email, from_name, scheduled_at, sent_at y created_at. Los cambios de estado también incluyen previous_status.
| Evento | Cuándo se dispara |
|---|---|
campaign.created |
Se creó una campaña. |
campaign.updated |
Cambió el contenido, el remitente o los destinatarios de una campaña. |
campaign.deleted |
Se eliminó una campaña. |
campaign.scheduled |
Se programó una campaña para una fecha futura. |
campaign.queued |
Una campaña programada llegó a su hora de envío y se puso en cola. |
campaign.sending |
Una campaña empezó a enviarse. |
campaign.testing |
Una campaña pasó al estado testing. |
campaign.sent |
Una campaña terminó de enviarse. |
campaign.canceled |
Se canceló una campaña. |
campaign.archived |
Se archivó una campaña. |
Nombres de eventos obsoletos
El grupo Deprecated del selector del panel muestra nombres de una versión anterior de Emailit: email.sent, email.opened, email.softfail, email.hardfail, email.error, email.delayed y email.processed. Ya no se envían. Usa email.delivered, email.loaded, email.attempted y email.bounced en su lugar.