# Recevoir votre premier e-mail entrant

> Ajoutez l’enregistrement MX de réception, envoyez un message de test à votre sous-domaine de réception, retrouvez-le dans le tableau de bord, puis traitez-le avec un webhook email.received et l’API.

Ce démarrage rapide configure un domaine pour recevoir des e-mails, afin que votre application puisse traiter les réponses, les demandes de support ou les messages transférés. Vous allez ajouter un enregistrement DNS, envoyer un message de test, puis le recevoir avec un webhook et récupérer son contenu complet via l’API.

## Avant de commencer

- Un domaine d’envoi vérifié, comme `acme.com`. La réception ne fonctionne que sur les domaines vérifiés dans votre espace de travail. Consultez [Ajouter un domaine d’envoi](/fr/docs/domains/add-a-domain/).
- Des crédits dans l’espace de travail. Chaque e-mail reçu coûte 1 crédit.

## Fonctionnement des adresses de réception

Emailit reçoit les e-mails sur un sous-domaine de votre domaine d’envoi, `inbound` par défaut. Toute adresse de ce sous-domaine fonctionne : `support@inbound.acme.com` et `reply-4821@inbound.acme.com` arrivent donc dans le même espace de travail. Les enregistrements MX de votre domaine principal, par exemple pour Google Workspace ou Microsoft 365, restent inchangés.

## Ajouter l’enregistrement MX de réception

1. **Ouvrez le domaine.** Accédez à **Email API → Domains** et ouvrez `acme.com`. L’enregistrement MX de `inbound.acme.com` figure avec les autres enregistrements DNS. Il est facultatif : le domaine reste vérifié sans lui.

2. **Ajoutez l’enregistrement chez votre fournisseur DNS.**

   | Type | Nom | Valeur | Priorité |
   | --- | --- | --- | --- |
   | MX | `inbound.acme.com` | `inbound.emailitmail.com` | 10 |

   Certains fournisseurs DNS n’acceptent que `inbound` dans le champ du nom. D’autres demandent le nom complet.

3. **Vérifiez le DNS.** Sélectionnez **Check DNS** sur la page du domaine et attendez que l’enregistrement de réception affiche **OK**. Les modifications DNS prennent généralement quelques minutes, mais peuvent prendre jusqu’à 48 heures.

Pour recevoir sur un autre sous-domaine, comme `replies.acme.com`, définissez `inbound_key` sur `replies` lorsque vous [créez](/fr/docs/api-reference/domains/create/) ou [mettez à jour](/fr/docs/api-reference/domains/update/) le domaine avec l’API, puis publiez l’enregistrement MX pour ce nom. Le tableau de bord affiche le sous-domaine de réception, mais ne permet pas de le modifier.

## Envoyer un e-mail de test

Depuis votre messagerie personnelle, envoyez un e-mail à n’importe quelle adresse du sous-domaine de réception, par exemple `hello@inbound.acme.com`.

Accédez à **Email API → Emails** et ouvrez l’onglet **Incoming**. Le message apparaît avec le statut **received**. Ouvrez-le pour voir l’expéditeur, les en-têtes, le contenu et les éventuelles pièces jointes.

S’il n’arrive pas, vérifiez que l’enregistrement MX affiche **OK** et que le domaine est vérifié. Si l’espace de travail n’a plus de crédits, Emailit refuse le message avec une erreur temporaire, et le serveur de l’expéditeur réessaie plus tard.

## Être notifié par webhook

Pour traiter les e-mails entrants dans votre application, abonnez-vous à l’événement `email.received`.

1. **Créez le webhook.** Accédez à **Email API → Webhooks**, sélectionnez **Add webhook**, puis saisissez un nom et votre endpoint HTTPS, par exemple `https://acme.com/webhooks/emailit`. Copiez le secret du webhook : vous en avez besoin pour vérifier les signatures.

2. **Choisissez l’événement.** Un nouveau webhook reçoit tous les événements. Ouvrez l’onglet **Settings** du webhook et sélectionnez uniquement `email.received`, ou conservez tous les événements et filtrez-les dans votre code.

3. **Envoyez un autre e-mail de test** à `hello@inbound.acme.com`.

Emailit envoie une requête `POST` signée à votre endpoint. Le corps est un tableau JSON, car une requête peut contenir jusqu’à 100 événements :

```json
[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]
```

L’événement contient l’expéditeur, le destinataire et l’objet, mais pas le corps. Vérifiez l’en-tête `X-Emailit-Signature` avant de vous fier à la requête. Consultez [Signature des requêtes](/fr/docs/webhooks/request-signature/).

## Récupérer l’e-mail complet

Utilisez l’`id` de l’événement pour récupérer le message avec une clé API **Full Access** :

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

La réponse contient les en-têtes analysés, le corps texte et HTML, et les pièces jointes :

```json
{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}
```

Pour obtenir plutôt le message d’origine, appelez [`GET /emails/{id}/raw`](/fr/docs/api-reference/emails/raw/). Le contenu des messages est conservé pendant la durée de conservation de votre forfait : récupérez-le donc peu après l’arrivée de l’événement. Consultez [Conservation des données](/fr/docs/data-retention/).

## Tarifs

Chaque e-mail reçu coûte 1 crédit, comme un e-mail envoyé. Consultez [Crédits](/fr/docs/billing/credits/).

## Étapes suivantes

  - [Traiter les e-mails entrants avec des webhooks](/fr/docs/inbound/process-with-webhooks/): Routez les réponses, analysez les pièces jointes et rattachez les fils de discussion.
  - [Transférer avec des automatisations](/fr/docs/inbound/forward-with-automations/): Transférez les e-mails reçus vers une boîte aux lettres, sans code.
  - [Configurer la réception](/fr/docs/inbound/set-up/): Sous-domaines personnalisés et DNS en détail.
  - [email.received](/fr/docs/webhooks/events/email/received/): La référence complète de l’événement.

---
Source: https://emailit.com/fr/docs/quickstart/inbound/