# Types d’événements

> Tous les types d’événements webhook envoyés par Emailit, quand chacun se déclenche, quel objet il contient et quels types le sélecteur du tableau de bord omet.

Voici la liste complète des types d’événements qu’Emailit envoie aux webhooks et enregistre dans le [flux d’événements](/fr/docs/logs/events/). Le `data.object` de chaque événement contient la ressource concernée ; la colonne **Objet** indique sa valeur `object`. Sélectionnez le nom d’un événement pour afficher son payload complet, lorsqu’une page de référence existe.

Un webhook dont l’option **All events** est activée reçoit tous les types ci-dessous. Lorsque vous choisissez les événements dans le tableau de bord, certains types ne figurent pas dans le sélecteur ; ils sont signalés par « Absent du sélecteur » et vous pouvez les ajouter avec [Mettre à jour un webhook](/fr/docs/api-reference/webhooks/update/).

## Événements d’e-mail

| Événement | Objet | Déclenché lorsque |
| --- | --- | --- |
| [`email.accepted`](/fr/docs/webhooks/events/email/accepted/) | `email` | Un e-mail envoyé via l’API ou Compose a été accepté et mis en file d’attente. Pas envoyé pour le SMTP. |
| [`email.scheduled`](/fr/docs/webhooks/events/email/scheduled/) | `email` | Un e-mail envoyé via l’API avec un `scheduled_at` dans le futur a été enregistré. Contient `scheduled_at`. |
| [`email.delivered`](/fr/docs/webhooks/events/email/delivered/) | `email` | Le serveur de messagerie du destinataire a accepté le message. |
| [`email.attempted`](/fr/docs/webhooks/events/email/attempted/) | `email` | Une tentative de livraison a échoué temporairement et sera renouvelée. Envoyé à chaque tentative ; contient `smtp_code`, `smtp_enhanced_code` et `smtp_response`. |
| [`email.bounced`](/fr/docs/webhooks/events/email/bounced/) | `email` | La livraison a échoué définitivement, un rapport de rebond est arrivé après la livraison, ou les nouvelles tentatives sont épuisées. |
| [`email.failed`](/fr/docs/webhooks/events/email/failed/) | `email` | Le traitement a échoué à cause d’une erreur, et non d’une réponse du serveur du destinataire. Rare. |
| [`email.rejected`](/fr/docs/webhooks/events/email/rejected/) | `email` | Emailit a refusé d’envoyer à un destinataire parce que l’espace de travail n’est pas vérifié. |
| [`email.suppressed`](/fr/docs/webhooks/events/email/suppressed/) | `email` | Le destinataire figure dans la liste d’adresses bloquées : l’e-mail n’a pas été envoyé. |
| `email.held` | `email` | L’e-mail a été retenu et n’a pas été envoyé : espace de travail suspendu, domaine en pause, crédits insuffisants, score de spam de 7 ou plus, ou clé API configurée pour retenir les e-mails. Absent du sélecteur. |
| `email.canceled` | `email` | L’e-mail a été annulé dans le tableau de bord ou via l’API. Contient `status` et `previous_status`. Absent du sélecteur. |
| [`email.received`](/fr/docs/webhooks/events/email/received/) | `email` | Un message est arrivé sur votre sous-domaine de [réception](/fr/docs/inbound/). Ne contient que `id`, `from`, `to`, `subject` et `created_at`. |
| [`email.complained`](/fr/docs/webhooks/events/email/complained/) | `email` | Le destinataire a signalé l’e-mail comme spam via la boucle de rétroaction (feedback loop) de son fournisseur. |
| [`email.loaded`](/fr/docs/webhooks/events/email/loaded/) | `load` | L’image de suivi a été chargée. Envoyé à chaque chargement, pas seulement au premier. |
| [`email.clicked`](/fr/docs/webhooks/events/email/clicked/) | `click` | Un lien suivi a été cliqué. Envoyé à chaque clic ; contient `link.url`. |
| `email.unsubscribed` | `email` | Un destinataire s’est désinscrit via le lien ou la page de désinscription d’un e-mail de campagne. Contient `campaign`, `contact` et `unsubscribed_at`. Absent du sélecteur. |
| `email.resubscribed` | `email` | Un destinataire s’est réinscrit depuis la page de désinscription. Contient `campaign`, `contact` et `resubscribed_at`. Absent du sélecteur. |

Les événements de statut d’e-mail (de `email.accepted` à `email.complained` ci-dessus) contiennent les champs `id`, `from`, `to`, `subject`, `status` et `meta` de l’e-mail, ainsi que des horodatages. Les événements de clic et de chargement contiennent leur propre `id`, l’`email_id`, un objet `email` imbriqué (`rcpt_to`, `mail_from`, `subject`, `campaign`, `meta`), le `contact` correspondant s’il existe, `ip_address` et `user_agent`. Pour la signification de chaque statut d’e-mail, consultez [Statuts des e-mails](/fr/docs/logs/email-statuses/).

## Événements de domaine

| Événement | Objet | Déclenché lorsque |
| --- | --- | --- |
| [`domain.created`](/fr/docs/webhooks/events/domain/created/) | `domain` | Un domaine d’envoi a été ajouté. |
| [`domain.updated`](/fr/docs/webhooks/events/domain/updated/) | `domain` | Les paramètres d’un domaine ont changé, par exemple le suivi ou une clé de sous-domaine. Les résultats de la vérification DNS ne déclenchent pas cet événement. |
| [`domain.deleted`](/fr/docs/webhooks/events/domain/deleted/) | `domain` | Un domaine a été supprimé. |

## Événements de listes de contacts et d’abonnés

| Événement | Objet | Déclenché lorsque |
| --- | --- | --- |
| [`audience.created`](/fr/docs/webhooks/events/audience/created/) | `audience` | Une liste de contacts a été créée. |
| [`audience.updated`](/fr/docs/webhooks/events/audience/updated/) | `audience` | Une liste a été renommée. |
| [`audience.deleted`](/fr/docs/webhooks/events/audience/deleted/) | `audience` | Une liste a été supprimée. |
| [`subscriber.created`](/fr/docs/webhooks/events/subscriber/created/) | `subscriber` | Un contact a été ajouté à une liste. |
| [`subscriber.updated`](/fr/docs/webhooks/events/subscriber/updated/) | `subscriber` | Un abonné a été modifié, y compris lorsqu’il se désinscrit de la liste ou s’y réinscrit. |
| [`subscriber.deleted`](/fr/docs/webhooks/events/subscriber/deleted/) | `subscriber` | Un contact a été retiré d’une liste, y compris lorsque le contact a été supprimé. |
| `subscriber.resubscribed` | `subscriber` | Un contact désinscrit a de nouveau été ajouté à la liste. Envoyé en même temps que `subscriber.updated`. Absent du sélecteur. |

Les objets abonné contiennent `subscribed`, `subscribed_at`, `unsubscribed_at`, la liste `audience` (`id`, `name`) et le contact `contact` (`id`, `email`, noms et champs personnalisés).

## Événements de contact, de modèle et de blocage

| Événement | Objet | Déclenché lorsque |
| --- | --- | --- |
| [`contact.created`](/fr/docs/webhooks/events/contact/created/) | `contact` | Un contact a été créé. |
| [`contact.updated`](/fr/docs/webhooks/events/contact/updated/) | `contact` | Les champs, les champs personnalisés ou les listes d’un contact ont changé. |
| [`contact.deleted`](/fr/docs/webhooks/events/contact/deleted/) | `contact` | Un contact a été supprimé. |
| [`template.created`](/fr/docs/webhooks/events/template/created/) | `template` | Un modèle, ou une nouvelle version de modèle, a été créé. |
| [`template.updated`](/fr/docs/webhooks/events/template/updated/) | `template` | Un modèle a été modifié ou publié. |
| [`template.deleted`](/fr/docs/webhooks/events/template/deleted/) | `template` | Un modèle a été supprimé. |
| [`suppression.created`](/fr/docs/webhooks/events/suppression/created/) | `suppression` | Un blocage a été ajouté dans le tableau de bord, via l’API, par import CSV ou par une automatisation. |
| [`suppression.updated`](/fr/docs/webhooks/events/suppression/updated/) | `suppression` | Le motif ou la date d’expiration d’un blocage a changé. |
| [`suppression.deleted`](/fr/docs/webhooks/events/suppression/deleted/) | `suppression` | Un blocage a été supprimé. |

Les blocages que la chaîne de livraison ajoute automatiquement après un rebond ou une plainte ne déclenchent pas `suppression.created`. Pour les suivre, écoutez `email.bounced` et `email.complained`.

## Événements de vérification d’e-mails

| Événement | Objet | Déclenché lorsque |
| --- | --- | --- |
| [`email_verification.created`](/fr/docs/webhooks/events/email-verification/created/) | `email_verification` | La vérification d’une adresse unique a été demandée. |
| [`email_verification.updated`](/fr/docs/webhooks/events/email-verification/updated/) | `email_verification` | Une vérification est terminée et son résultat est disponible. |
| [`email_verification_list.created`](/fr/docs/webhooks/events/email-verification-list/created/) | `email_verification_list` | Une liste de vérification a été créée. |
| [`email_verification_list.updated`](/fr/docs/webhooks/events/email-verification-list/updated/) | `email_verification_list` | Le traitement d’une liste est terminé. Contient `status` et `stats`. |

Le sélecteur du tableau de bord propose aussi `email_verification.deleted` et `email_verification_list.deleted`. Emailit n’envoie pas ces événements.

## Événements de campagne

Les événements de campagne ne figurent pas dans le sélecteur du tableau de bord. Ils parviennent aux webhooks dont l’option **All events** est activée, ou vous pouvez les ajouter via l’API. Chacun contient un objet `campaign` avec `id`, `name`, `status`, `subject`, `from_email`, `from_name`, `scheduled_at`, `sent_at` et `created_at`. Les changements de statut contiennent aussi `previous_status`.

| Événement | Déclenché lorsque |
| --- | --- |
| `campaign.created` | Une campagne a été créée. |
| `campaign.updated` | Le contenu, l’expéditeur ou les destinataires d’une campagne ont changé. |
| `campaign.deleted` | Une campagne a été supprimée. |
| `campaign.scheduled` | Une campagne a été programmée pour une date ultérieure. |
| `campaign.queued` | Une campagne programmée a atteint son heure d’envoi et a été mise en file d’attente. |
| `campaign.sending` | L’envoi d’une campagne a commencé. |
| `campaign.testing` | Une campagne est passée au statut `testing`. |
| `campaign.sent` | L’envoi d’une campagne est terminé. |
| `campaign.canceled` | Une campagne a été annulée. |
| `campaign.archived` | Une campagne a été archivée. |

## Noms d’événements obsolètes

Le groupe **Deprecated** du sélecteur du tableau de bord liste des noms issus d’une ancienne version d’Emailit : `email.sent`, `email.opened`, `email.softfail`, `email.hardfail`, `email.error`, `email.delayed` et `email.processed`. Ils ne sont plus envoyés. Utilisez plutôt `email.delivered`, `email.loaded`, `email.attempted` et `email.bounced`.

## Voir aussi

  - [Requêtes de webhook](/fr/docs/webhooks/webhook-requests/): L’enveloppe qui entoure chaque événement.
  - [Configurer un webhook](/fr/docs/webhooks/set-up/): Choisissez les événements et les filtres.

---
Source: https://emailit.com/fr/docs/webhooks/event-types/