Événement de message e-mail (Types) | Documentation Accountmaker

Événement de message e-mail

Un événement de message e-mail suit les changements de statut de livraison d’un message, offrant de la visibilité sur son cycle de vie.

Schéma

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
}

Propriétés

Propriété	Type	Description
`id`	`string`	KSUID avec préfixe `eme_`
`account_id`	`string`	Contexte du compte
`email_message_id`	`string`	Message concerné par cet événement
`event_type`	`string`	Type d’événement
`meta`	`object?`	Métadonnées spécifiques à l’événement
`occurred_at`	`string`	Date/heure de l’événement

Types d’événements

Les types d’événements sont spécifiques au fournisseur. Les valeurs courantes incluent :

Type	Description
`queued`	Message accepté pour livraison
`sent`	Transmis au MTA destinataire
`delivered`	Livraison confirmée en boîte mail
`bounced`	Échec de livraison permanent
`soft_bounced`	Échec de livraison temporaire
`complained`	Destinataire l’a signalé comme spam
`opened`	Destinataire a ouvert l’e-mail
`clicked`	Destinataire a cliqué un lien

Flux d’événements

Exemple

{
  "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"
}

Liés

Message e-mail - Enregistrements de messages
E-mail - Infrastructure e-mail