> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Journaux des e-mails clients

> Consultez chaque e-mail transactionnel que Dodo Payments a envoyé à un client, vérifiez s'il est arrivé, lisez l'e-mail exactement tel qu'il a été envoyé et renvoyez-le.

<CardGroup cols={2}>
  <Card title="List Customer Emails" icon="list" href="/api-reference/customers/list-customer-emails">
    Consultez les e-mails envoyés à un client et leur résultat de livraison.
  </Card>

  <Card title="Get Email Content" icon="envelope-open" href="/api-reference/customers/get-customer-email-body">
    Consultez un e-mail exactement tel qu'il a été envoyé.
  </Card>
</CardGroup>

## Vue d'ensemble

Dodo Payments envoie des e-mails transactionnels à vos clients en votre nom : reçus, notifications de remboursement, notifications d'abonnement, e-mails de relance et de récupération, attribution de droits et liens de connexion au Customer Portal.

L'onglet **E-mails envoyés** d'un client enregistre chacun d'entre eux. Pour chaque e-mail, vous voyez ce qui a été envoyé, jusqu'où il est arrivé et pourquoi il n'est pas arrivé en cas d'échec. Vous pouvez ouvrir l'e-mail reçu par votre client et le renvoyer.

<Frame>
  <img src="https://mintcdn.com/dodopayments/9G2eOufWVa-OvQvG/images/email-logs/sent-emails-tab.png?fit=max&auto=format&n=9G2eOufWVa-OvQvG&q=85&s=6c7fa235800cee5c32eb286312f2a52b" alt="Onglet E-mails envoyés d'un client, affichant chaque e-mail avec son statut de livraison" style={{ maxHeight: '500px', width: 'auto' }} width="2310" height="996" data-path="images/email-logs/sent-emails-tab.png" />
</Frame>

<Info>
  Les e-mails sont conservés pendant **180 jours**. Le statut de livraison provient du fournisseur d'e-mails et est mis à jour dans les secondes qui suivent l'événement.
</Info>

## Consulter les e-mails d'un client

<Steps>
  <Step title="Open the customer">
    Accédez à **Customers** dans le dashboard et sélectionnez le client.
  </Step>

  <Step title="Open the Sent Emails tab">
    L'onglet répertorie tous les e-mails envoyés à ce client au cours des 180 derniers jours, du plus récent au plus ancien.
  </Step>

  <Step title="Read a row">
    Chaque ligne affiche l'objet, l'expéditeur en dessous, la catégorie, la date et l'heure, ainsi que le statut de livraison.
  </Step>
</Steps>

## Statut de livraison

| Statut       | Signification                                                                          |
| ------------ | -------------------------------------------------------------------------------------- |
| `sent`       | Dodo Payments a remis l'e-mail au fournisseur. Il est en cours d'acheminement.         |
| `delivered`  | Le serveur de messagerie destinataire a accepté l'e-mail.                              |
| `failed`     | L'e-mail n'est pas arrivé. La raison de l'échec est indiquée.                          |
| `complained` | Le destinataire a marqué l'e-mail comme spam.                                          |
| `blocked`    | Rien n'a été envoyé. En mode test, cela signifie que le quota hebdomadaire est épuisé. |

### Raisons de l'échec

Lorsqu'un e-mail échoue, la ligne indique une raison afin que vous sachiez s'il faut agir. Placez le curseur sur le statut **Failed** pour la lire :

| Raison                                        | Signification                                                                               | Action à effectuer                   |
| --------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------ |
| La boîte aux lettres n'existe pas             | L'adresse n'existe pas.                                                                     | Corrigez l'adresse e-mail du client. |
| Adresse rejetée par le serveur de messagerie  | Le serveur destinataire a refusé l'adresse.                                                 | Utilisez une autre adresse.          |
| Adresse bloquée après des échecs précédents   | Le fournisseur a supprimé cette adresse après un rejet définitif ou une plainte antérieure. | Utilisez une autre adresse.          |
| Boîte aux lettres pleine                      | La boîte aux lettres du destinataire n'a plus d'espace disponible.                          | Renvoyez l'e-mail plus tard.         |
| Échec temporaire de livraison                 | Un problème temporaire est survenu sur le serveur destinataire.                             | Renvoyez l'e-mail plus tard.         |
| Message rejeté car trop volumineux            | Le serveur destinataire a refusé la taille du message.                                      | Contactez le support.                |
| Destinataire ayant marqué l'e-mail comme spam | Le destinataire a signalé l'e-mail.                                                         | Ne le renvoyez pas.                  |
| Impossible d'envoyer l'e-mail                 | Le fournisseur a refusé l'envoi.                                                            | Renvoyez l'e-mail.                   |

Cinq de ces raisons nécessitent une autre adresse lors d'un nouvel envoi, car le même envoi échouerait à nouveau. Il s'agit des cas suivants : la boîte aux lettres n'existe pas, l'adresse est rejetée, l'adresse est bloquée après des échecs précédents, le message est rejeté car trop volumineux et le destinataire a marqué l'e-mail comme spam.

## Lire un e-mail

Sélectionnez **Resend** sur une ligne pour ouvrir le panneau de l'e-mail. **Email Preview** dans ce panneau affiche la copie enregistrée exactement telle qu'elle a été envoyée.

<Frame>
  <img src="https://mintcdn.com/dodopayments/9G2eOufWVa-OvQvG/images/email-logs/email-preview.png?fit=max&auto=format&n=9G2eOufWVa-OvQvG&q=85&s=b0d00b4b6fe62c6ace0b8a2b4419619b" alt="Contenu de l'e-mail enregistré, affiché tel que le client l'a reçu" style={{ maxHeight: '500px', width: 'auto' }} width="824" height="1148" data-path="images/email-logs/email-preview.png" />
</Frame>

Certains e-mails n'ont aucun contenu à afficher :

* **E-mails de connexion au Customer Portal.** Ils contiennent un lien de connexion actif, leur contenu n'est donc jamais affiché.
* **E-mails bloqués.** Ils n'ont jamais atteint le fournisseur, aucune copie n'existe donc.
* **E-mails datant de plus de 180 jours.** Le fournisseur efface le contenu passé ce délai.

## Renvoyer un e-mail

Sélectionnez **Resend** sur une ligne pour renvoyer le même e-mail. Dodo Payments le génère à nouveau à partir de l'événement d'origine ; un reçu affiche donc toujours l'état actuel du paiement.

<Frame>
  <img src="https://mintcdn.com/dodopayments/9G2eOufWVa-OvQvG/images/email-logs/resend-email.png?fit=max&auto=format&n=9G2eOufWVa-OvQvG&q=85&s=8751c05df35b14f116c8d487eaae7b70" alt="Commande de renvoi sur une ligne d'e-mail, avec l'option d'utiliser une autre adresse" style={{ maxHeight: '500px', width: 'auto' }} width="896" height="2104" data-path="images/email-logs/resend-email.png" />
</Frame>

Le panneau conserve l'adresse d'origine dans le champ **To**. Modifiez-la pour envoyer l'e-mail ailleurs. Après un échec définitif, une autre adresse est obligatoire, car le même envoi échouerait à nouveau.

<Warning>
  Un renvoi est un nouvel e-mail. Il apparaît comme une ligne distincte dans l'onglet.
</Warning>

### Limites

* Chaque e-mail peut être renvoyé **trois fois**.
* Un délai s'applique entre les tentatives : cinq minutes avant le premier renvoi, dix minutes avant le deuxième et quinze minutes avant le troisième.
* Un envoi qui n'a jamais atteint le fournisseur n'est pas comptabilisé dans les trois renvois. Il prolonge néanmoins le délai d'attente.
* Le renvoi est disponible uniquement dans le dashboard. L'API est en lecture seule.

### Lorsque le renvoi n'est pas disponible

| Cas                                                   | Raison                                                                                             |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| Le destinataire a marqué l'e-mail comme spam          | Un nouvel envoi constituerait une nouvelle plainte.                                                |
| L'adresse est supprimée                               | Le fournisseur accepte l'envoi, puis le supprime.                                                  |
| Un envoi ultérieur du même e-mail a déjà été effectué | Cette ligne appartient à l'historique. Le renvoyer entraînerait la livraison d'une deuxième copie. |
| Le client est bloqué                                  | Un client bloqué ne reçoit plus aucun e-mail de votre part.                                        |
| Les trois renvois ont été utilisés                    | La limite s'applique à chaque e-mail.                                                              |

<Note>
  Un e-mail de connexion au Customer Portal est toujours envoyé à l'adresse qui en a fait la demande, et chaque renvoi génère un nouveau lien de connexion.
</Note>

## Mode test

Le mode test envoie de vrais e-mails et comporte donc un quota : **100 e-mails par entreprise et par semaine**. Les renvois utilisent le même quota.

Lorsque le quota est épuisé, les e-mails suivants sont enregistrés comme `blocked` et rien n'est envoyé. La ligne affiche "Not sent: the test-mode email allowance for this week is spent". Le quota est réinitialisé chaque semaine. Le mode live n'impose aucune limite de ce type.

<Info>
  Les e-mails de connexion au Customer Portal ne sont jamais envoyés en mode test et ne consomment pas le quota.
</Info>

## Lire les e-mails via l'API

La liste et le contenu sont également disponibles via votre clé API, ce qui vous permet d'afficher l'état de livraison dans vos propres outils de support.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://live.dodopayments.com/customers/{customer_id}/emails?page_size=10 \
    -H "Authorization: Bearer $DODO_API_KEY"
  ```

  ```typescript Node.js theme={null}
  const res = await fetch(
    `https://live.dodopayments.com/customers/${customerId}/emails?page_size=10`,
    { headers: { Authorization: `Bearer ${process.env.DODO_API_KEY}` } },
  );
  const { items, total_count } = await res.json();
  ```

  ```python Python theme={null}
  import os, requests

  res = requests.get(
      f"https://live.dodopayments.com/customers/{customer_id}/emails",
      params={"page_size": 10},
      headers={"Authorization": f"Bearer {os.environ['DODO_API_KEY']}"},
  )
  items = res.json()["items"]
  ```
</CodeGroup>

Chaque élément contient `status`, `failure_code` et `failure_reason` lorsque l'envoi a échoué, ainsi que `has_preview` pour indiquer si du contenu enregistré existe. Il contient également un objet `policies` qui indique ce que vous pouvez faire avec la ligne :

| Champ                        | Signification                                                                |
| ---------------------------- | ---------------------------------------------------------------------------- |
| `resend_allowed`             | Vous pouvez renvoyer cette ligne.                                            |
| `retry_allowed`              | L'envoi a échoué et vous pouvez réessayer.                                   |
| `resends_remaining`          | Nombre de renvois restants pour l'e-mail.                                    |
| `requires_different_address` | La même adresse échouerait à nouveau ; vous devez donc en fournir une autre. |
| `superseded`                 | Un envoi ultérieur du même e-mail a remplacé cette ligne.                    |

Lisez `policies` au lieu de déterminer vous-même l'éligibilité. Le serveur applique les règles ci-dessus.

<CardGroup cols={2}>
  <Card title="Customer Management" icon="user-group" href="/features/customers">
    Gérez les clients, l'historique des achats et l'accès en libre-service.
  </Card>

  <Card title="Communication Preferences" icon="bell" href="/features/communication-preferences">
    Choisissez les e-mails que Dodo Payments envoie en votre nom.
  </Card>
</CardGroup>
