Configurer la réception des e-mails

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é 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.
• 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. 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.

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, 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 :

   Terminal

   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 :

  Terminal

  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 ou transférez-les avec une automatisation.

Dépannage

Voir aussi