WhatsApp

GetMyBot bindet WhatsApp über die WhatsApp Cloud API (Meta Graph API) an. Nach dem Anbinden nimmt der Bot eingehende WhatsApp-Nachrichten entgegen und wendet Ihre Reaktionen darauf an, und Operatoren können Unterhaltungen in Dialogen führen. Einen allgemeinen Überblick über die Mehrkanalfähigkeit finden Sie auf der Seite Kanäle.

Anbinden eines WhatsApp-Kanals

Zum Anbinden werden fünf Zugangsdaten aus Ihrer Meta-App (WhatsApp Cloud API) benötigt. Alle sind erforderlich:

  • Phone number ID — die Kennung der WhatsApp-Business-Nummer.
  • WABA ID — die Kennung des WhatsApp Business Account.
  • Access token — das Zugriffstoken der Meta-App.
  • Verify token — eine beliebige Zeichenfolge, die Sie sich selbst ausdenken. Sie wird bei der Verifizierung des Webhooks in Meta verwendet (siehe unten).
  • App secret — das Geheimnis der Meta-App. Es wird benötigt, um die HMAC-Signatur eingehender Webhooks zu prüfen (Header X-Hub-Signature-256).

Schritte in der Oberfläche:

  1. Öffnen Sie Bots → „Kanal hinzufügen" → WhatsApp.
  2. Füllen Sie die fünf Felder oben aus und, falls gewünscht, einen Kanalnamen (optional).
  3. Klicken Sie auf „Prüfen" — GetMyBot validiert die Zugangsdaten über Meta.
  4. Klicken Sie auf „Anbinden".

Webhook-Einrichtung in Meta

Nach dem Anbinden erhält der Kanal eine Callback URL der Form {Adresse}/ch/{channelID} (in der Oberfläche das Webhook-Symbol 🔗). Sie muss zusammen mit Ihrem Verify token in der Meta-App eingetragen werden: WhatsApp → Configuration → Webhook.

So funktioniert es:

  1. Meta sendet an die Callback URL eine Verify-Anfrage und gleicht den übergebenen verify_token mit Ihrem Verify token ab. Bei Übereinstimmung gilt der Webhook als bestätigt.
  2. Danach schickt Meta an diese Adresse Ereignisse (eingehende Nachrichten, Zustellstatus, Moderationsurteile zu Vorlagen).
  3. Jede eingehende Anfrage ist mit dem Header X-Hub-Signature-256 signiert; GetMyBot prüft die Signatur mithilfe des App secret — deshalb wird diese Angabe beim Anbinden verlangt.

Das 24-Stunden-Sitzungsfenster

WhatsApp schränkt die initiative Korrespondenz ein: freie Nachrichten dürfen an einen Nutzer nur innerhalb von 24 Stunden nach seiner letzten eingehenden Nachricht gesendet werden. Jede neue eingehende Nachricht des Nutzers erneuert das Fenster.

Außerhalb des 24-Stunden-Fensters lässt sich keine freie Nachricht senden — die einzige Möglichkeit, den Nutzer erneut anzuschreiben (Re-Engagement), ist eine genehmigte Nachrichtenvorlage. Deshalb sind Vorlagen das zentrale Werkzeug für Broadcasts und Erinnerungen in WhatsApp.

Nachrichtenvorlagen

Eine Nachrichtenvorlage (message template) ist eine vorab mit Meta abgestimmte Nachricht, die außerhalb des Sitzungsfensters gesendet werden darf. Die Verwaltung der Vorlagen erfolgt in der Oberfläche von GetMyBot.

Wo man Vorlagen verwaltet

Bots → beim WhatsApp-Kanal das Symbol „Nachrichtenvorlagen" (📄) → Dialog „Vorlagen des WhatsApp-Kanals". Im Dialog gibt es Schaltflächen:

  • „Vorlage erstellen" — eine neue Vorlage zusammenstellen.
  • „Synchronisieren" — den Vorlagenkatalog aus Meta abrufen (Status und Liste aktualisieren).

Vorlagenkategorien

  • MARKETING (Marketing) — Aktionen, Ankündigungen, Broadcasts.
  • UTILITY (Service) — Benachrichtigungen zu Nutzeraktionen (Bestellstatus, Erinnerungen).
  • AUTHENTICATION (Authentifizierung) — Bestätigungscodes.

Vorlagenfelder

  • Name — lateinische Kleinbuchstaben, Ziffern und _, bis zu 512 Zeichen.
  • Sprache — eine Meta-Locale.
  • Kategorie — eine der drei oben.

Für die Kategorien Marketing und Service zusätzlich:

  • Kopfzeile — keine / Text / Bild / Video / Dokument. Für eine Medien-Kopfzeile wird eine Beispieldatei hochgeladen.
  • Textkörper — erforderlich, bis zu 1024 Zeichen. Variablen werden mit {{1}}, {{2}}, … bezeichnet, streng der Reihe nach von 1 bis N, ohne Lücken.
  • Fußzeile — bis zu 60 Zeichen.
  • Schaltflächen — bis zu 10: Schnellantwort, Link (bis zu 2), Telefon (1), Code kopieren (1).
  • Für jede Variable {{n}} muss ein Beispielwert angegeben werden — das ist eine Meta-Anforderung für die Moderation.

Für die Kategorie Authentifizierung ist der Textkörper von Meta selbst festgelegt; eingestellt werden: die Gültigkeitsdauer des Codes (1–90 Minuten), die Sicherheitsempfehlung und der Text der Schaltfläche zum Kopieren des Codes.

Moderation

Die Schaltfläche „Erstellen" sendet die Vorlage sofort zur Moderation an Meta — einen separaten Schritt „zur Prüfung senden" gibt es nicht. Das Urteil trifft asynchron ein (über den Webhook), die Vorlagenliste aktualisiert sich automatisch. Status:

  • PENDING (In Prüfung)
  • APPROVED (Genehmigt)
  • REJECTED (Abgelehnt) — mit Angabe des Grundes
  • sowie PAUSED, DISABLED, IN_APPEAL, PENDING_DELETION.

Bearbeiten lassen sich Vorlagen in den Status APPROVED, REJECTED, PAUSED. Name und Sprache können nicht geändert werden; bei genehmigten Vorlagen ist auch die Kategorie gesperrt.

Verwendung einer Vorlage in einer Reaktion

Das Senden einer Vorlage ist eine Reaktionsaktion:

  1. Öffnen Sie im Reaktions-Editor „Aktionen" → „Aktion hinzufügen" → „WhatsApp-Vorlage senden".
  2. Die Aktion ist nur verfügbar, wenn der Bot einen WhatsApp-Kanal mit Vorlagenunterstützung angebunden hat.
  3. Es kann nur eine genehmigte (APPROVED) Vorlage ausgewählt werden.
  4. Es werden Parameter ausgefüllt: die Werte der Variablen {{n}} im Textkörper, die Text-Kopfzeile, die Medien-Kopfzeile per Link, die Parameter der URL-Schaltflächen. In den Parametern lassen sich Variablen-Substitutionen verwenden.

Der tatsächliche Sendekanal wird durch den Kanal des Ereignisses bestimmt: Kam das Ereignis aus WhatsApp, geht die Vorlage nach WhatsApp.

Dialoge und Anhänge

Ein Operator kann im WhatsApp-Dialog antworten und Anhänge senden — Bild, Video oder Dokument — unter Berücksichtigung des 24-Stunden-Fensters (außerhalb des Fensters ist freie Korrespondenz nicht möglich). Eingehende Medien von Abonnenten werden über einen Proxy geladen und im Dialog angezeigt.

Tarifierung

GetMyBot führt Buch über WhatsApp-Unterhaltungen (conversations) nach Kategorien — marketing / utility / authentication / service. In der aktuellen Version ist das nur eine Erfassung zur Beobachtbarkeit (record-only): Für Unterhaltungen wird kein Guthaben abgebucht.

Wie es weitergeht