Présentation d'Email

Envoyez des e-mails transactionnels et marketing via POST /v1/email/messages. Utilisez une clé bk_{region}_... avec son hôte régional correspondant : https://us1.platform.bird.com ou https://eu1.platform.bird.com. Nous signons le message avec DKIM, le distribuons et rapportons le résultat pour chaque destinataire.

Pour envoyer quelque chose avant d'aller plus loin, le quickstart vous guide d'une clé API à un message distribué. Cette page présente le modèle sur lequel le reste de cette section s'appuie, et renvoie au guide de chaque partie.

Un envoi est accepté en un seul appel et livré de manière asynchrone. POST /v1/email/messages valide le payload et le domaine d'envoi, puis renvoie 202 Accepted avec un identifiant de message em_. Consultez le résultat de chaque destinataire via les événements webhook ou les endpoints de message. Envoyer un e-mail couvre le payload, les limites de champs et la réponse.

Deux conséquences de ce modèle structurent le reste de cette section.

Un message, plusieurs destinataires, un cycle de vie chacun. Un message envoyé à cinq adresses produit cinq résultats indépendants, et le statut au niveau du message que vous lisez est un agrégat de ces résultats. La suppression est évaluée de la même manière : une adresse supprimée revient rejected tandis que les quatre autres sont livrées.

Chaque message déclare pourquoi vous l'envoyez. Une catégorie transactional ou marketing détermine quelles suppressions s'y appliquent. Une personne désabonnée de votre newsletter doit toujours recevoir sa réinitialisation de mot de passe, et c'est la catégorie qui nous permet de faire la différence.

Un envoi peut aussi arriver par une autre voie, ou partir plus tard. SMTP accepte les soumissions de tout ce qui parle le protocole, et l'envoi programmé retient un message jusqu'à une heure que vous définissez.

Email est l'un des canaux dans la barre latérale du tableau de bord. Ses pages, dans l'ordre d'apparition :

Les destinataires se trouvent en dehors de la section Email, dans Contacts dans la barre latérale : All contacts stocke les personnes avec des propriétés personnalisées typées (voir Contacts), et Audiences les regroupe dans les listes réutilisables auxquelles un broadcast envoie (voir Audiences).

Envoi. Envoyer un e-mail est le guide à lire en premier : il décrit le payload dont chaque autre chemin d'envoi est une variante. Ensuite, les modèles stockent le contenu que vous réutilisez, les pièces jointes ajoutent des fichiers, l'envoi par lot soumet jusqu'à 100 messages en une seule requête, et les broadcasts envoient un e-mail à une audience entière.

Domaines et authentification. Domaines d'envoi couvre l'enregistrement d'un domaine et sa vérification. DKIM, SPF et DMARC explique ce que chaque enregistrement prouve au fournisseur de messagerie destinataire, et BIMI affiche votre logo à côté de vos messages dans les applications de messagerie qui le prennent en charge.

Réputation. Suppressions est la liste des adresses auxquelles nous cessons d'envoyer, alimentée automatiquement par les hard bounces et les plaintes ; les désinscriptions arrêtent la livraison de la même manière, mais par une préférence déclarée plutôt que par un enregistrement de suppression. IP dédiées et pools et Montée en charge des IP couvrent l'envoi depuis des adresses IP réservées à votre organisation. Délivrabilité e-mail relie l'ensemble.

Savoir ce qui s'est passé. Le journal des e-mails affiche un message et sa chronologie par destinataire. Métriques e-mail agrège votre trafic. Événements est le vocabulaire des événements et la façon dont les webhooks les transmettent à votre propre endpoint.

Réception. Recevoir des e-mails couvre les deux voies d'entrée : une adresse de transfert que nous générons sans configuration DNS, ou des enregistrements MX sur un sous-domaine que vous possédez. Boîtes de réception agent va plus loin avec des boîtes depuis lesquelles votre code envoie et lit.

Tests. Le bac à sable mail exerce votre intégration de bout en bout sans rien livrer. Envoyez à bounce@messagebird.dev pour générer un hard bounce via le pipeline réel d'événements et de webhooks. Le test n'écrit rien dans votre liste de suppressions.

Pour migrer vos e-mails de production depuis un autre fournisseur, suivez le guide de migration. Il couvre le mapping des requêtes, le DNS, les suppressions, les webhooks, les tests en bac à sable et le basculement du trafic.