Email Message Event (Tipos) | Documentación de Accountmaker

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