Categorieën
Elke e-mail die je verstuurt heeft een categorie die aangeeft waarom je hem verstuurt, ingesteld met het category-veld op POST /v1/email/messages. Het veld heeft twee mogelijke waarden, marketing of transactional, en één effect: het bepaalt welke suppressie-records en uitschrijfvoorkeuren het bericht mogen blokkeren.
Een uitschrijving voor een nieuwsbrief zegt iets over marketingmail en niets over wachtwoordresets. De categorie is hoe we die twee intenties uit elkaar houden.
De twee categorieën
- marketing: mail die de ontvanger heeft gekozen om te ontvangen en kan kiezen om niet meer te ontvangen. Campagnes, nieuwsbrieven, productaankondigingen, promotionele aanbiedingen. Alles waarbij "I don't want this anymore" een antwoord is dat je moet respecteren.
- transactional: mail die de eigen actie van de ontvanger vereist. Wachtwoordresets, e-mailverificatie, eenmalige codes, orderbevestigingen, beveiligings- en accountmeldingen. Deze moeten aankomen ongeacht de marketingvoorkeuren van de ontvanger.
Vraag je af wat er gebeurt als het bericht nooit aankomt. Als een flow die de ontvanger is gestart niet meer werkt, is het transactioneel. Als jij het gesprek bent begonnen, is het marketing.
Dit zijn de enige twee: geen API maakt of configureert een categorie, en het veld wordt gevalideerd tegen deze waarden. Voor fijnere segmentatie gebruik je tags naast de categorie.
Hoe de categorie het suppressiebeleid bepaalt
Het contract is één regel: marketing wordt geblokkeerd door elke suppressiereden en door elke opt-out, terwijl transactional door een klachtsuppressie of een opt-out alleen voor marketing heen komt. Hard bounces, handmatige suppressies en een opt-out die is vastgelegd voor alle berichten blokkeren beide.
De asymmetrie volgt uit wat elke reden betekent. Een hard bounce betekent dat het adres niet bestaat, dus verzenden is zinloos ongeacht de categorie. Een handmatige suppressie is de beslissing van je eigen team, waar we nooit aan twijfelen. Klachten en uitschrijvingen zijn voorkeuren over ongewenste mail: ze stoppen je marketing-verzendingen, terwijl een ontvanger die je nieuwsbrief als spam heeft gemeld nog steeds zijn wachtwoordreset krijgt. De uitzondering is ook bewust: een opt-out kan worden vastgelegd voor alle berichten in plaats van alleen marketing (de keuze Te stoppen berichten in het dialoogvenster Voorkeur vastleggen, of coverage: all op POST /v1/preferences), en dat is de ontvanger die om stilte vraagt, dus dat blokkeert ook transactionele mail.
Geblokkeerde ontvangers worden geweigerd op een plek waar je ze kunt zien, één regel per ontvanger met de reden erbij. Suppressies bevat de tabel per reden en beschrijft hoe adressen op de lijst terechtkomen.
De standaard, en waarom transactionele verzendingen moeten afwijken
Laat je category weg, dan is de verzending marketing. Dat faalt in de veilige richting: mail zonder expliciete categorie respecteert uitschrijvingen en klachten en bevat een uitschrijflink, dus een campagne is zonder extra werk conform.
Twee verzendpaden halen hun categorie ergens anders vandaan. Een verzending die een opgeslagen template gebruikt en category weglaat, neemt de classificatie van het template over, dus een template dat als transactional is aangemaakt wordt als transactioneel verstuurd. Stel category in op de verzending om één bericht anders te classificeren, en de waarde van de verzending wint. Mail die via SMTP wordt ingediend, haalt de categorie uit de SMTP-configuratie van de API-key, die transactional is voor een key die je niet hebt geconfigureerd.
Operationele mail moet dus afwijken. Een wachtwoordreset die zonder categorie wordt verstuurd, wordt als marketing behandeld: hij bevat een uitschrijflink die er niet hoort, en een uitschrijving voor de nieuwsbrief blokkeert hem ook al heeft de ontvanger erom gevraagd. Stel category: "transactional" in op bonnen, resets, verificatiecodes en accountmeldingen:
Codevoorbeeld
{
"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"
}Categorieën als analysedimensie
De categorie blijft op het bericht staan en komt terug waar het bericht ook verschijnt, zodat het je bezorg-, bounce- en engagementcijfers opdeelt in marketing- en operationeel verkeer zonder dat je elke verzending hoeft te taggen. De berichtenlijst filtert op categorie, het stats-API splitst metrics ernaar uit, en het e-maillog in het dashboard biedt hetzelfde filter.
Volgende stappen
- E-mail verzenden: de volledige POST /v1/email/messages-payload, inclusief category
- Suppressies: de suppressielijst, de drie redenen en de volledige categoriematrix
- Uitschrijflinks: de opt-outdetails die een marketing-verzending bevat
- API-referentie: volledige request- en responseschema's
Gerelateerde bronnen
Ga verder met de documentatie, gidsen en voorbeelden voor dit onderwerp. De bronnen zijn in het Engels.
Bekijk de gidsGetting started with emailOntdek de mogelijkheidEmailVolg het leerpadBuild your first integrationImplementatiegidsSend your first email
Probeer de oefening en ontvang een implementatieoverzicht