Massenmailings `/send`¶

Der Befehl /send ermöglicht es Ihnen, einzelne Nachrichten oder Nachrichtenketten über das Mailing-System an Kunden zu senden. Alle wichtigen Telegram-Nachrichtentypen werden unterstützt: Text, Sticker, Sprache, Video, Bilder, Dateien.

Funktionsweise¶

Konfiguration und Start von Massenmailings erfolgen im General-Topic mit dem Befehl /send. In Dialog-Topics kann der Befehl auch von Operatoren verwendet werden, aber nur um eine vorbereitete Vorlage an den entsprechenden Benutzer oder Chat zu senden.

Nach dem Start meldet der Befehl den Beginn des Mailings im Topic General. Nach Abschluss erscheint dort eine kurze Zusammenfassung, während ein detaillierter CSV-Bericht mit Empfängerliste und Zustellstatus an den ausführenden Operator im privaten Chat mit dem Setup-Bot gesendet wird.

Starten Sie vor dem ersten Mailing den Setup-Bot oder senden Sie ihm eine Nachricht. Ist der Bot blockiert oder wurde er noch nicht gestartet, erscheint in General ein Fehler bei der Berichtszustellung. Danach können Sie den Bericht mit /send sidSENDING_ID report erneut anfordern.

Nachrichten aus Mailings werden nicht in Topics angezeigt, um die Topic-Chronologie nicht zu stören und die verfügbaren Telegram-Limits für die Nachrichtenzustellung an Gruppen mit einer großen Anzahl von Empfängern nicht zu überschreiten.

Hauptfunktionen¶

Einfaches Testen von Mailings vor dem Senden
Mailing privater Nachrichten an Benutzer oder an Chats
Senden einzelner Nachrichten beliebiger Typen und Nachrichtenketten
Erstellen und Verwenden von Mailing-Vorlagen
Flexible Zeiteinstellungen
Verschiedene Möglichkeiten zur Angabe von Empfängerlisten
Empfängerauswahl nach mehreren Labels und Ausschluss bestimmter Segmente
Detaillierter CSV-Bericht mit Empfängerstatus über den Setup-Bot
Aktuelle Mailing-Geschwindigkeit etwa 1000 Nachrichten pro Minute
Bei Fehler während der Mailing-Ausführung wird es automatisch vom Stoppunkt in 2 Minuten neu gestartet

Mailings von Konten können zu Sperrung führen

Bei Massenmailings von Benutzerkonten besteht ein hohes Risiko, eine vorübergehende Sperrung von Telegram zu erhalten, wenn einer der Empfänger Ihre Nachricht als Spam markiert. Sie können Kontobeschränkungen über @spambot überprüfen

Bei Bot-Mailings besteht dieses Risiko nicht, aber Benutzer können jederzeit den Empfang von Nachrichten vom Bot beenden.

Empfängeroptionen¶

Testsendung

Option test sendet Nachricht nur an Sie zur Überprüfung vor Massenmailing.
Alle Benutzer

Option all sendet Nachricht an alle, die einen Dialog über Hotline hatten.
Liste aus Datei

Option file verwendet angehängte Datei mit Liste von Empfänger-user_id.
Liste im Befehl

Option list akzeptiert Liste von user_id direkt im Befehl, getrennt durch Kommas.
Nach Labels

Option mark sendet die Nachricht an Benutzer mit mindestens einem der angegebenen Labels. Der Parameter exclude schließt Benutzer mit einem der danach aufgeführten Labels aus.

Verwendungsbeispiele¶

Schnelle Benachrichtigungssendung¶

Senden Sie im General-Topic Nachricht: „Liebe Kunden! Wir haben eine neue Aktion auf unserer Website, verpassen Sie sie nicht!"
Antworten Sie darauf mit Befehl: /send test (sendet Testnachricht an Operator)
Prüfen Sie, wie die Nachricht aussieht (sie kommt vom verbundenen Bot oder Konto)
An alle senden: /send all (als Antwort auf dieselbe Nachricht)

Verwendungsidee

Auf diese Weise können Sie schnell Videonotizen oder Sprachnachrichten an Bot-Publikum senden und das Benutzerengagement verbessern.

Vorlage mit Kette erstellen¶

Senden Sie im General-Topic Nachricht: „Hallo! Vielen Dank für Ihr Interesse an unseren Dienstleistungen."
Antworten Sie darauf mit Befehl: /send template onboarding (erstellt die Vorlage und fügt die erste Nachricht hinzu)
Senden Sie eine weitere Nachricht im General: „Innerhalb einer Stunde senden wir Ihnen detaillierte Informationen."
Antworten Sie darauf: /send template onboarding delay 5m (fügt die zweite Nachricht hinzu, die automatisch 5 Minuten nach der ersten gesendet wird)
Senden Sie PDF mit Katalog und Notiz im General
Antworten Sie darauf: /send template onboarding delay 1h (fügt die dritte Nachricht hinzu, die automatisch 1 Stunde nach der zweiten gesendet wird)

Die Vorlage onboarding enthält nun drei Nachrichten mit den angegebenen Intervallen. Sie kann in Benutzer-Topics mit /send onboarding verwendet oder im Topic General mit /send all template onboarding an alle Benutzer gesendet werden.

Mailing nach Label¶

Um die gespeicherte Vorlage special_offer an Kunden mit Label vip oder lead zu senden und Kunden mit Label blocked auszuschließen:

/send mark vip,lead template special_offer exclude blocked

Mehrere einschließende Labels verwenden eine ODER-Logik: Ein Empfänger wird aufgenommen, wenn er mindestens eines davon hat. exclude schließt einen Dialog immer aus, wenn er mindestens eines der danach aufgeführten Labels hat.

Gelöschte Topics prüfen

Führen Sie vor einem Massenmailing /sync N deleted aus, wobei N die Anzahl der zu prüfenden Dialoge ist. Dadurch werden bereits gelöschte Topics aus der aktiven Datenbank entfernt und Sendeversuche an sie verhindert.

Mailing-Limits¶

Systemversion	Nachrichtenlimit pro Monat
Kostenlos	500
Kostenpflichtig	ab 4000 im Mindesttarif (alle Tarife)

Limits erweitern

Um Standardlimits zu erhöhen, kontaktieren Sie den Support-Service.

Zugriffsbeschränkung¶

Standardmäßig sind Funktionen zur Konfiguration und zum Start von Mailings nur für Verbindungsadministratoren verfügbar. Der Zugriff kann über den Parameter EXTENSIONS_ALLOWED erweitert werden.

Befehl /send in Topics

Operatoren können den Befehl /send in Topics auch ohne Administratorzugriff verwenden.

Befehl aufrufen¶

Befehl /send funktioniert unterschiedlich je nachdem, wo er aufgerufen wird!

Im General-Topic (mit `reply` auf Nachricht)¶

Wird verwendet, um bestimmte Nachricht zu senden oder Vorlage zu erstellen.

Nachricht senden

An sich selbst zum Testen senden:

/send test [now | delay ... | datetime ...] [instance INSTANCE_ID]

An alle Benutzer senden, mit denen es einen Dialog gab:

/send all [now | delay ... | datetime ...] [instance INSTANCE_ID]

An Benutzer aus angehängter Datei senden (Liste von user_id kann durch Kommas, Leerzeichen oder Zeilenumbruch getrennt sein):

/send file [now | delay ... | datetime ...] [instance INSTANCE_ID]

An Benutzer aus Liste getrennt durch Kommas senden:

/send list CHAT_ID1,CHAT_ID2 [now | delay ... | datetime ...] [instance INSTANCE_ID]

An Benutzer mit einem der angegebenen Labels senden:

/send mark MARK1,MARK2 [now | delay ... | datetime ...] [instance INSTANCE_ID]

Vorlage erstellen

Nachricht zu neuer oder bestehender Vorlage hinzufügen (Vorlagenname muss mit lateinischem Buchstaben beginnen, kann Zahlen, Bindestrich oder Unterstrich enthalten):

/send template TEMPLATE_NAME [now | delay ... | datetime ...]

Nachrichtenkette erstellen

Erste Nachricht senden und darauf antworten: /send template welcome
Zweite Nachricht senden und darauf antworten: /send template welcome delay 5m
Dritte Nachricht senden und darauf antworten: /send template welcome delay 1h

Ergebnis: Vorlage welcome enthält drei Nachrichten. Erste wird sofort gesendet, zweite — 5 Minuten nach erster, dritte — 1 Stunde nach zweiter.

Im General-Topic (ohne `reply`)¶

Wird verwendet, um Massenmailings zu starten, Vorlagen und Mailings zu verwalten.

Vorlage senden

Vorlage an sich selbst zum Testen senden:

/send test template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Vorlage an alle Benutzer senden:

/send all template TEMPLATE_NAME [exclude MARK1,MARK2] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Vorlage an Benutzer aus Datei senden:

/send file template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Vorlage an Benutzer aus Liste senden:

/send list CHAT_ID1,CHAT_ID2 template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Vorlage an Benutzer mit einem der angegebenen Labels außer den ausgeschlossenen senden:

/send mark MARK1,MARK2 template TEMPLATE_NAME [exclude MARK3,MARK4] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Informationen anzeigen

Alle erstellten Vorlagen anzeigen:

/send templates

Letzte Mailings anzeigen:

/send sendings [instance INSTANCE_ID]

Vorlageneigenschaften anzeigen:

/send template TEMPLATE_NAME

Mailing-Status und kurze Zusammenfassung anzeigen:

/send sidSENDING_ID

Detaillierten CSV-Bericht im privaten Chat mit dem Setup-Bot erhalten:

/send sidSENDING_ID report

Bearbeiten und löschen

Vorlage umbenennen:

/send template TEMPLATE_NAME name NEW_NAME

Nachrichtensendezeit in Vorlage ändern:

/send template TEMPLATE_NAME for MESSAGE_ID [now | delay ... | datetime ...]

Nachricht aus Vorlage löschen:

/send template TEMPLATE_NAME del MESSAGE_ID

Vorlage vollständig löschen:

/send template TEMPLATE_NAME del

Mailing abbrechen (nur wenn es im Status awaits ist):

/send sidSENDING_ID del

Im Dialog-Topic (ohne `reply`)¶

Wird verwendet, um Vorlage an bestimmten Benutzer oder Chat zu senden.

Vorlage senden

Vorlage an Benutzer dieses Topics senden:

/send TEMPLATE_NAME [now | delay ... | datetime ...]

Verfügbare Vorlagen anzeigen:

/send templates

Mailings für dieses Topic anzeigen:

/send sendings

Sendestatus anzeigen (ohne Bericht):

/send sidSENDING_ID

Zeiteinstellungen¶

Für jede Nachricht können Sie die Sendezeit mit [now | delay ... | datetime ...] angeben:

Format	Beschreibung	Beispiel
`now`	Sofort senden (Standard)	`now`
`delay`	Verzögertes Senden	`delay 5m 30s`, `delay 2h`, `delay 1d`
`datetime`	Feste Zeit in UTC	`datetime 2026-07-27 14:25:55`

Nachrichtenketten

In Vorlagen mit mehreren Nachrichten wird Verzögerung ab dem Moment des Sendens der vorherigen Nachricht in der Kette gezählt.

Parameter `instance`¶

Bei mehreren Verbindungen in einer Backend-Gruppe können Sie instance INSTANCE_ID am Ende des Befehls ergänzen, um ihn nur für eine bestimmte Verbindung auszuführen.

Standardverhalten

Ohne den Parameter instance INSTANCE_ID wird der Befehl unabhängig für jede Verbindung in der Backend-Gruppe ausgeführt.

Massenmailings /send¶