# Configurer la réception des e-mails

> Publiez l’enregistrement MX de réception pour votre domaine vérifié, choisissez le sous-domaine de réception, vérifiez l’enregistrement et envoyez un message de test.

Ce guide connecte un sous-domaine de votre domaine à Emailit pour qu’il puisse recevoir des e-mails. Il suffit d’un enregistrement DNS, et la livraison des e-mails adressés à votre domaine principal ne change pas.

## Avant de commencer

- Un [domaine d’envoi vérifié](/fr/docs/domains/verification/) dans votre espace de travail, par exemple `acme.com`. La réception ne fonctionne que sur les domaines vérifiés. Si vous n’en avez pas encore ajouté, suivez [Ajouter un domaine d’envoi](/fr/docs/domains/add-a-domain/).
- L’accès aux paramètres DNS de ce domaine.
- Des crédits disponibles. Chaque message reçu coûte 1 crédit.
- Les domaines sont créés avec la réception activée (le champ `incoming` vaut `true` par défaut). Laissez-le ainsi ; il n’existe pas d’interrupteur pour ce réglage dans le tableau de bord.

## Choisir le sous-domaine de réception

Emailit accepte les e-mails pour un seul sous-domaine par domaine. Par défaut, il s’agit de `inbound` : les adresses ressemblent donc à `anything@inbound.acme.com`. La valeur actuelle figure sur la page du domaine, sous **Custom Subdomains** > **Inbound Subdomain**. Le champ est en lecture seule dans le tableau de bord.

Pour utiliser un autre sous-domaine, définissez `inbound_key` avec [Mettre à jour un domaine](/fr/docs/api-reference/domains/update/). La valeur peut contenir des lettres minuscules, des chiffres et des traits d’union, compter de 1 à 63 caractères, et ne peut ni commencer ni se terminer par un trait d’union.

```bash
curl -X POST https://api.emailit.com/v2/domains/dom_2xGk5Pz8QwR1mT4vLsB7nY3cK9a \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"inbound_key": "mail"}'
```

Avec `"inbound_key": "mail"`, les adresses deviennent `anything@mail.acme.com` et l’enregistrement MX passe sur `mail.acme.com`. Modifier la clé fait repasser le statut de l’enregistrement de réception en attente, et les e-mails envoyés à l’ancien sous-domaine ne sont plus acceptés. Définissez `inbound_key` sur `null` pour revenir à `inbound`.

## Ajouter l’enregistrement MX

1. **Ouvrez le domaine.** Dans le tableau de bord, accédez à **Email API → Domains**, sélectionnez votre domaine et ouvrez l’onglet **DNS Setup**.

2. **Repérez l’enregistrement de réception.** Il s’agit de l’enregistrement MX facultatif dont le nom est `inbound` (ou votre sous-domaine personnalisé) et dont la valeur est `inbound.emailitmail.com`. Utilisez les boutons de copie pour éviter les fautes de frappe.

3. **Créez l’enregistrement chez votre fournisseur DNS.** Ajoutez un nouvel enregistrement avec ces valeurs :

   | Champ | Valeur |
   | --- | --- |
   | Type | `MX` |
   | Nom / Hôte | `inbound` (certains fournisseurs veulent le nom complet, `inbound.acme.com`) |
   | Serveur de messagerie / Valeur | `inbound.emailitmail.com` |
   | Priorité | `10` |
   | TTL | Auto, ou la valeur par défaut de votre fournisseur |

   Ne modifiez pas les enregistrements MX du domaine racine (`acme.com`). Ils continuent d’acheminer votre messagerie habituelle vers votre fournisseur de messagerie.

   Si votre domaine utilise la [configuration en un clic avec Cloudflare](/fr/docs/domains/cloudflare/), vous pouvez sélectionner l’enregistrement **Inbound** dans la boîte de dialogue de configuration au lieu de l’ajouter manuellement.

4. **Vérifiez le DNS.** De retour sur la page du domaine, sélectionnez **Check DNS**. L’enregistrement de réception affiche **OK** lorsqu’un enregistrement MX de priorité 10 pointe vers `inbound.emailitmail.com`. La plupart des fournisseurs publient les enregistrements en quelques minutes, mais cela peut prendre jusqu’à 48 heures.

   Vous pouvez aussi vérifier depuis un terminal :

```bash
dig MX inbound.acme.com +short
# 10 inbound.emailitmail.com.
```

## Envoyer un message de test

Depuis n’importe quelle boîte aux lettres personnelle, envoyez un e-mail à une adresse du sous-domaine, par exemple `test@inbound.acme.com`.

## Vérifier le résultat

- **Tableau de bord :** accédez à **Email API → Emails** et ouvrez l’onglet **Incoming**. Le message apparaît en quelques secondes avec le statut **Received**. Ouvrez-le pour voir ses en-têtes, son contenu et ses pièces jointes.
- **Événements :** **Email API → Events** affiche un événement `email.received`. Son payload contient l’ID de l’e-mail.
- **API :** listez les messages entrants avec [Lister les e-mails](/fr/docs/api-reference/emails/list/) :

```bash
curl "https://api.emailit.com/v2/emails?type=inbound" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Ensuite, [traitez les e-mails reçus avec un webhook](/fr/docs/inbound/process-with-webhooks/) ou [transférez-les avec une automatisation](/fr/docs/inbound/forward-with-automations/).

## Dépannage

<details>
<summary>L’enregistrement affiche Missing ou Invalid</summary>

Le message de statut indique ce qu’Emailit a trouvé. « There are no MX records at inbound.acme.com » signifie que l’enregistrement n’est pas encore publié, ou qu’il a été créé sur le mauvais nom (par exemple `inbound.acme.com.acme.com` quand le fournisseur ajoute le domaine automatiquement). Un statut « Invalid » liste les enregistrements trouvés et la valeur attendue `10 inbound.emailitmail.com`. Corrigez la priorité ou la valeur, attendez la mise à jour du DNS, puis sélectionnez de nouveau **Check DNS**.

</details>

<details>
<summary>J’ai fait pointer le MX de mon domaine racine vers Emailit</summary>

Emailit n’accepte les e-mails que pour le sous-domaine de réception. Si les enregistrements MX de `acme.com` pointent vers `inbound.emailitmail.com`, les e-mails adressés à `you@acme.com` sont rejetés avec `530 Authentication required`. Rétablissez les enregistrements MX racine fournis par votre fournisseur de messagerie, et n’ajoutez l’enregistrement MX que sur `inbound.acme.com`.

</details>

<details>
<summary>L’enregistrement affiche OK, mais les e-mails arrivent ailleurs</summary>

Un autre enregistrement MX sur le même nom peut être prioritaire. Les serveurs de messagerie utilisent d’abord l’enregistrement dont le numéro de priorité est le plus bas : un enregistrement supplémentaire comme `5 mx.example.net` sur `inbound.acme.com` l’emporte donc sur le `10` d’Emailit. Un enregistrement MX générique (`*.acme.com`) peut aussi capter le sous-domaine si l’enregistrement de réception est absent. Exécutez `dig MX inbound.acme.com +short` et assurez-vous que `inbound.emailitmail.com` est la seule réponse. Un CNAME sur le même nom bloque aussi les enregistrements MX ; supprimez-le.

</details>

<details>
<summary>Les expéditeurs reçoivent « 530 Authentication required »</summary>

Emailit n’a pas reconnu le domaine du destinataire. Vérifiez que l’adresse utilise le sous-domaine de réception actuel (après une modification de `inbound_key`, l’ancien sous-domaine ne fonctionne plus), que le domaine est correctement orthographié et qu’il est toujours vérifié dans **Email API → Domains**.

</details>

<details>
<summary>Les expéditeurs reçoivent « 452 Insufficient credits to receive inbound email »</summary>

L’espace de travail n’a plus de crédits. `452` est une erreur temporaire : la plupart des serveurs expéditeurs continuent de réessayer pendant des heures, voire des jours. [Achetez des crédits](/fr/docs/billing/credits/) ou activez la [recharge automatique](/fr/docs/billing/auto-refill/), et les messages renvoyés seront acceptés.

</details>

<details>
<summary>Les expéditeurs reçoivent « 535 Mail server has been suspended » ou « 552 Message too large »</summary>

`535` signifie que l’espace de travail est suspendu ; consultez [Santé d’envoi](/fr/docs/deliverability/sending-health/) ou contactez le support. `552` signifie que le message dépasse 40 Mo.

</details>

## Voir aussi

  - [Traiter avec des webhooks](/fr/docs/inbound/process-with-webhooks/)
  - [Enregistrements DNS](/fr/docs/domains/dns-records/)

---
Source: https://emailit.com/fr/docs/inbound/set-up/