Aller au contenu
Esc
↑↓naviguer↵ouvrir⌘Japerçu
Sur cette page

Domaines

Vérifiez un domaine d'envoi, ajoutez ses enregistrements DNS et configurez-le pour le suivi, la réception et le préchauffage.

Chaque e-mail doit être envoyé depuis un domaine que votre équipe a vérifié. Toute autre adresse from est refusée avec 422. Ajoutez et vérifiez vos domaines dans le tableau de bord, sous Domaines, ou avec l’API.

Ajouter et vérifier un domaine

curl -X POST https://api.billionsend.com/domains \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.example.com" }'

La réponse liste les enregistrements DNS à ajouter chez votre fournisseur DNS. Un sous-domaine comme mail.example.com est un bon choix de domaine d’envoi. Une fois les enregistrements en ligne, cliquez sur Vérifier sur la page du domaine ou appelez POST /domains/{id}/verify.

Enregistrement Rôle
DKIM (deux CNAME, bs1._domainkey et bs2._domainkey) Signe vos e-mails pour que les fournisseurs sachent qu’ils viennent de vous.
MAIL FROM (MX et TXT) Une adresse de rebond sur votre propre domaine, pour que SPF soit aligné.
DMARC (TXT, recommandé) Indique aux fournisseurs quoi faire des e-mails qui échouent aux vérifications. Il ne bloque pas l’envoi.

DKIM et MAIL FROM doivent être vérifiés avant de pouvoir envoyer. Sur Cloudflare, laissez ces enregistrements en DNS uniquement (nuage gris).

La page du domaine affiche chaque enregistrement comme trouvé, manquant ou non conforme, vérifié en direct sur le DNS public. GET /domains/{id} renvoie la même chose dans records[]. Chaque enregistrement a un status (not_started, pending, verified ou failed), une valeur live pour ce que le DNS public répond à l’instant, et un court detail quand quelque chose ne va pas.

Les clés DKIM sont renouvelées automatiquement

BillionSend crée une clé DKIM pour chaque domaine et la remplace tous les 180 jours, en alternant entre les deux CNAME. Vous ajoutez les enregistrements une fois et n’y touchez plus. Vous pouvez désactiver la rotation automatique dans l’onglet Paramètres du domaine.

Région

POST /domains accepte un region facultatif. Un domaine vit dans une seule région. Pour le déplacer, supprimez-le et ajoutez-le de nouveau dans l’autre région ; ses enregistrements DNS changent.

Limites du forfait

Free Starter Pro et Scale
Domaines d’envoi par équipe 3 10 Illimité

Au-delà de la limite, POST /domains répond 403 plan_limit_reached. Un nom de domaine qu’une autre équipe possède déjà répond 409.

Préchauffage d’un nouveau domaine

Un domaine récemment enregistré envoie à un volume quotidien limité pendant qu’il se construit une réputation. Le plafond dépend de l’âge du domaine enregistré (example.com pour mail.example.com) et se compte par jour UTC :

Âge du domaine E-mails par jour
Moins de 1 jour 100
1 jour à moins de 7 jours 300
7 jours à moins de 30 jours 2 000
30 jours ou plus Uniquement la limite de votre forfait
  • Un domaine qui envoie proprement, avec peu de rebonds et aucune plainte, passe plus tôt à l’étape suivante.
  • Le plafond s’applique en plus de votre forfait. Passer à un forfait supérieur ne le lève pas.
  • Vos nouveaux domaines partagent un seul volume quotidien : ajouter un autre nouveau domaine n’ajoute pas de volume.
  • Les e-mails au-delà du plafond ne sont pas perdus. Ils apparaissent comme En attente et partent le lendemain, les plus anciens d’abord. Si beaucoup d’e-mails attendent déjà, un envoi répond 429 daily_quota_exceeded ; réessayez après le changement de jour UTC.

La page du domaine affiche « Préchauffage : N/jour aujourd’hui » tant qu’un plafond s’applique. Voir Limites d’envoi pour toutes les protections de l’envoi.

Paramètres

Une fois un domaine vérifié, ces paramètres sont disponibles :

  • Suivi des ouvertures et des clics. Les deux sont désactivés par défaut. Activez-les dans l’onglet Liens du domaine, ou avec open_tracking et click_tracking sur PATCH /domains/{id}. Voir Suivi.
  • Sous-domaines propres de suivi et de désinscription. Servez les liens suivis et les liens de désinscription depuis votre propre domaine. Un forfait payant est requis. Voir Suivi.
  • Page de désinscription. L’apparence de la page que voient vos destinataires : nom, logo, couleurs et textes. Définissez-la dans l’onglet Marque du domaine, ou avec unsubscribe_page sur PATCH /domains/{id}. Voir Désinscriptions.
  • TLS obligatoire. Ne livrer qu’aux serveurs qui prennent en charge TLS. Définissez-le dans l’onglet Paramètres.
  • Nom d’expéditeur, adresse d’expéditeur et reply-to par défaut. Définissez-les dans l’onglet Paramètres.

Réception

Un domaine vérifié peut aussi recevoir des e-mails. Activez la réception avec Activer la réception sur la page du domaine, ou avec PATCH /domains/{id} :

{ "capabilities": { "receiving": "enabled" } }
  • Seul un domaine vérifié peut activer la réception. POST /domains avec "receiving": "enabled" répond 422 : ajoutez le domaine, vérifiez-le, puis activez la réception.
  • L’activer ajoute deux enregistrements Receiving : des enregistrements MX qui pointent vers mx1.billionsend-dns.com et mx2.billionsend-dns.com, tous deux avec la priorité 10. Publiez les deux, pour qu’un expéditeur qui trouve l’un hors service réessaie sur l’autre. Ils n’affectent pas l’envoi. Si le domaine reçoit déjà des e-mails ailleurs, placez les enregistrements MX sur un sous-domaine comme inbound.example.com, car un enregistrement MX de numéro inférieur prendrait les e-mails à sa place.
  • Un nom ne peut recevoir que dans une seule équipe. Un nom sur lequel une autre équipe reçoit déjà répond 409.
  • Par défaut, seules les adresses de vos boîtes de réception reçoivent des e-mails. Catch-all accepte toutes les adresses du domaine. Il exige un forfait payant et se règle dans le tableau de bord ou avec receiving_catch_all sur PATCH /domains/{id}.

Sous-domaine partagé

Chaque équipe reçoit aussi un sous-domaine sur un domaine partagé de BillionSend, où ses boîtes de réception partagées obtiennent leurs adresses. Il apparaît à la fin de GET /domains avec shared: true. Il est déjà vérifié et en lecture seule : PATCH, la vérification et DELETE répondent 403 forbidden, et il ne compte pas dans votre limite de domaines. Il ne peut envoyer que depuis les adresses propres de vos boîtes de réception.

Supprimer un domaine

DELETE /domains/{id}, ou Supprimer sur la page du domaine, est refusé avec 409 dans deux cas :

  • Une thématique ou un segment est lié au domaine. Supprimez-le, ou mettez son domain_id à null.
  • Une campagne programmée ou en cours d’envoi utilise le domaine. Annulez-la, ou attendez qu’elle soit partie.

Supprimer un domaine supprime aussi ses boîtes de réception. Les désinscriptions des destinataires de ce domaine sont conservées, et s’appliquent de nouveau si vous rajoutez le même nom.

Clés API et domaines

Une clé API peut être limitée à un seul domaine. Une telle clé ne peut envoyer que depuis ce domaine, et tout autre from répond 403 restricted_api_key. Elle ne lit que les e-mails reçus sur ce domaine, ne voit et ne modifie que ce domaine sous /domains (tout autre domaine répond 404), et les clés qu’elle crée sont limitées au même domaine. Les webhooks, les suppressions, les templates et le reste de ce qui appartient à toute l’équipe répondent 403 restricted_api_key ; la page Clés API les liste. Une clé peut aussi être limitée à une seule boîte de réception.

Cette page vous a-t-elle été utile ?