Einen Botpress-Bot mit Coexistence an WhatsApp anbinden

Welche Botpress-Konfiguration funktioniert mit einer Coexistence-Nummer?

Die Manual Configuration. Die anderen Optionen verbinden eine Nummer über die eigene Meta-App von Botpress. Das ist ein separates Onboarding der Nummer und kein Weg, eine bereits verbundene Nummer zu nutzen.

Öffnen Sie in der WhatsApp-Integration das Dropdown Configuration und wählen Sie Manual Configuration. Abgefragt werden ein Verify Token, ein Access Token, eine Default Bot Phone Number ID und optional eine App ID, ein Client Secret und eine WABA ID.

Access Token, Nummern-ID und WABA-ID stammen aus der Verbindung: Das Dashboard zeigt sie an, und get_api_credentials liefert sie an einen Assistenten. Das Verify Token ist eine beliebige Zeichenfolge Ihrer Wahl. App ID und Client Secret bleiben leer. Der Leitfaden von Botpress stellt das Secret als auszufüllendes Feld dar, doch die Integrationsdefinition markiert es als optional und hält fest, dass ohne Secret die Signaturprüfung entfällt. Das ist wichtig, denn Meta signiert jede Zustellung mit dem App-Secret des Tech Providers, und das besitzt kein Kunde.

Wie erhält der Botpress-Webhook die Nachrichten von Meta?

Über das Webhook-Ziel der Nummer. Der Leitfaden von Botpress sieht vor, dass Sie die Webhook-URL und Ihr Verify Token in die WhatsApp-Konfiguration einer Meta-App einfügen. Hier gibt es keine eigene Meta-App: Meta leitet die Ereignisse der Nummer an das Ziel, das die Verbindung nennt. Kopieren Sie also die Webhook-URL, die Botpress für die Integration anzeigt, und tragen Sie sie mit demselben Verify Token als Ziel im Dashboard oder per set_webhook_destination ein.

Meta sendet ein Verifizierungs-GET, Botpress beantwortet es, und die Zustellung beginnt. Beim Speichern einer manuellen Konfiguration prüft Botpress das Token außerdem, indem es Graph fragt, welche App es ausgestellt hat. Ein ungültiges oder widerrufenes Token scheitert deshalb beim Speichern und nicht erst bei der ersten Nachricht.

Der Handler von Botpress verarbeitet auch smb_message_echoes, das Ereignis, das Meta sendet, wenn jemand aus der WhatsApp Business App antwortet. Eine Antwort vom Telefon ist für den Bot also sichtbar und nicht unsichtbar.

Was sollte der Bot über Coexistence wissen?

Dass bereits ein Mensch mitschreiben kann. Die WhatsApp Business App funktioniert auf der Nummer weiter, sodass ein Kunde innerhalb derselben Minute eine Antwort vom Telefon und vom Bot erhalten kann. Legen Sie im Flow fest, was bei einem Echo geschieht: Die meisten Teams pausieren den Bot für diesen Kontakt eine Weile, damit die Person, die eingegriffen hat, nicht übersprochen wird.

Das Zweite ist das Timing. Ein Bot, der auf eingehende Nachrichten antwortet, arbeitet innerhalb des 24-Stunden-Servicefensters, in dem Freitext erlaubt ist. Ein Flow, der erst einen Tag später etwas sendet, etwa ein Follow-up oder eine Erinnerung, braucht ein freigegebenes Template, und Freitext liefert dort den Fehler 131047. Der Leitfaden von Botpress abonniert die Felder für den Template-Status genau für solche proaktiven Nachrichten.

Und der Durchsatz ist bei einer Coexistence-Nummer auf 20 Nachrichten pro Sekunde festgelegt, weit mehr, als ein Dialog-Bot sendet.

Häufige Fehler

• Das Client Secret mit dem Secret der eigenen Meta-App füllen. Die Signatur stimmt nie überein, und Botpress beantwortet jede Zustellung mit 401.
• Die OAuth- oder Sandbox-Option statt der Manual Configuration wählen. Sie verbinden eine Nummer über die eigene App von Botpress, nicht die bereits verbundene.
• Echos ignorieren. Ohne Regel für Antworten vom Telefon antwortet der Bot über eine Person hinweg, die bereits eingegriffen hat.

Häufig gestellte Fragen

Weiterlesen