Broadcasts

Ein Broadcast sendet eine einzelne E-Mail an eine gesamte Zielgruppe: einen Newsletter, eine Ankündigung oder jeden anderen einzelnen Inhalt, der gleichzeitig an viele Empfänger geht. Die Mitglieder der Zielgruppe werden beim Start des Versands in die Empfängerliste aufgelöst, sodass ein Broadcast alle erreicht, die zu diesem Zeitpunkt Mitglied der Zielgruppe 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.

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

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

Öffnen Sie den Einstellungsbereich im Composer-Header für drei weitere Optionen:

Ein Broadcast wird von einer Adresse auf einer verifizierten Versanddomain 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 hin geleitet werden sollen. Bei Auswahl von Review werden Sie gewarnt, wenn die Domain nicht verifiziert ist.

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

Schreiben Sie den Inhalt direkt in den 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 Inhalt überschreiben würde. Ein Broadcast versendet die veröffentlichte Version des Templates, daher kann ein Template, das nur einen Entwurf hat, keinen Versand unterstützen.

Das Senden ist eine separate, explizite Aktion, verfügbar über die Schaltfläche Review im Composer oder über die Detailseite des Broadcasts mit Send or reschedule. Beide öffnen einen Dialog, der prüft, ob der Broadcast vollständig ist, Sie vor möglichen Fehlern warnt und Ihnen dann 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 zum tatsächlichen Versandstart umplanen.

Beim Senden wird geprüft, ob die Zielgruppe noch erreichbare Empfänger hat. Eine Zielgruppe, 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. Ihr Plan legt die Anzahl fest. Gespeicherte Entwürfe zählen nicht dazu, und das Abbrechen eines Broadcasts gibt das Kontingent nicht zurück. Sobald Sie es aufgebraucht haben, warten Sie entweder auf den nächsten Abrechnungszeitraum oder wechseln zu einem Plan mit höherem 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.

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

Exportieren Sie die aktuelle Ansicht über die Schaltfläche oberhalb der Tabelle als CSV oder rufen Sie Broadcasts als CSV exportieren mit denselben Filtern auf. Bei mehr als 50.000 Zeilen wird der Export abgelehnt, statt die Datei unbemerkt zu kürzen. Schränken Sie die Filter ein und versuchen Sie es erneut.

Ein Broadcast befindet sich immer in einer von vier Phasen, und der Status-Filter in der Liste verwendet diese vier:

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

Brechen Sie einen geplanten oder laufenden Broadcast über seine Detailseite, mit bird email broadcasts cancel oder über Broadcast abbrechen und die SDK-Methode broadcasts.cancel ab. Noch nicht erreichte Empfänger werden übersprungen; bereits versandte Nachrichten lassen sich nicht zurückrufen. Löschen ist nur bei Entwürfen möglich und endgültig. Dafür stehen dieselben drei Wege zur Verfügung: die Detailseite, bird email broadcasts delete oder Broadcast löschen.

Ein fehlgeschlagener Broadcast zeigt auf seiner Detailseite den Grund an: die Ursachenkategorie und dann einen Satz, der die genaue Ursache benennt. Über die API sind das die Felder failure_reason und failure_detail. failure_detail sagt Ihnen, welche der möglichen Ursachen einer Kategorie tatsächlich eingetreten ist.

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

Broadcasts und Einzelversand nutzen dasselbe E-Mail-Kontingent. Die Plan-Karte in der Abrechnungsübersicht Ihrer Organisation zeigt, wie viel davon verbraucht ist. Pläne und Preise beschreibt, was jeder Plan enthält.

Sobald der Versand beginnt, zeigt der Tab Overview die Anzahl der Empfänger und versandten Nachrichten sowie Zustell-, Öffnungs-, Klick-, Bounce- und Beschwerderaten mit den jeweiligen Anzahlen. Der Tab Recipients listet alle Empfänger mit Zustellstatus, gegebenenfalls dem Grund für die Nichtzustellung, Zustellzeitpunkt sowie Öffnungen und Klicks auf. Das Suchfeld verlangt eine vollständige, gültige E-Mail-Adresse. Eine unvollständige Adresse oder eine Domain besteht die Validierung nicht: Das Feld wird als ungültig markiert und die Tabelle zeigt weiterhin den vorherigen Inhalt. Über eine Schaltfläche oberhalb der Tabelle lässt sich der Tab als CSV exportieren. Empfänger eines Broadcasts als CSV exportieren liefert dieselbe Datei über einen API-Schlüssel. Beide Exporte sind auf 500.000 Zeilen begrenzt; wie beim Export der Broadcast-Liste wird eine Überschreitung abgelehnt, statt die Datei zu kürzen. Der Tab Events zeigt den unverarbeiteten Ereignisfeed des Broadcasts mit den unter Ereignisse und Webhooks beschriebenen Ereignistypen.

Fügen Sie eine Sandbox-Adresse in die Zielgruppe ein, und dieser Kontakt wird simuliert statt tatsächlich angeschrieben: 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 deren Events verarbeitet, ohne jemanden tatsächlich anzuschreiben. Eine Zielgruppe kann Sandbox- und echte Kontakte mischen; jeder Kontakt erhält sein eigenes Ergebnis. Ein simulierter Empfänger zählt trotzdem gegen Ihr Versandkontingent, sodass die Probe dasselbe Kontingent verbraucht wie der echte Versand.