Événement de message e-mail

É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