Email Message

Un Email Message es el registro de un email enviado o recibido por la infraestructura de AM.

Schema

interface EmailMessage {
  id: string; // "eml_..." - Identificador único
  account_id: string; // Cuenta propietaria
  hostname: string; // Dominio de envío
  direction: "in" | "out"; // Entrada o salida
  from_contact: EmailContact;
  reply_to_contacts: EmailContact[];
  to_contacts: EmailContact[];
  cc_contacts: EmailContact[];
  bcc_contacts: EmailContact[];
  subject: string;
  body_text: string;
  body_html: string;
  received_at: string | null;
  sent_at: string | null;
}

interface EmailContact {
  email: string;
  name?: string;
}

Propiedades

Propiedad	Tipo	Descripción
`id`	`string`	KSUID con prefijo `eml`
`account_id`	`string`	Cuenta propietaria
`hostname`	`string`	Dominio usado para enviar
`direction`	`enum`	`in` recibido, `out` enviado
`from_contact`	`object`	Remitente
`reply_to_contacts`	`array`	Reply-to
`to_contacts`	`array`	Destinatarios
`cc_contacts`	`array`	CC
`bcc_contacts`	`array`	BCC
`subject`	`string`	Asunto
`body_text`	`string`	Texto plano
`body_html`	`string`	HTML
`received_at`	`string?`	Recibido (inbound)
`sent_at`	`string?`	Enviado (outbound)

Ejemplo

{
  "id": "eml_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "hostname": "mail.example.com",
  "direction": "out",
  "from_contact": {
    "email": "noreply@example.com",
    "name": "Acme Corp"
  },
  "reply_to_contacts": [],
  "to_contacts": [{ "email": "user@example.com", "name": "Jane Doe" }],
  "cc_contacts": [],
  "bcc_contacts": [],
  "subject": "Welcome to Acme",
  "body_text": "Welcome...",
  "body_html": "<h1>Welcome</h1>...",
  "sent_at": "2025-01-15T10:30:00Z"
}

Relacionado

Email Message Event - Tracking de entrega
Email Template - Plantillas
Email - Infraestructura