Ajouter un domaine d’envoi

Ce guide vous accompagne dans l’ajout d’un domaine d’envoi, la publication de ses enregistrements DNS et sa vérification. Comptez quelques minutes de travail, plus le temps que met votre fournisseur DNS à publier les enregistrements.

Avant de commencer

• Vous devez avoir accès aux paramètres DNS du domaine, ou connaître quelqu’un qui y a accès. Vous pouvez lui envoyer les enregistrements par e-mail.
• Choisissez le domaine depuis lequel vous allez envoyer. Utiliser un sous-domaine comme mail.acme.com sépare votre réputation d’envoi de celle de votre domaine racine. Consultez Domaine racine ou sous-domaine ?
• Vérifiez que votre forfait permet d’ajouter un domaine de plus. Consultez Limites de domaines.
• Pour l’API, utilisez une clé API Full Access. Les clés d’envoi uniquement ne peuvent pas gérer les domaines.

Règles de nommage des domaines

• Saisissez le domaine nu : acme.com ou mail.acme.com. N’incluez ni http://, ni https://, ni préfixe www..
• Utilisez des lettres, des chiffres, des traits d’union et des points, avec un domaine de premier niveau d’au moins deux lettres. Emailit enregistre le nom en minuscules.
• Les sous-domaines de n’importe quel niveau sont autorisés, par exemple eu.mail.acme.com. Chacun est un domaine distinct avec ses propres enregistrements.
• Un nom ne peut être ajouté qu’une fois par espace de travail. L’ajouter de nouveau renvoie 409 Domain with this name already exists.

Ajouter le domaine

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

{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}

Il n’existe pas d’interrupteur distinct pour les e-mails sortants ou entrants. Un domaine vérifié peut envoyer, et il reçoit les e-mails entrants dès que son enregistrement MX de réception est publié. L’API accepte les indicateurs outgoing et incoming par souci de compatibilité, mais ils ne changent pas le comportement du domaine.

Publier les enregistrements DNS

Ajoutez les enregistrements auprès de l’entreprise qui héberge le DNS de votre domaine. Il s’agit souvent de votre bureau d’enregistrement (GoDaddy, Namecheap) ou d’un service DNS (Cloudflare, Amazon Route 53).

La plupart des fournisseurs DNS n’attendent dans le champ hôte que la partie située avant votre domaine (emailit, et non emailit.acme.com). La page Enregistrements DNS donne les valeurs exactes, des conseils propres à chaque fournisseur et les erreurs fréquentes.

Si votre domaine utilise le DNS de Cloudflare, la page du domaine propose Set up with Cloudflare, qui crée les enregistrements pour vous. Consultez Configurer le DNS avec Cloudflare.

Envoyer les enregistrements à quelqu’un d’autre

Si quelqu’un d’autre gère votre DNS, envoyez-lui les enregistrements par e-mail depuis le tableau de bord.

1. Ouvrez le domaine. Dans Email API›Domains, sélectionnez le domaine.

2. Sélectionnez Send to email. Ce bouton se trouve en haut à droite de la carte DNS Setup.

3. Saisissez son adresse. Dans Recipient Email, tapez l’adresse de votre développeur ou de votre administrateur informatique et sélectionnez Send Instructions.

Cette personne reçoit un e-mail d’Emailit contenant chaque enregistrement et sa valeur. Demandez-lui de vous prévenir quand les enregistrements sont publiés pour que vous puissiez lancer la vérification.

Vérifier le DNS et le domaine

curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Le domaine est vérifié quand SPF, DKIM et le return-path affichent tous OK. DMARC, le suivi et la réception sont facultatifs et n’affectent pas la vérification.

Vérifier le résultat

• Le domaine affiche Verified dans Email API›Domains, et les colonnes SPF, DKIM et Return Path affichent OK.
• Envoyez un message de test depuis une adresse du domaine. Sur la page Emails, sélectionnez Compose, ou appelez Envoyer un e-mail.

Si le domaine affiche Pending verification, il attend un examen manuel. Cela concerne les domaines Pay as you go enregistrés depuis moins de 30 jours. Consultez Vérification des domaines.

Dépannage

La page Vérification des domaines couvre d’autres cas.

Voir aussi