Broadcasts

Een broadcast stuurt één e-mail naar een hele doelgroep: een nieuwsbrief, een aankondiging of elk ander stuk content dat in één keer naar veel ontvangers gaat. De leden van de doelgroep worden omgezet naar de ontvangerlijst op het moment dat de verzending start, dus een broadcast bereikt iedereen die op dat moment lid is van de doelgroep.

Maak broadcasts in Email > Broadcasts in het dashboard, via de broadcasts-API, met bird email broadcasts, of via de MCP-server. De TypeScript-, Python-, Go- en PHP-SDK's bieden een broadcasts-resource voor de volledige levenscyclus: maak een concept, wijzig het zolang het nog een concept is, verstuur het nu of op een later tijdstip, lijst de broadcasts van de werkruimte op, lees er één met de tellers, annuleer er één die gepland of aan het verzenden is, verwijder er één die nog in concept is, en lees de ontvangers, events, aangeklikte links, het verzendtegoed waarop een verzending een beroep doet, en de doelgroepaantallen waartegen een verzending wordt opgelost. Gebruik voor een eenmalige ontvangerslijst batchverzending of enkele verzendingen.

Een concept maken

Begin vanuit de Broadcasts-lijst met New broadcast. De composer is één pagina: een doelgroep- en afzenderbalk bovenaan, de e-mailinhoud eronder en een instellingenknop voor categorie, tracking en tags. Er is geen aparte opslagstap. Elke wijziging wordt automatisch opgeslagen zodra de broadcast een doelgroep en een afzender heeft, dus een concept bestaat zodra die twee zijn ingesteld, en het later verzenden is een aparte, expliciete actie.

Gebruik het veld To om een doelgroep te kiezen, of selecteer New om er een aan te maken zonder de composer te verlaten.

Open de instellingenknop in de header van de composer voor drie extra opties:

• De schakelaars voor open- en kliktracking.
• Maximaal 20 tags, elk een naam en een waarde, om deze broadcast later op te filteren.
• De categorie, die standaard op marketing staat.

Het From-adres

Een broadcast verzendt vanaf een adres op een geverifieerd verzenddomein. Combineer een lokaal deel met een van je geverifieerde domeinen en voeg eventueel een weergavenaam toe. Voeg een Reply-To-adres toe als je antwoorden ergens anders naartoe wilt sturen. Als je Review selecteert, krijg je een waarschuwing als het domein niet geverifieerd is.

De template

Een broadcast verwijst naar een van de e-mailtemplates in je werkruimte, en de template bevat de onderwerpregel en de body die de broadcast verzendt. De contacteigenschappen van elke ontvanger vullen de variabelen van de template in wanneer de verzending wordt uitgevoerd, zodat één broadcast de inhoud per ontvanger personaliseert. Een broadcast kan alleen contacteigenschappen invullen, dus een templatevariabele die naar iets anders verwijst wordt geweigerd bij het verzenden, en de fout noemt de variabele.

Schrijf de inhoud rechtstreeks in het canvas onder de onderwerpregel, of selecteer Choose a template om vanuit een bestaande te beginnen. Die optie is alleen beschikbaar zolang de broadcast leeg is, want het kiezen van een template nadat je al een onderwerp of een body hebt geschreven zou die overschrijven. Een broadcast verzendt de gepubliceerde versie van de template, dus een template die alleen een concept heeft kan geen verzending ondersteunen.

Een template met meer dan één taal stuurt er één daarvan naar de hele doelgroep. Geef de taal op als template.language wanneer je de broadcast aanmaakt of bijwerkt, en laat het weg om de standaardtaal van de template te versturen. Als je alleen de taal wijzigt, blijft de broadcast op de versie waaraan hij is vastgezet zodra hij er een heeft. Een broadcast wordt vastgezet op een versie wanneer hij wordt voorbereid voor verzending, dus een ingeplande broadcast verstuurt de versie die op dat moment gepubliceerd is, ongeacht of je daarvoor nog de taal wijzigt.

Versturen of inplannen

Binnenkort beschikbaar: Het hieronder beschreven wachten op saldo en de knoppen om te hervatten zijn nog niet beschikbaar. Een broadcast waarvoor het saldo opraakt, mislukt met quota_exceeded. Gebruik Get a broadcast om failure_detail te controleren en voeg saldo toe als daar een saldotekort wordt genoemd. Opwaarderen herstart een mislukte broadcast niet; controleer voordat je een nieuwe verzending maakt naar welke ontvangers nog niet is verzonden. Een bericht dat is geaccepteerd voor bezorging maar nog is uitgesteld, geldt al als verzonden; sluit die ontvanger uit van de nieuwe broadcast.

Versturen is een aparte, expliciete actie, beschikbaar via de knop Review in de composer of via de detailpagina van de broadcast met Send or reschedule. Beide openen een dialoogvenster dat controleert of de broadcast compleet is, je waarschuwt voor alles wat de verzending waarschijnlijk laat mislukken, en je vervolgens laat kiezen tussen Send now of een tijdstip tot een jaar vooruit. Een ingeplande broadcast blijft bewerkbaar, en je kunt hem opnieuw inplannen tot het moment dat de verzending daadwerkelijk start.

Bij het versturen wordt gecontroleerd of de doelgroep nog iemand heeft om te bereiken. Een doelgroep waarin niemand een e-mailadres heeft, of waarin elk adres onderdrukt is, wordt op dat moment geweigerd in plaats van later te mislukken.

Er worden twee limieten op organisatieniveau gecontroleerd wanneer je verstuurt.

De eerste is hoeveel broadcasts je in een factureringsperiode kunt versturen, als je abonnement daar een aantal voor vastlegt. Opgeslagen concepten tellen niet mee, en het annuleren van een broadcast geeft het tegoed niet terug. Als je het hebt opgebruikt, wacht je op de volgende factureringsperiode of stap je over naar een abonnement met een hogere limiet.

De tweede beperkt gelijktijdige broadcasts. Als je Send now selecteert terwijl de limiet is bereikt, wordt het verzoek geweigerd. Een ingeplande broadcast wacht op een vrij slot.

Controleer vóór het versturen in het Send-dialoogvenster de geschatte kosten voor de ontvangers die de broadcast kunnen ontvangen en eventuele tegoedwaarschuwingen. Leden met factureringstoegang zien ook het walletsaldo en of automatisch aanvullen is ingeschakeld. De kosten zijn inclusief btw als er een prijs beschikbaar is; prijzen en verbruik kunnen vóór het versturen nog veranderen. Als je abonnement geen schatting voor broadcasts heeft, meldt het dialoogvenster dat in plaats van nul kosten te tonen. Het tegoed is een schatting die je deelt met andere e-mailverzendingen. Als je een broadcast inplant, wordt het saldo ervoor niet gereserveerd, en een andere broadcast kan geld gebruiken voordat deze klaar is.

Als automatisch aanvullen is ingeschakeld, kunnen je bestaande instellingen je opgeslagen betaalmethode meer dan één keer belasten terwijl de broadcast wordt verzonden. Het starten van een broadcast verhoogt je aanvulbedrag niet en autoriseert geen aparte betaling voor de hele doelgroep.

Als het saldo opraakt, toont de broadcast maximaal 20 minuten Waiting for funds, ongeacht of automatisch opwaarderen is ingeschakeld. De broadcast controleert elke minuut of er geld beschikbaar is. Handmatig of automatisch opwaarderen kan het verzenden binnen deze periode hervatten. Een opwaardering waarna je account wegens onvoldoende saldo geblokkeerd blijft, hervat het verzenden niet. Gedeeltelijke opwaarderingen verlengen de huidige wachttijd niet. Zodra het verzenden is hervat, begint bij een latere onderbreking een nieuwe wachttijd van 20 minuten.

Als de wachttijd afloopt voordat het verzenden kan doorgaan, krijgt de broadcast de status Paused en ontvangen de factureringscontactpersonen van je organisatie een e-mail. Controleer het saldo en voeg zo nodig saldo toe. Wachtende broadcasts houden hun slot voor gelijktijdige verzending; gepauzeerde broadcasts geven het vrij.

Open de broadcast en selecteer Resume broadcast. Controleer of de data, aanbiedingen en deadlines erin nog kloppen: de resterende ontvangers krijgen het bericht later dan bedoeld.

Klap in het dialoogvenster Resume broadcast de optie Preview email uit om een opgeslagen template uit de werkruimte te bekijken. Voor de preview heb je email_management:read nodig; vraag een bevoegde collega om de template te controleren als je die toestemming niet hebt. Ingebouwde templates en ontbrekende opgeslagen inhoud kunnen hier niet als preview worden weergegeven. Als de preview niet beschikbaar is, volg dan de templatecontroles hieronder en laat de broadcast gepauzeerd totdat je kunt controleren wat de resterende ontvangers zullen ontvangen. De preview is optioneel en blokkeert het hervatten niet.

Voor een broadcast die minstens 24 uur geleden is gestart, toont de bevestiging de leeftijd in uren en een waarschuwing over late bezorging. Als je saldo toevoegt, wordt een gepauzeerde broadcast niet automatisch hervat.

Om het bericht vóór het hervatten via de API te controleren, haal je de broadcast op en lees je de verwijzingen started_at en de vastgezette template. Haal de template op met template.id; scope: system geeft aan dat het om een ingebouwde template gaat. Als het ophalen van de template 404 teruggeeft, probeer dan de vastgezette versie op ID, want gepubliceerde versies in de werkruimte blijven leesbaar na verwijdering. Voor een template uit de werkruimte haal je die templateversie op met template.id als template_ref en template.version_id als version_id. Controleer het onderwerp en de body in template.language, of in default_language van de versie als er geen taal is gekozen. Voor het lezen van deze inhoud heb je email_management:read nodig; vraag een bevoegde collega om het te controleren als je die rechten niet hebt. Bij ingebouwde templates zie je de huidige inhoud van de catalogus. Broadcasts met vastgezette inhoud behouden die, maar oudere broadcasts kunnen bij het hervatten de catalogus opnieuw lezen. Een actuele opvraging of een eerder bericht bewijst op zichzelf niet wat de resterende ontvangers krijgen. Laat de broadcast gepauzeerd, tenzij je die inhoud kunt verifiëren.

De resume-API en de SDK's vereisen confirm: true voor een broadcast van die leeftijd. Controleer met de CLI eerst de broadcast en geef daarna --yes mee aan bird email broadcasts resume om de late bezorging te bevestigen. Zonder die flag geeft de CLI een waarschuwing terug en vraagt niet interactief om bevestiging. De resume-tool van de MCP gebruikt ook confirm: true; vraag degene die om de verzending vraagt te bevestigen dat het bericht nog actueel is.

Programmatische aanroepers kunnen altijd confirm: true meegeven, ook vóór de grens van 24 uur, als hun applicatie al heeft besloten de bezorging voort te zetten. De controles op saldo, verzendtegoed, rechten en gelijktijdige broadcasts worden hiermee niet overgeslagen.

Bij het hervatten blijven de opgeslagen templateverwijzingen en de ontvangerslijst behouden. Ontvangers aan wie het bericht al is verzonden, krijgen het niet opnieuw. Actuele suppressies en toestemmingsvoorkeuren gelden volgens de categorie van de broadcast: afmeldingen voor marketing blokkeren geen transactionele broadcasts. Hervatten verbruikt geen extra broadcast uit je maandelijkse tegoed. Je account mag niet meer geblokkeerd zijn wegens onvoldoende saldo, je verzendtegoed moet de volgende batch dekken en er moet een slot voor gelijktijdige verzending vrij zijn. Als een dagelijkse of maandelijkse verzendlimiet de batch nog blokkeert, geeft hervatten 429 terug en blijft de broadcast gepauzeerd. Probeer dezelfde broadcast opnieuw nadat het tegoed is hersteld of de limiet is gewijzigd. Een werkruimte die op dat moment is opgeschort, geeft 403 terug met E08024. Ook na heractivering kan een broadcast die vóór de opschorting is geautoriseerd niet worden hervat: de API geeft 403 terug met E04102. Annuleer die broadcast in plaats van het opnieuw te proberen. Verstuur niet opnieuw naar de hele doelgroep zonder de ontvangers uit te sluiten aan wie het bericht al is verzonden. Hervatten reserveert geen saldo en garandeert niet dat alle resterende berichten kunnen worden verzonden. Als het saldo na een expliciete hervatting opraakt, begint een nieuwe wachttijd van 20 minuten. Je kunt de broadcast ook annuleren als het bericht niet meer relevant is.

Een broadcast zoeken

Doorzoek de lijst op tag of templatenaam, of filter op status, doelgroep of een datumbereik. Het datumbereik filtert op het moment waarop elke broadcast is aangemaakt, niet op het moment van verzending, dus een broadcast die je vorige week hebt ingepland voor verzending volgende maand verschijnt nog steeds onder "Last 7 days."

Exporteer de huidige weergave als CSV via de knop boven de tabel, of roep Broadcasts exporteren als CSV aan, die dezelfde filters accepteert. Boven de 50.000 rijen wordt de export geweigerd in plaats van stilzwijgend afgekapt. Versmal de filters en probeer het opnieuw.

Broadcaststatus

Binnenkort beschikbaar: De statussen waiting_for_funds en paused hieronder zijn nog niet beschikbaar. Een broadcast waarvoor het saldo opraakt, mislukt en wordt na het opwaarderen niet hervat.

De fase van een broadcast verschijnt in het statusfilter:

De badge op elke rij toont de exacte status binnen de fase. Diezelfde waarde is wat het status-veld van de API teruggeeft.

Annuleren of verwijderen

Annuleer een ingeplande, verzendende, wachtende of gepauzeerde broadcast vanaf de detailpagina, met bird email broadcasts cancel, of met Een broadcast annuleren en de broadcasts.cancel SDK-methode. Ontvangers die nog niet zijn bereikt worden overgeslagen, en een bericht dat al onderweg is kan niet worden teruggehaald. Verwijderen werkt alleen op een concept en is permanent, via dezelfde drie routes: de detailpagina, bird email broadcasts delete, of Een broadcast verwijderen.

Wanneer een broadcast mislukt

Het dashboard legt uit waarom de broadcast is mislukt en wat je daarna moet controleren. Bij quota_exceeded toont het de vastgelegde reden en uitleg over verzendlimieten en saldo. Je kunt ook Get a broadcast gebruiken en failure_reason en failure_detail lezen.

De verzendinstellingen van een broadcast worden pas gecontroleerd wanneer de verzending start. Als het verzenddomein geverifieerd was bij het inplannen maar de verificatie verloor vóór de verzending, mislukt de broadcast op dat moment. Verifieer het domein en verstuur de broadcast opnieuw.

Broadcasts en enkele verzendingen delen het e-mailtegoed van de organisatie. Als je saldo toevoegt, wordt een mislukte broadcast niet opnieuw gestart. Controleer naar welke ontvangers niet is verzonden voordat je een nieuwe broadcast maakt. Sluit ontvangers uit van wie de berichten voor bezorging zijn geaccepteerd, ook als de ontvangende server die berichten nog uitstelt. Het wacht- en pauzegedrag is binnenkort beschikbaar. Harde verzendlimieten en betalingsbeperkingen blijven gelden. Abonnementen en prijzen beschrijft wat elk abonnement omvat.

Bezorging volgen

Zodra de verzending start, toont het tabblad Overview van de broadcast het aantal ontvangers en verzonden berichten, gevolgd door de bezorg-, open-, klik-, bounce- en klachtpercentages met hun aantallen. Het tabblad Recipients toont elke ontvanger met de bezorgstatus, de reden als het bericht niet is bezorgd, het moment van bezorging, en de opens en kliks. Het zoekvak vereist een volledig, geldig e-mailadres; een gedeeltelijk adres of een domein slaagt niet voor de validatie, markeert het vak als ongeldig en laat de tabel tonen wat er eerder stond. Een knop boven de tabel exporteert het tabblad als CSV, en De ontvangers van een broadcast exporteren als CSV retourneert hetzelfde bestand naar een API-key; beide zijn begrensd op 500.000 rijen met hetzelfde weigeren-in-plaats-van-afkappen als de export van de broadcastlijst. Het tabblad Events is de onbewerkte eventfeed van de broadcast, met de eventtypen beschreven in events en webhooks.

Een broadcast oefenen

Plaats een sandbox-adres in de audience en dat contact wordt gesimuleerd in plaats van daadwerkelijk verzonden: delivered@messagebird.dev rapporteert bezorgd, bounce@messagebird.dev bounces, en elk produceert dezelfde events en webhooks als een echte ontvanger. Zo test je een campagne, en de handler die de events leest, zonder iemand te mailen. Een audience kan sandbox- en echte contacten combineren; elk contact krijgt zijn eigen resultaat. Een gesimuleerde ontvanger telt nog steeds mee voor je verzendtegoed, dus de oefening gebruikt hetzelfde quotum als de echte verzending.

Volgende stappen

• Audiences: de ontvangerslijsten waarnaar een broadcast verstuurt
• E-mailtemplates: het onderwerp en de body waarnaar een broadcast verwijst
• E-mailstatistieken: het werkruimtebrede overzicht waar broadcasts in terechtkomen
• bird email broadcasts: één CLI-commando per broadcastoperatie
• Een broadcast aanmaken: de API-referentie, met volledige request- en responseschema's en een codevoorbeeld per SDK
• E-mailbroadcasts: één e-mail naar je hele publiek: een video die een broadcast verstuurt en de resultaten toont