Email Message Event

Email Message Event

Un Email Message Event rastrea cambios en el estado de entrega de un mensaje de email y aporta visibilidad sobre su ciclo de vida.

Schema

interface EmailMessageEvent {
  id: string; // "eme_..." - Unique identifier
  account_id: string; // Owning account
  email_message_id: string; // Associated message
  event_type: string; // Event type
  meta: Record<string, any> | null; // Additional data
  occurred_at: string; // ISO 8601 timestamp
}

Propiedades

Propiedad	Tipo	Descripción
id	string	KSUID con prefijo eme_
account_id	string	Contexto de cuenta
email_message_id	string	Mensaje al que pertenece este evento
event_type	string	Tipo de evento
meta	object?	Metadata específica del evento
occurred_at	string	Momento en que ocurrió el evento

Tipos de evento

Los tipos de evento dependen del proveedor. Los valores comunes incluyen:

Tipo	Descripción
queued	Mensaje aceptado para entrega
sent	Entregado al MTA receptor
delivered	Entrega confirmada en bandeja de entrada
bounced	La entrega falló de forma permanente
soft_bounced	Falla temporal de entrega
complained	El destinatario lo marcó como spam
opened	El destinatario abrió el email
clicked	El destinatario hizo clic en un enlace

Flujo de eventos

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 - Registros de mensajes
• Email - Infraestructura de email