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.

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:

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.

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 audience. Geef de taal op als template.language wanneer je de broadcast aanmaakt of bijwerkt, en laat het weg om de standaardtaal van het 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 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 audience nog iemand heeft om te bereiken. Een audience waar niemand een e-mailadres heeft, of waar 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 kunt versturen in een factureringsperiode. Je abonnement bepaalt het aantal. 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.

Doorzoek de lijst op tag of templatenaam, of filter op status, audience 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.

Een broadcast bevindt zich altijd in een van vier fasen, en het statusfilter op de lijst gebruikt diezelfde vier:

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

Annuleer een ingeplande of verzendende 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.

Een mislukte broadcast toont de reden op de detailpagina: de reden, en vervolgens een zin met de exacte oorzaak. Via de API zijn dat de velden failure_reason en failure_detail. failure_detail vertelt je welke van de mogelijke oorzaken bij een reden je daadwerkelijk hebt geraakt.

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 putten uit hetzelfde e-mailtegoed. De abonnementskaart op het factureringsoverzicht van je organisatie toont hoeveel je ervan hebt gebruikt. Abonnementen en prijzen beschrijft wat elk abonnement omvat.

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.

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.