Email Message Event
Un Email Message Event rastrea cambios de estado de entrega de un mensaje.
Schema
interface EmailMessageEvent {
id: string; // "eme_..." - Identificador único
account_id: string; // Cuenta propietaria
email_message_id: string; // Mensaje asociado
event_type: string; // Tipo de evento
meta: Record<string, any> | null; // Datos adicionales
occurred_at: string; // Timestamp ISO 8601
}
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
id | string | KSUID con prefijo eme |
account_id | string | Cuenta |
email_message_id | string | Mensaje relacionado |
event_type | string | Tipo de evento |
meta | object? | Metadata específica |
occurred_at | string | Fecha del evento |
Tipos de evento
Los tipos dependen del proveedor. Valores comunes:
| Tipo | Descripción |
|---|---|
queued | Aceptado para entrega |
sent | Entregado al MTA receptor |
delivered | Confirmado en inbox |
bounced | Fallo permanente |
soft_bounced | Fallo temporal |
complained | Marcado como spam |
opened | Email abierto |
clicked | Clic en enlace |
Ejemplo
{
"id": "eme_2kHfPZcN9xW4mE8RtY7vB",
"account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
"email_message_id": "eml_3lIfQZdO0yX5nF9SuY8wC",
"event_type": "delivered",
"meta": {
"recipient": "user@example.com",
"smtp_response": "250 OK"
},
"occurred_at": "2025-01-15T10:30:45Z"
}
Relacionado
- Email Message - Mensajes
- Email - Infraestructura