Overzicht van Email

Verstuur transactionele en marketing-e-mail via POST /v1/email/messages. Gebruik een bk_{region}_...-key met de bijbehorende regionale host: https://us1.platform.bird.com of https://eu1.platform.bird.com. Wij ondertekenen het bericht met DKIM, bezorgen het en rapporteren de uitkomst per ontvanger.

Als je eerst iets wilt versturen, brengt de quickstart je van een API-key naar een afgeleverd bericht. Deze pagina behandelt het model dat de rest van deze sectie veronderstelt, en verwijst naar de handleiding voor elk onderdeel.

Een verzending wordt in één aanroep geaccepteerd en asynchroon afgeleverd. POST /v1/email/messages valideert de payload en het verzenddomein en retourneert vervolgens 202 Accepted met een em_ bericht-ID. Lees de uitkomst per ontvanger via webhook-events of de message-endpoints. E-mail verzenden behandelt de payload, veldlimieten en het antwoord.

Twee gevolgen van dat model bepalen de rest van deze sectie.

Eén bericht, meerdere ontvangers, elk een eigen levenscyclus. Een bericht naar vijf adressen levert vijf onafhankelijke uitkomsten op, en de berichtstatus die je terugleest is een aggregaat daarvan. Suppressie wordt op dezelfde manier beoordeeld: één onderdrukt adres komt terug als rejected terwijl de andere vier gewoon worden afgeleverd.

Elk bericht verklaart waarom je het verstuurt. Een categorie van transactional of marketing bepaalt welke suppressies erop van toepassing zijn. Iemand die zich heeft afgemeld voor je nieuwsbrief moet nog steeds een wachtwoordreset ontvangen, en de categorie vertelt ons het verschil.

Een verzending kan ook via een andere route binnenkomen, of later vertrekken. SMTP accepteert inzendingen van alles wat het protocol spreekt, en gepland verzenden houdt een bericht vast tot een tijdstip dat je instelt.

Email is een van de kanalen in de zijbalk van het dashboard. De pagina's, in de volgorde waarin ze verschijnen:

Ontvangers staan buiten de sectie Email, onder Contacts in de zijbalk: All contacts slaat personen op met getypeerde aangepaste eigenschappen (zie Contacten), en Audiences groepeert ze in de herbruikbare lijsten waar een broadcast naartoe stuurt (zie Doelgroepen).

Verzenden. E-mail verzenden is de gids om als eerste te lezen: deze bevat de payload waar elk ander verzendpad een variatie op is. Vandaaruit slaan templates content op die je hergebruikt, voegen bijlagen bestanden toe, dient batchverzending tot 100 berichten in één verzoek in, en stuurt broadcasts één e-mail naar een hele doelgroep.

Domeinen en authenticatie. Verzenddomeinen behandelt het registreren van een domein en de verificatie ervan. DKIM, SPF en DMARC legt uit wat elk record bewijst aan een ontvangende mailboxprovider, en BIMI toont je logo naast je berichten in e-mailapps die dat ondersteunen.

Reputatie. Suppressies is de lijst met adressen waar we niet meer naartoe sturen, automatisch gevuld door hard bounces en klachten; afmeldingen stoppen de bezorging op dezelfde manier, maar via een uitgesproken voorkeur in plaats van een suppressierecord. Dedicated IP's en pools en IP-opwarming behandelen het verzenden vanaf IP-adressen die alleen jouw organisatie gebruikt. E-mailafleverbaarheid verbindt die onderdelen.

Weten wat er is gebeurd. Het e-maillogboek toont één bericht en de tijdlijn per ontvanger. E-mailstatistieken aggregeert je verkeer. Events is het eventvocabulaire en hoe webhooks het naar je eigen endpoint afleveren.

Ontvangen. E-mail ontvangen behandelt beide manieren: een doorstuuradres dat we genereren en geen DNS vereist, of MX-records op een subdomein dat je bezit. Agent-mailboxen bouwt daarop voort met inboxen waar je code zowel vanuit verzendt als uit leest.

Testen. De mail-sandbox test je integratie end-to-end zonder ergens af te leveren. Stuur naar bounce@messagebird.dev om een hard bounce te genereren via de echte event- en webhookpipeline. De test schrijft niets naar je suppressielijst.

Om productie-e-mail van een andere provider te verhuizen, volg je de migratiegids. Deze behandelt requestmapping, DNS, suppressies, webhooks, sandboxtesten en het omschakelen van verkeer.