GetMyBot-Wissensdatenbank

Broadcasts

Nachrichten und Erinnerungen an Kundengruppen senden: Inhalt, Kanäle und Zielgruppe wählen, Versand prüfen und Bericht lesen.

Auf dieser Seite

Ein Broadcast sendet eine vorbereitete Nachricht an viele Menschen, etwa eine Kurseinladung an alle mit dem Label „Interessiert“. Wählen Sie Inhalt, Zielgruppe und Kanäle, prüfen Sie die Empfänger und starten Sie den Versand.

GetMyBot bietet zwei Wege:

  • Broadcasts (/app/broadcasts): vollständiger Editor mit einem Inhaltsdokument, Kanälen, segmentbasierter Zielgruppe, Zeitplan, Prüfung vor dem Versand und Bericht nach Kanälen. Das ist der empfohlene Weg.
  • Broadcast-Schaltfläche an einer Reaktion: Sendet eine fertige Reaktion an aktive Abonnenten. Es gibt weder Entwurf noch Vorprüfung; prüfen Sie Inhalt und Zielgruppe vorher.

Beide erfordern einen Tarif mit Broadcast-Funktion und die Bot-Berechtigung Reaktionen. Ohne Tarif-Funktion liefert das Erstellen einen Zahlungsfehler. Ohne Berechtigung zeigt der Bereich eine leere Seite mit Hinweis.

Broadcast-Editor

Öffnen Sie Broadcasts im linken Menü und klicken Sie auf Broadcast erstellen. Der Editor hat vier Bereiche.

Name und Kanäle. Der Name hat höchstens 160 Zeichen. Wählen Sie einen oder mehrere Kanäle: Telegram, VK, WhatsApp, Web-Chat, E-Mail, Browser-Push, mobiler Push oder In-App-Anzeige. Messenger können mit Web-Chat kombiniert werden, Browser-Push mit mobilem Push. E-Mail und In-App-Anzeige stehen jeweils allein. Jede Gruppe benötigt eine eigene Dokumentart: Nachricht, Push, E-Mail oder In-App. Da ein Broadcast nur ein Dokument referenziert, entfernt die Wahl eines Kanals einer anderen Gruppe die bisherige Auswahl.

Inhalt. Wählen Sie eine veröffentlichte Version eines zur Kanalgruppe passenden Dokuments. Der Broadcast speichert Dokument-ID und Versionsnummer. Späteres Veröffentlichen einer weiteren Dokumentversion ändert ihn nicht. Im Editor können Sie neuen Inhalt oder eine bearbeitbare Kopie erstellen, anschließend veröffentlichen und in den Broadcast übernehmen. Für Messenger und Web-Chat gibt es Nachrichtenblöcke einschließlich Sprachnachrichten, GIFs, Videokreise und Karussells; in VK wird ein Karussell als Nachrichtenfolge gesendet.

Für Messenger, Web-Chat und E-Mail gibt es eine Vorschau je Kanal. Wählen Sie einen Testempfänger, ersetzt die Vorschau dessen Daten; Test senden schickt den Inhalt an diesen einen bestätigten Kontakt. Der Test nutzt denselben Pfad samt Quoten und Grenzen wie in Content Studio: Er verändert keine Empfängerzeilen des Broadcasts, nimmt keine beliebigen Adressen an und lehnt zu häufige Tests ab. Für Browser- und Mobil-Push sowie In-App-Anzeigen gibt es nur eine Gerätevorschau, keinen Testversand aus diesem Editor.

Zielgruppe und Experiment. Wählen Sie alle Bot-Abonnenten, ein fertiges Segment oder bot_chats, also Chats und Kanäle des Bots: Gruppen, Supergruppen und Kanäle, denen der Bot hinzugefügt wurde. Die Liste füllt sich automatisch beim Hinzufügen oder beim Ernennen zum Administrator. Einzelne Chats können markiert werden; ohne Markierung werden alle Chats mit Schreibrecht verwendet. bot_chats funktioniert nur mit Telegram und entfernt bei Auswahl andere Kanäle. Chats, aus denen der Bot entfernt wurde oder in denen er nicht schreiben darf, sowie unbekannte IDs werden mit bot_left, cannot_post oder chat_unknown ausgeschlossen. Abonnentenbezogene Personalisierung ({{profile.*}}, {{event.*}}) wird in Chats nicht eingesetzt. Optional kann ein laufendes A/B-Experiment verknüpft werden.

Zeitplan. Legen Sie Zeitzone, Zeitinterpretation, Versandzeit und Geschwindigkeit fest.

  • Versandzeit ist optional. Ohne sie startet der Versand direkt nach Bestätigung.
  • Nach Bot-Zeit: Ein gemeinsamer absoluter Zeitpunkt für alle, berechnet in der Broadcast-Zeitzone.
  • Nach Ortszeit des Empfängers: Dieselbe Uhrzeit für jeden Empfänger in seiner Zeitzone. Fehlt diese, ist sie ungültig oder existiert die Uhrzeit dort an diesem Tag nicht, wird nach Broadcast-Zeit gesendet. Anders als bei E-Mail-Broadcasts wird die Person nicht ausgeschlossen.
  • Eine wegen Zeitumstellung nicht existierende Versandzeit lehnt der Editor mit Hinweis unter dem Feld ab.
  • Nachrichten pro Minute: 1 bis 10.000. Der Versand wird entsprechend gestaffelt: Bei 60 erhalten die ersten 60 die Startzeit, die nächsten 60 eine Minute später usw.

Sind kostenpflichtige Broadcasts für den Bot aktiviert und ist Telegram ausgewählt, erscheinen ein Schalter für Telegram-Sterne und ein eigener Bestätigungshaken. Ohne Haken lässt sich der Entwurf nicht speichern. Wird der Schalter am Bot später abgeschaltet, scheitert der vorbereitete Broadcast nicht, sondern wird kostenlos gesendet.

Vor dem Versand prüfen

Empfänger prüfen sendet nichts. Die Prüfung berechnet anhand des aktuellen Entwurfs, der Kanäle und Einwilligungsregeln die Empfänger je Kanal, ausgeschlossene Personen und Gründe sowie Inhaltsfehler und Warnungen.

Ausschlussgründe:

  • no_identity: kein Kontakt des Abonnenten im Kanal;
  • unverified: Kontakt nicht bestätigt;
  • blocked: Abonnent hat den Bot gesperrt;
  • channel_disabled: Kanal nicht verbunden oder deaktiviert;
  • email_unsubscribed, email_bounced, email_complained, email_no_consent: E-Mail-Einwilligung nicht im Zustand „abonniert“;
  • wa_window_closed: keine eingehende WhatsApp-Nachricht in den letzten 24 Stunden, daher keine freie Nachricht möglich.

Folgende Fehler verhindern den Start:

  • content_not_published: gewählte Inhaltsversion fehlt oder ist nicht veröffentlicht;
  • audience_not_ready: Segment fehlt oder wurde noch nicht neu berechnet;
  • experiment_not_ready: verknüpftes Experiment läuft nicht oder verteilt nicht nach Abonnenten;
  • empty_audience: niemand wird den Broadcast erhalten;
  • Inhaltsvalidierungsfehler je Kanal mit Feld content:<Kanal>, etwa content:wa.

Inhaltswarnungen stehen daneben und blockieren nicht. Die Start-Schaltfläche wird nur bei null Fehlern und mindestens einem Empfänger aktiviert.

Starten und verwalten

Nur ein Entwurf kann gestartet werden, und nur aus dem Prüfbereich. Die Schaltfläche heißt je nach Zeitplan Jetzt senden oder Planen. Der Start verlangt eine ausdrückliche Bestätigung und die aktuelle Revision.

Beim Start fixiert die Plattform gemeinsam Inhaltsversion, Kanäle, Zielgruppe, Experiment und Zeitplan. Für jeden geeigneten Empfänger erzeugt sie einen Queue-Eintrag mit berechneter Versandzeit. Für Ausgeschlossene wird nur der Grund gespeichert. Deshalb unterscheidet der Bericht ausgeschlossene Empfänger von fehlgeschlagenen Versandversuchen.

Danach ist der Broadcast unveränderlich. Der Editor ist nur lesbar; für Änderungen bietet er einen neuen Broadcast an.

Status: Entwurf, Geplant, Wird gesendet, Pausiert, Abgeschlossen, Abgebrochen, Fehlgeschlagen, Archiviert. Mögliche Aktionen:

  • Pausieren: bei Geplant oder Wird gesendet. Noch nicht begonnene Nachrichten werden zurückgehalten, bereits laufende erreichen ihr Ziel.
  • Fortsetzen: bei Pausiert; danach Wird gesendet.
  • Abbrechen: bei Entwurf, Geplant, Wird gesendet oder Pausiert. Noch nicht versendete Nachrichten werden als abgebrochen markiert.
  • Archivieren: bei Abgeschlossen, Abgebrochen oder Fehlgeschlagen. Archivierte Einträge zeigt Archivierte Broadcasts anzeigen.

Jeder Befehl enthält die erwartete Revision. So überschreiben zwei Mitarbeiter einander nicht unbemerkt; der zweite erhält „Broadcast wurde an anderer Stelle geändert“.

Bericht und Empfänger

Ein Klick auf den Broadcast öffnet den Bericht. Pro Kanal zeigt er In Warteschlange, Gesendet, Zugestellt, Fehler, Ausgeschlossen. Solange der Broadcast geplant ist, läuft oder pausiert, aktualisiert sich der Bericht alle 15 Sekunden.

Bei Chats und Bot-Kanälen gibt es zusätzlich Nach Chats: Jeder Chat mit Name und Versandstatus (wartend, gesendet, Fehler, abgebrochen) oder Ausschlussgrund. Telegram-Zähler zählen hier Chats, nicht Abonnenten. Pause, Fortsetzung, Abbruch und Nachrichten-pro-Minute-Limit funktionieren wie bei Abonnenten.

Der Zähler Zugestellt bleibt auf dieser Ebene null: Die Plattform weiß, dass sie eine Nachricht an den Kanal gesendet hat, erfasst aber keine Zustellbestätigung für diesen Bericht. Für E-Mail gibt es detaillierte Werte zu Öffnungen, Klicks, Rückläufern und Beschwerden unter E-Mail-Broadcasts.

Nach dem Broadcast blockiert zählt Sperrereignisse innerhalb von 24 Stunden nach Zustellung dieses Broadcasts. Die Sperre wird dem letzten zugestellten Broadcast im Zeitfenster zugerechnet. Es sind Ereignisse, keine eindeutigen Abonnenten. Die Liste finden Sie unter Personen → Blockiert → CSV exportieren, mit der Spalte blocked_at.

Empfänger öffnet eine paginierte Liste nur mit Kanal, Status (Wartet, Ausgeschlossen, In Warteschlange, Wird gesendet, Gesendet, Fehler, Abgebrochen) und Ausschlussgrund. Eine eigene Empfängerspalte gibt es nicht.

Wichtig: Besteht der Inhalt für eine Person aus mehreren Nachrichten, wird nur die erste gesendet. Der Broadcast hat eine Empfängerzeile je Paar „Empfänger und Kanal“.

Reaktion aus der Reaktionsliste versenden

Der ältere Weg funktioniert weiterhin. Jede Reaktion in der Liste Reaktionen hat eine Sende-Schaltfläche mit dem Hinweis „Reaktion an Abonnenten senden“. Ein Klick stellt sie sofort in die Queue; Entwurf, Vorprüfung und Kanalbericht fehlen. Im Dialog können Sie einen kostenpflichtigen Telegram-Sterne-Broadcast wählen, falls für den Bot erlaubt. Die Schaltfläche Broadcast auf der Übersicht führt zur selben Reaktionsliste.

Diese Sendung erreicht alle aktiven Bot-Abonnenten. Nur über die API können Sie sie nach Labels einschränken, mit dem Parameter labels (siehe REST-API und Tokens); in der Oberfläche gibt es keine Labelauswahl.

Ihre Status sind kürzer: wartend, laufend, fertig, abgebrochen, plus Pausenkennzeichen. Pausieren, Fortsetzen und Abbrechen sind über die API möglich. Die Sendung übersteht Neustarts: Sie läuft seitenweise und setzt an der gespeicherten Position fort.

Geplanter Versand

Eine Reaktion mit dem Trigger Nach Zeitplan (Termine) startet zu festgelegten Zeiten und wird automatisch an aktive Abonnenten gesendet. So entstehen regelmäßige Zusammenfassungen und Erinnerungen ohne Handarbeit. Ein erneuter Start nach einem Fehler kann manchen Empfängern eine Nachricht doppelt schicken. Bei geplanten Ankündigungen gilt ein seltener Doppelversand als weniger schlimm als eine still verlorene Sendung.

Weiterführende Artikel