Broadcasts

Ein Broadcast sendet eine einzelne E-Mail an eine gesamte Audience: einen Newsletter, eine Ankündigung oder jeden anderen einzelnen Inhalt, der gleichzeitig an viele Empfänger geht. Wir lösen die Mitglieder der Audience beim Start des Versands in die Empfängerliste auf, sodass ein Broadcast alle erreicht, die zu diesem Zeitpunkt Mitglied der Audience sind.

Erstellen Sie Broadcasts im Dashboard unter Email > Broadcasts, über die Broadcasts-API, mit bird email broadcasts oder über den MCP-Server. Die SDKs für TypeScript, Python, Go und PHP stellen eine broadcasts-Ressource für den gesamten Lebenszyklus bereit: einen Entwurf erstellen, ihn noch im Entwurfsstatus ändern, ihn sofort oder später senden, die Broadcasts des Workspaces auflisten, einen Broadcast mit seinen Zählern abrufen, einen geplanten oder laufenden Versand abbrechen, einen Entwurf löschen sowie Empfänger, Ereignisse, angeklickte Links, das für einen Versand benötigte Sendekontingent und die beim Versand berücksichtigten Zielgruppenzahlen abrufen. Für eine einmalige Empfängerliste nutzen Sie den Batch-Versand oder Einzelversand.

Entwurf erstellen

Starten Sie in der Broadcasts-Liste mit New broadcast. Der Composer ist eine einzelne Seite: oben eine Leiste für Audience und Absender, darunter der E-Mail-Inhalt und ein Einstellungs-Steuerelement für Kategorie, Tracking und Tags. Es gibt keinen separaten Speicherschritt. Jede Änderung wird automatisch gespeichert, sobald der Broadcast eine Audience und einen Absender hat. Ein Entwurf existiert also, sobald diese beiden gesetzt sind, und das Senden ist eine separate, explizite Aktion.

Verwenden Sie das Feld To, um eine Audience auszuwählen, oder wählen Sie New, um eine neue zu erstellen, ohne den Composer zu verlassen.

Öffnen Sie das Einstellungs-Steuerelement im Header des Composers für drei weitere Optionen:

• Die Schalter für Öffnungs- und Klick-Tracking.
• Bis zu 20 Tags, jeweils ein Name und ein Wert, um diesen Broadcast später zu filtern.
• Die Kategorie, die standardmäßig auf marketing gesetzt ist.

Die Absenderadresse

Ein Broadcast wird von einer Adresse auf einer verifizierten Sendedomain gesendet. Kombinieren Sie einen lokalen Teil mit einer Ihrer verifizierten Domains und fügen Sie optional einen Anzeigenamen hinzu. Fügen Sie eine Reply-To-Adresse hinzu, wenn Antworten woanders hingeleitet werden sollen. Review warnt Sie, wenn die Domain nicht verifiziert ist.

Das Template

Ein Broadcast verweist auf eines der E-Mail-Templates Ihres Workspace, und das Template enthält die Betreffzeile und den Body, den der Broadcast sendet. Die Kontakteigenschaften jedes Empfängers füllen die Variablen des Templates beim Senden aus, sodass ein Broadcast seinen Inhalt pro Empfänger personalisiert. Ein Broadcast kann nur Kontakteigenschaften einsetzen. Eine Template-Variable, die auf etwas anderes verweist, wird beim Senden abgelehnt, und die Fehlermeldung benennt die Variable.

Schreiben Sie den Inhalt direkt in der Canvas unterhalb der Betreffzeile, oder wählen Sie Choose a template, um mit einem vorhandenen Template zu beginnen. Diese Option ist nur verfügbar, solange der Broadcast leer ist, da die Auswahl eines Templates einen bereits geschriebenen Betreff oder Body überschreiben würde. Ein Broadcast sendet die veröffentlichte Version des Templates, daher kann ein Template, das nur einen Entwurf hat, keinen Versand stützen.

Ein Template mit mehreren Sprachen sendet eine davon an die gesamte Audience. Geben Sie die Sprache beim Erstellen oder Aktualisieren des Broadcasts als template.language an, oder lassen Sie sie weg, um die Standardsprache des Templates zu senden. Wenn Sie nur die Sprache ändern, bleibt der Broadcast auf der Version, auf die er festgelegt ist, sobald er eine hat. Ein Broadcast wird auf eine Version festgelegt, wenn er für den Versand vorbereitet wird. Ein geplanter Broadcast sendet also die Version, die zu diesem Zeitpunkt veröffentlicht ist, unabhängig davon, ob Sie vorher die Sprache ändern.

Senden oder planen

Demnächst verfügbar: Das unten beschriebene Warten auf Guthaben und die Steuerelemente zum Fortsetzen sind noch nicht verfügbar. Geht einem Broadcast das Guthaben aus, schlägt er derzeit mit quota_exceeded fehl. Prüfen Sie mit Get a broadcast das Feld failure_detail und laden Sie Guthaben auf, wenn dort ein unzureichendes Guthaben genannt wird. Eine Aufladung startet einen fehlgeschlagenen Broadcast nicht erneut; prüfen Sie vor einem neuen Versand, an welche Empfänger nicht gesendet wurde. Eine Nachricht, die zur Zustellung angenommen, aber noch zurückgestellt ist, gilt bereits als gesendet; schließen Sie diesen Empfänger vom neuen Broadcast aus.

Der Versand ist eine separate, explizite Aktion, verfügbar über die Review-Schaltfläche im Composer oder über die Detailseite des Broadcasts unter Send or reschedule. Beide öffnen einen Dialog, der prüft, ob der Broadcast vollständig ist, Sie vor möglichen Fehlerquellen warnt und Ihnen die Wahl zwischen Send now oder einem Zeitpunkt bis zu einem Jahr in der Zukunft lässt. Ein geplanter Broadcast bleibt bearbeitbar, und Sie können ihn bis unmittelbar vor dem tatsächlichen Versandstart umplanen.

Beim Senden wird geprüft, ob die Audience noch erreichbare Empfänger enthält. Eine Audience, in der niemand eine E-Mail-Adresse hat oder in der jede Adresse unterdrückt ist, wird an dieser Stelle abgelehnt, anstatt später fehlzuschlagen.

Beim Senden werden zwei Limits auf Organisationsebene geprüft.

Das erste begrenzt, wie viele Broadcasts Sie in einem Abrechnungszeitraum senden können, sofern Ihr Plan eine Anzahl festlegt. Gespeicherte Entwürfe zählen nicht dazu, und das Abbrechen eines Broadcasts gibt das Kontingent nicht zurück. Wenn Sie es aufgebraucht haben, warten Sie entweder auf den nächsten Abrechnungszeitraum oder wechseln zu einem Plan mit einem höheren Limit.

Das zweite begrenzt gleichzeitige Broadcasts. Wenn Sie Send now wählen, während das Limit erreicht ist, wird die Anfrage abgelehnt. Ein geplanter Broadcast wartet auf einen freien Platz.

Prüfen Sie vor dem Senden im Send-Dialog die geschätzten Kosten für die Empfänger, die den Broadcast erhalten können, sowie einen etwaigen Hinweis zum Kontingent. Mitglieder mit Abrechnungszugriff sehen außerdem das Wallet-Guthaben und ob die automatische Aufladung aktiviert ist. Die Kosten enthalten Steuern, wenn ein Preis verfügbar ist; Preise und Nutzung können sich vor dem Versand ändern. Bietet Ihr Plan keine Schätzung für Broadcasts, weist der Dialog darauf hin, statt Kosten von null anzuzeigen. Das Kontingent ist eine Schätzung, die Sie mit anderen E-Mail-Versänden teilen. Das Planen eines Broadcasts reserviert kein Guthaben, und ein anderer Broadcast kann Guthaben verbrauchen, bevor dieser abgeschlossen ist.

Wenn die automatische Aufladung aktiviert ist, können Ihre bestehenden Einstellungen Ihre gespeicherte Zahlungsmethode während des Versands mehrmals belasten. Der Start eines Broadcasts erhöht Ihren Aufladebetrag nicht und autorisiert keine separate Zahlung für die gesamte Audience.

Wenn das Guthaben aufgebraucht ist, zeigt der Broadcast bis zu 20 Minuten lang Waiting for funds an, unabhängig davon, ob die automatische Aufladung aktiviert ist. Er prüft einmal pro Minute, ob Guthaben verfügbar ist. Eine manuelle oder automatische Aufladung kann den Versand innerhalb dieses Zeitfensters wieder starten. Bleibt Ihr Konto nach einer Aufladung wegen unzureichenden Guthabens gesperrt, wird der Versand nicht wieder gestartet. Teilweise Aufladungen verlängern die aktuelle Wartezeit nicht. Sobald der Versand fortgesetzt wurde, beginnt bei einer späteren Unterbrechung eine neue Wartezeit von 20 Minuten.

Endet die Wartezeit, bevor der Versand fortgesetzt werden kann, wechselt der Broadcast zu Paused, und die Abrechnungskontakte Ihrer Organisation erhalten eine E-Mail. Prüfen Sie das Guthaben und laden Sie bei Bedarf auf. Wartende Broadcasts behalten ihren Platz für gleichzeitigen Versand; pausierte Broadcasts geben ihn frei.

Öffnen Sie den Broadcast und wählen Sie Resume broadcast. Prüfen Sie, ob Daten, Angebote und Fristen darin noch gültig sind, denn die verbleibenden Empfänger erhalten die Nachricht später als geplant.

Klappen Sie im Dialog Resume broadcast den Bereich Preview email auf, um ein gespeichertes Workspace-Template zu prüfen. Für die Vorschau benötigen Sie email_management:read; fehlt Ihnen diese Berechtigung, bitten Sie ein berechtigtes Teammitglied um die Prüfung. Integrierte Templates und fehlende gespeicherte Inhalte können hier nicht als Vorschau angezeigt werden. Ist die Vorschau nicht verfügbar, folgen Sie den Prüfungen für Templates weiter unten und lassen Sie den Broadcast pausiert, solange Sie nicht prüfen können, was die verbleibenden Empfänger erhalten werden. Die Vorschau ist optional und verhindert das Fortsetzen nicht.

Bei einem Broadcast, der vor mindestens 24 Stunden gestartet wurde, zeigt die Bestätigung sein Alter in Stunden und eine Warnung vor verspäteter Zustellung. Das Hinzufügen von Guthaben setzt einen pausierten Broadcast nicht automatisch fort.

Um die Nachricht vor dem Fortsetzen über die API zu prüfen, rufen Sie den Broadcast ab und lesen Sie seine Referenzen started_at und das festgelegte template. Rufen Sie das Template ab und verwenden Sie dabei template.id; scope: system kennzeichnet ein integriertes Template. Gibt der Abruf des Templates 404 zurück, rufen Sie die festgelegte Version über ihre ID ab, denn veröffentlichte Workspace-Versionen bleiben auch nach dem Löschen lesbar. Bei einem Workspace-Template rufen Sie diese Template-Version ab, mit template.id als template_ref und template.version_id als version_id. Prüfen Sie Betreff und Body in template.language oder in default_language der Version, wenn keine Sprache ausgewählt wurde. Zum Lesen dieses Inhalts benötigen Sie email_management:read; fehlt Ihnen diese Berechtigung, bitten Sie ein berechtigtes Teammitglied um die Prüfung. Abrufe integrierter Templates zeigen den aktuellen Inhalt des Katalogs. Broadcasts mit eingefrorenem Inhalt behalten diesen, ältere Broadcasts können beim Fortsetzen jedoch erneut den Katalog lesen. Weder ein aktueller Abruf noch eine frühere Nachricht allein belegt, was die verbleibenden Empfänger erhalten. Lassen Sie den Broadcast pausiert, solange Sie diesen Inhalt nicht prüfen können.

Die Resume-API und die SDKs verlangen für einen so alten Broadcast confirm: true. Prüfen Sie mit der CLI zuerst den Broadcast und übergeben Sie dann --yes an bird email broadcasts resume, um die verspätete Zustellung zu bestätigen. Ohne dieses Flag gibt die CLI eine Warnung zurück und fragt nicht interaktiv nach. Das Resume-Tool von MCP verwendet ebenfalls confirm: true; bitten Sie die Person, die den Versand anfordert, zu bestätigen, dass die Nachricht noch aktuell ist.

Programmatische Aufrufer können confirm: true jederzeit übergeben, auch vor Ablauf der 24 Stunden, wenn ihre Anwendung bereits entschieden hat, die Zustellung fortzusetzen. Die Prüfungen von Guthaben, Sendekontingent, Berechtigungen und gleichzeitigen Broadcasts entfallen dadurch nicht.

Beim Fortsetzen bleiben die gespeicherten Template-Referenzen und die Empfängerliste erhalten. Empfänger, an die die Nachricht bereits gesendet wurde, erhalten sie nicht erneut. Aktuelle Unterdrückungen und Einwilligungseinstellungen gelten entsprechend der Broadcast-Kategorie: Abmeldungen von Marketing-Nachrichten blockieren keine transaktionalen Broadcasts. Das Fortsetzen verbraucht keinen weiteren Broadcast aus Ihrem monatlichen Kontingent. Ihr Konto darf nicht mehr wegen unzureichenden Guthabens gesperrt sein, sein Sendekontingent muss den nächsten Batch abdecken, und ein Platz für einen gleichzeitig laufenden Versand muss frei sein. Blockiert ein tägliches oder monatliches Sendelimit den Batch weiterhin, gibt das Fortsetzen 429 zurück, und der Broadcast bleibt pausiert. Versuchen Sie denselben Broadcast erneut, nachdem das Kontingent zurückgesetzt wurde oder sich sein Limit geändert hat. Ein derzeit gesperrter Workspace gibt 403 mit E08024 zurück. Auch nach der Reaktivierung kann ein Broadcast, der vor der Sperrung autorisiert wurde, nicht fortgesetzt werden: Die API gibt 403 mit E04102 zurück. Brechen Sie diesen Broadcast ab, statt es erneut zu versuchen. Senden Sie nicht erneut an die gesamte Audience, ohne die Empfänger auszuschließen, an die die Nachricht bereits gesendet wurde. Beim Fortsetzen wird kein Guthaben reserviert. Es ist nicht garantiert, dass alle verbleibenden Nachrichten gesendet werden können. Wenn das Guthaben nach einem ausdrücklichen Fortsetzen aufgebraucht ist, beginnt eine neue Wartezeit von 20 Minuten. Sie können den Broadcast stattdessen abbrechen, wenn seine Nachricht nicht mehr sinnvoll ist.

Einen Broadcast finden

Durchsuchen Sie die Liste nach Tag oder Template-Name, oder filtern Sie nach Status, Audience oder einem Datumsbereich. Der Datumsbereich filtert nach dem Erstellungsdatum jedes Broadcasts, nicht nach dem Sendezeitpunkt. Ein Broadcast, den Sie letzte Woche für einen Versand nächsten Monat geplant haben, erscheint also weiterhin unter "Last 7 days."

Exportieren Sie die aktuelle Ansicht als CSV über die Schaltfläche oberhalb der Tabelle, oder rufen Sie Broadcasts als CSV exportieren auf, das die gleichen Filter akzeptiert. Bei mehr als 50.000 Zeilen wird der Export abgelehnt, anstatt stillschweigend abgeschnitten zu werden. Schränken Sie die Filter ein und versuchen Sie es erneut.

Broadcast-Status

Demnächst verfügbar: Die unten aufgeführten Status waiting_for_funds und paused sind noch nicht verfügbar. Geht einem Broadcast das Guthaben aus, schlägt er derzeit fehl und wird nach einer Aufladung nicht fortgesetzt.

Die Phase eines Broadcasts erscheint im Statusfilter:

Das Badge jeder Zeile zeigt den genauen Status innerhalb der Phase. Denselben Wert gibt das Feld status der API zurück.

Abbrechen oder löschen

Brechen Sie einen geplanten, laufenden, wartenden oder pausierten Broadcast über seine Detailseite ab, mit bird email broadcasts cancel oder mit Broadcast abbrechen und der broadcasts.cancel-Methode SDK. Empfänger, die noch nicht erreicht wurden, werden übersprungen, und bereits unterwegs befindliche Nachrichten können nicht zurückgerufen werden. Löschen funktioniert nur bei Entwürfen und ist dauerhaft, über dieselben drei Wege: die Detailseite, bird email broadcasts delete oder Broadcast löschen.

Wenn ein Broadcast fehlschlägt

Das Dashboard erklärt den Fehler und was Sie als Nächstes prüfen sollten. Bei quota_exceeded zeigt es den erfassten Grund sowie Hinweise zu Sendelimits und Guthaben. Sie können auch Get a broadcast verwenden und failure_reason und failure_detail lesen.

Die Versandkonfiguration eines Broadcasts wird erst beim Versandstart geprüft. Wenn die Sendedomain bei der Planung verifiziert war, aber vor dem Versand die Verifizierung verloren hat, schlägt der Broadcast an dieser Stelle fehl. Verifizieren Sie die Domain und senden Sie den Broadcast erneut.

Broadcasts und Einzelversand teilen sich das E-Mail-Kontingent der Organisation. Das Aufladen von Guthaben startet einen fehlgeschlagenen Broadcast nicht erneut. Prüfen Sie, an welche Empfänger nicht gesendet wurde, bevor Sie einen weiteren Broadcast erstellen. Schließen Sie Empfänger aus, deren Nachrichten zur Zustellung angenommen wurden, auch wenn der empfangende Server sie noch zurückstellt. Das Warte- und Pausenverhalten ist demnächst verfügbar. Feste Versandlimits und Zahlungsbeschränkungen gelten weiterhin. Pläne und Preise beschreibt, was jeder Plan enthält.

Zustellung verfolgen

Sobald der Versand beginnt, zeigt der Overview-Tab des Broadcasts die Empfänger- und Versandzahlen, dann die Zustellungs-, Öffnungs-, Klick-, Bounce- und Beschwerderaten mit ihren Zählern. Der Recipients-Tab listet jeden Empfänger mit seinem Zustellstatus, dem Grund bei Nichtzustellung, dem Zustellzeitpunkt sowie seinen Öffnungen und Klicks. Das Suchfeld erfordert eine vollständige, gültige E-Mail-Adresse; eine unvollständige Adresse oder eine Domain besteht die Validierung nicht, markiert das Feld als ungültig und lässt die Tabelle unverändert. Eine Schaltfläche oberhalb der Tabelle exportiert den Tab als CSV, und Broadcast-Empfänger als CSV exportieren liefert dieselbe Datei an einen API-Key. Beide sind auf 500.000 Zeilen begrenzt, mit demselben Verhalten wie beim Broadcast-Listen-Export: Ablehnung statt stillschweigendem Abschneiden. Der Events-Tab ist der Roh-Event-Feed des Broadcasts und verwendet die in Events und Webhooks beschriebenen Eventtypen.

Einen Broadcast proben

Fügen Sie eine Sandbox-Adresse in die Audience ein, und dieser Kontakt wird simuliert statt tatsächlich gesendet: delivered@messagebird.dev meldet zugestellt, bounce@messagebird.dev meldet Bounce, und beide erzeugen dieselben Events und Webhooks wie ein echter Empfänger. So testen Sie eine Kampagne und den Handler, der ihre Events verarbeitet, ohne jemanden anzuschreiben. Eine Audience kann Sandbox- und echte Kontakte mischen; jeder Kontakt erhält sein eigenes Ergebnis. Ein simulierter Empfänger zählt trotzdem gegen Ihr Sendekontingent, sodass die Probe dasselbe Kontingent verbraucht wie der echte Versand.

Nächste Schritte

• Audiences: die Empfängerlisten, an die ein Broadcast sendet
• E-Mail-Templates: Betreff und Inhalt, auf die ein Broadcast verweist
• E-Mail-Metriken: die Workspace-weite Ansicht, in die Broadcasts einfließen
• bird email broadcasts: ein CLI-Befehl pro Broadcast-Operation
• Broadcast erstellen: die API-Referenz mit vollständigen Request- und Response-Schemas und einem Codebeispiel pro SDK
• E-Mail-Broadcasts: eine E-Mail an Ihre gesamte Zielgruppe: ein Video, das einen Broadcast sendet und seine Ergebnisse auswertet