Catégories
Chaque e-mail que vous envoyez possède une catégorie indiquant pourquoi vous l'envoyez, définie avec le champ category sur POST /v1/email/messages. Il prend l'une de deux valeurs, marketing ou transactional, et a un seul effet : il détermine quels enregistrements de suppression et préférences de désinscription peuvent bloquer le message.
Une désinscription à une newsletter dit quelque chose sur les e-mails marketing et rien sur les réinitialisations de mot de passe. La catégorie est ce qui permet de distinguer ces deux intentions.
Les deux catégories
- marketing : e-mails que le destinataire a choisi de recevoir et peut choisir de ne plus recevoir. Campagnes, newsletters, annonces de produits, offres promotionnelles. Tout ce pour quoi "I don't want this anymore" est une réponse que vous devez respecter.
- transactional : e-mails requis par une action du destinataire lui-même. Réinitialisations de mot de passe, vérification d'adresse e-mail, codes à usage unique, confirmations de commande, alertes de sécurité et de compte. Ces messages doivent arriver quelles que soient les préférences marketing du destinataire.
Posez-vous la question : que se passe-t-il si le message n'arrive jamais ? Si un flux initié par le destinataire est interrompu, c'est transactionnel. Si c'est vous qui avez lancé la conversation, c'est marketing.
Ces deux valeurs forment l'ensemble complet : aucune API ne crée ni ne configure de catégorie, et le champ est validé par rapport à ces valeurs. Pour une segmentation plus fine, utilisez les tags en complément de la catégorie.
Comment la catégorie détermine la politique de suppression
Le principe tient en une ligne : marketing est bloqué par chaque motif de suppression et par toute désinscription, tandis que transactional passe malgré une suppression pour plainte ou une désinscription limitée au marketing. Les hard bounces, les suppressions manuelles et une désinscription enregistrée pour tous les messages bloquent les deux.
L'asymétrie découle de ce que chaque motif signifie. Un hard bounce indique que l'adresse n'existe pas, donc envoyer est inutile quelle que soit la catégorie. Une suppression manuelle est la décision de votre propre équipe, que nous ne remettons jamais en question. Les plaintes et les désinscriptions sont des préférences sur le courrier indésirable : elles arrêtent vos envois marketing, tandis qu'un destinataire qui a signalé votre newsletter comme spam reçoit toujours sa réinitialisation de mot de passe. L'exception est elle aussi délibérée : une désinscription peut être enregistrée pour tous les messages plutôt que pour le marketing uniquement (le choix Messages à arrêter dans la boîte de dialogue d'enregistrement de préférence, ou coverage: all sur POST /v1/preferences), et c'est le destinataire qui demande le silence, donc elle bloque aussi les e-mails transactionnels.
Les destinataires bloqués sont rejetés de façon visible, une ligne par destinataire avec le motif associé. Suppressions contient le tableau motif par motif et explique comment les adresses arrivent dans la liste.
La valeur par défaut, et pourquoi les envois transactionnels doivent s'en affranchir
Si vous omettez category, l'envoi est marketing. Ce comportement par défaut joue la sécurité : un e-mail envoyé sans catégorie explicite respecte les désinscriptions et les plaintes et contient un lien de désinscription, donc une campagne est conforme sans effort supplémentaire.
Deux chemins d'envoi tirent leur catégorie d'ailleurs. Un envoi qui utilise un template enregistré et omet category prend la classification du template, donc un template créé en tant que transactional est envoyé comme transactionnel. Définissez category sur l'envoi pour classer un message différemment : la valeur de l'envoi l'emporte. Les e-mails soumis via SMTP tirent leur catégorie de la configuration SMTP de la clé API, qui est transactional pour une clé que vous n'avez pas configurée.
Les e-mails opérationnels doivent donc s'en affranchir. Une réinitialisation de mot de passe envoyée sans catégorie est traitée comme marketing : elle contient un lien de désinscription qu'elle ne devrait pas avoir, et une désinscription à la newsletter la bloque alors même que le destinataire l'a demandée. Définissez category: "transactional" sur les reçus, les réinitialisations, les codes de vérification et les alertes de compte :
Exemple de code
{
"from": "no-reply@yourdomain.com",
"to": ["delivered@messagebird.dev"],
"subject": "Reset your password",
"html": "<p>Click the link below to reset your password...</p>",
"category": "transactional"
}Les catégories comme dimension analytique
La catégorie reste associée au message et réapparaît partout où le message est affiché, ce qui découpe vos statistiques de livraison, de rebond et d'engagement en trafic marketing et opérationnel sans que vous ayez à taguer chaque envoi. La liste de messages filtre par catégorie, les statistiques API ventilent les métriques par catégorie, et le journal e-mail du tableau de bord propose le même filtre.
Étapes suivantes
- Envoyer un e-mail : le payload POST /v1/email/messages complet, y compris category
- Suppressions : la liste de suppression, les trois motifs et la matrice complète des catégories
- Liens de désinscription : les détails de désinscription inclus dans un envoi marketing
- Référence API : schémas complets de requête et de réponse
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet. Les ressources sont en anglais.
Regarder le guideGetting started with emailExplorer la fonctionnalitéEmailSuivre le parcours d'apprentissageBuild your first integrationGuide d'implémentationSend your first email
Essayez la pratique et obtenez un guide d'implémentation