GetMyBot-Wissensdatenbank

Kanäle: Telegram, WhatsApp, VK

Telegram, WhatsApp und VK mit einem Projekt verbinden. Unterschiede zwischen den Kanälen und der Weg einer Antwort zurück zum Nutzer.

Auf dieser Seite

Ein GetMyBot-Projekt kann in Telegram, WhatsApp und VK antworten. Eine Reaktion mit dem Stundenplan lässt sich zum Beispiel in allen drei Messengern verwenden. Die Antwort geht jeweils dorthin zurück, wo die Person geschrieben hat.

Prüfen Sie beim Hinzufügen eines weiteren Messengers die Schaltflächen und Aktionen: Die Plattformen bieten unterschiedliche Möglichkeiten. Im Folgenden sehen Sie die Unterschiede und die Schritte zum Verbinden.

Was ist ein Kanal?

Ein Kanal ist ein verbundener Zustellungsweg: ein bestimmter Telegram-Bot, eine WhatsApp-Business-Nummer oder eine VK-Community. Ein GetMyBot-Projekt kann mehrere Kanäle haben. Seine Reaktionen gelten für alle: Schreibt jemand über WhatsApp, prüfen dieselben Reaktionen das Ereignis wie bei Telegram. Die Antwort geht an WhatsApp zurück.

Schaltflächen, Textformatierung und Aktionen funktionieren nicht in jedem Messenger gleich. Der Editor kann nicht unterstützte Einstellungen ausblenden oder in eine verfügbare Variante umwandeln. Testen Sie Ihre Nachricht vor dem Start in jedem verbundenen Kanal.

Hauptkanal (primary_channel)

Jeder Bot hat einen Hauptkanal (primary_channel): die Plattform, mit der er vor allem verbunden ist. Das ist oft Telegram. Sie können einen Bot aber auch von Anfang an als WhatsApp- oder VK-Bot ohne Telegram anlegen. Der Hauptkanal wird bei der Erstellung festgelegt und in der Bot-Liste angezeigt. Weitere Kanäle können Sie später hinzufügen.

Welche Funktionen bieten die Kanäle?

Die folgende Übersicht zeigt, welche Messenger-Funktionen die Kanäle unterstützen. Die aktuelle, maschinenlesbare Übersicht erhalten Sie über GET /api/channels/capabilities.

Telegram bietet den vollen Funktionsumfang: Inline-Schaltflächen und Antworttastatur, Callbacks (ein Tastendruck löst eine Reaktion aus), Emoji-Reaktionen, Deep Links mit /start, Bearbeiten, Löschen und Weiterleiten von Nachrichten, Antworten als Trigger, Mitgliederereignisse sowie Rechteverwaltung und Moderation. Fotokarussells lassen sich mit Schaltflächen innerhalb einer Nachricht durchblättern. Für Text gibt es Plain, HTML und Markdown. Nachrichtenvorlagen, Listen und ein zeitlich begrenztes Sitzungsfenster sind in Telegram nicht nötig und nicht vorhanden.

WhatsApp über die WhatsApp Cloud API unterstützt Inline-Schaltflächen, Callbacks, Emoji-Reaktionen, Deep Links mit /start, Nachrichtenvorlagen, interaktive Listen und ein 24-Stunden-Sitzungsfenster. Text kann Plain oder Markdown sein. Nicht unterstützt werden Antworttastaturen, das Bearbeiten, Löschen und Weiterleiten von Nachrichten, Antworten als Trigger, Mitgliederereignisse, Rechteverwaltung, Moderation und das Durchblättern eines Karussells innerhalb einer Nachricht. Mehr dazu unter WhatsApp.

VK unterstützt Nachrichten und Anhänge, Inline-Schaltflächen und Antworttastaturen, Callbacks, Emoji-Reaktionen, Deep Links mit /start, das Bearbeiten, Löschen und Weiterleiten von Nachrichten, Mitgliederereignisse, Sperren und Entsperren, das Bestätigen bereits gestellter Beitrittsanfragen für geschlossene Communities und Ereignisse kostenpflichtiger VK-Donut-Abonnements. Text wird nur als einfacher Text ausgegeben; HTML und Markdown werden bei der Darstellung entfernt. WhatsApp-Vorlagen, Listen, das Durchblättern eines Karussells innerhalb einer Nachricht und ein Sitzungsfenster gibt es in VK nicht.

Alle drei Kanäle unterstützen Inline-Schaltflächen, Callbacks, Emoji-Reaktionen und Deep Links mit /start. Der Fotokarussell-Block ist in Kanälen verfügbar, die Fotos unterstützen. In Telegram lassen sich die Karten innerhalb einer Nachricht durchblättern, wenn für alle Fotos geeignete Datei-IDs vorliegen. In WhatsApp und VK sowie in Telegram ohne solche IDs werden die Karten als einzelne Fotonachrichten gesendet. Mehr dazu unter Nachrichten und Schaltflächen.

VK Donut

Wenn in einer Community VK Donut aktiviert ist, erhält der Bot Systemereignisse zu kostenpflichtigen Abonnements:

Ereignis im EditorSchlüsselVerfügbare Platzhalter
VK Donut: subscription created (Abschluss)donut_subscription_created{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription prolonged (Verlängerung)donut_subscription_prolonged{{event.donut_amount}}, {{event.donut_amount_without_fee}}
VK Donut: subscription expired (Ablauf)donut_subscription_expiredkeine
VK Donut: subscription cancelled (Kündigung)donut_subscription_cancelledkeine

{{event.donut_amount}} ist der Zahlungsbetrag, {{event.donut_amount_without_fee}} der Betrag ohne VK-Gebühr. Bei „abgelaufen“ und „gekündigt“ gibt es keinen Betrag: Das Ende der bezahlten Laufzeit ist keine neue Zahlung. Einen früheren Betrag dort einzusetzen, würde eine Zahl erfinden.

Das ist ein Ereignis über einen Abonnenten, keine Nachricht von ihm. Es macht den Dialog daher nicht für persönliche Nachrichten verfügbar, hebt keine Sperre auf, aktualisiert nicht die letzte Aktivität und erhöht nicht den Nachrichtenzähler. Eine Kartenabbuchung bedeutet nicht, dass die Person geschrieben hat. Ist der Abonnent der Plattform noch unbekannt, wird ein Profil angelegt, damit Labels und Rechte für ihn verwaltet werden können.

Beispiel für einen kostenpflichtigen Club:

  1. Erstellen Sie für VK Donut: subscription created und VK Donut: subscription prolonged je eine Reaktion mit Labels ändern → Label „Club“ hinzufügen, mit ttl_days = 31. Senden Sie außerdem einen Link zur geschlossenen Club-Community und bitten Sie die Person, einen Beitrittsantrag zu stellen.
  2. Bestätigen Sie den Antrag erst, nachdem er gestellt wurde. Die Aktion Rechte ändern → Beitrittsanfrage genehmigen führt groups.approveRequest für einen bereits vorliegenden Antrag aus. Ohne Antrag gibt es nichts zu bestätigen. Legen Sie diese Aktion in eine spätere Reaktion, etwa auf die Schaltfläche „Ich habe den Antrag gestellt“ oder auf das nächste Ereignis VK Donut: subscription prolonged.
  3. Erstellen Sie für Label expired (label_expired) eine Reaktion mit Rechte ändern → Entfernen. So verlässt die Person den Club beim Ablauf des Labels, auch wenn VK kein Ereignis „abgelaufen“ gesendet hat. Mehr dazu unter Trigger → abgelaufenes Label.
  4. Erstellen Sie für VK Donut: subscription cancelled und VK Donut: subscription expired Reaktionen mit Labels ändern → „Club“ entfernen und bei Bedarf sofort Entfernen.

Das Feld Chat (chat_id) muss bei VK-Rechteaktionen die ID der verbundenen Community enthalten. Es ist dieselbe Zahl, die beim VK-Kanal in der Kanalliste steht. VK kann nur Mitglieder dieser Community verwalten. Bei einer anderen ID wird die Aktion schon vor dem Aufruf von VK zurückgewiesen. Um eine andere Community zu verwalten, verbinden Sie sie als eigenen Kanal.

So aktivieren Sie die Ereignisse:

  • Long Poll: Der Bot abonniert sie beim Verbinden des Kanals und bei jedem Start der Plattform automatisch. Für bereits verbundene Communities ist nichts weiter zu tun.
  • Callback API: Öffnen Sie in den Community-Einstellungen API-Nutzung → Callback API → Ereignistypen → VK Donut und aktivieren Sie alle vier Ereignisse aus der Tabelle.

Kanal verbinden

Kanäle werden unter Projekte hinzugefügt.

  1. Öffnen Sie Projekte und suchen Sie das gewünschte Projekt.
  2. Klicken Sie auf der Projektkarte auf Kanal hinzufügen.
  3. Wählen Sie Telegram, WhatsApp oder VK.
  4. Geben Sie die Zugangsdaten ein: bei Telegram einen Token, bei WhatsApp die Angaben aus Meta, bei VK die Angaben zur Community.
  5. Klicken Sie auf Prüfen. GetMyBot prüft die Angaben beim jeweiligen Messenger.
  6. Klicken Sie auf Verbinden.

Bei WhatsApp und VK erscheint nach dem Verbinden eine Webhook-Adresse (Symbol 🔗). Tragen Sie sie bei der jeweiligen Plattform ein, für WhatsApp in der Meta-App und für VK in den Community-Einstellungen. Erst dann erreichen eingehende Ereignisse den Bot. Die WhatsApp-Schritte finden Sie unter WhatsApp → Webhook einrichten.

Nächste Schritte

Zugangsdaten der Kanäle

Telegram verwendet den vollständigen BotFather-Token. Für VK benötigen Sie einen Community-Token und die numerische Community-ID. Bei der Callback API kommen ein geheimer Schlüssel und ein Bestätigungscode hinzu. Für WhatsApp geben Sie Phone Number ID, WhatsApp Business Account ID, einen Token mit Kontozugriff, das Verify Token für den Webhook und das App Secret der Meta-App an.

Prüfen Sie die Daten vor dem Verbinden. Wenn sich ein Schlüssel ändert, aktualisieren Sie auch die zugehörige Einstellung beim Anbieter. Das Verify Token bestätigt die Webhook-Adresse, das App Secret prüft die Signatur eingehender Ereignisse. Beide ersetzen nicht den API-Zugriffstoken.

Eingehende Ereignisse und Webhook-Adressen

Tragen Sie für die VK Callback API die in GetMyBot angezeigte Adresse in den Servereinstellungen der Community ein und hinterlegen Sie denselben geheimen Schlüssel und Bestätigungscode. Long Poll benötigt weder eine öffentliche Adresse noch diese beiden Werte. Für WhatsApp tragen Sie die Adresse in der Meta-App ein, verwenden dasselbe Verify Token und abonnieren die benötigten Nachrichtenereignisse. Zugangsdaten für den Versand allein richten den Empfang noch nicht ein.

Instagram und Messenger autorisieren

Der Verbindungsassistent öffnet die Meta-Autorisierung. Melden Sie sich mit dem Konto an, das die gewünschte Facebook-Seite oder das professionelle Instagram-Konto verwaltet, gewähren Sie die angeforderten Rechte und wählen Sie die Konten für dieses Projekt aus. Der Assistent prüft die Rechte, das Webhook-Abonnement und die Bereitschaft zur Zustellung. Beheben Sie fehlgeschlagene Prüfungen, bevor Sie den Kanal verwenden. Bei einer bestehenden Verbindung können Sie die ausgewählten Konten später überprüfen und ändern.