Einen Typebot-Flow mit Coexistence auf WhatsApp betreiben
Der WhatsApp-Kanal von Typebot verlangt ein Token, eine WhatsApp Business Account ID und eine Phone number ID und liefert Ihnen dann eine Callback URL und ein Verify Token. Füllen Sie die ersten drei Werte aus der verbundenen Nummer, lassen Sie das optionale App Secret von Typebot leer und setzen Sie Callback URL und Verify Token als Webhook-Ziel der Nummer.
Typebot führt die WhatsApp-Integration als Funktion des Pro-Tarifs, nicht der Tarife Free oder Starter.
Typebot prüft die Signatur des Webhooks nur, wenn zusammen mit den Zugangsdaten ein App Secret gespeichert ist.
Der Assistent von Typebot lehnt ein Token ab, dessen Ablauf nicht auf „nie“ gesetzt ist.
Fester Durchsatz für eine Nummer, die sowohl mit der WhatsApp Business App als auch mit der Cloud API genutzt wird.
Welche Typebot-Felder übernehmen Werte aus der verbundenen Nummer?
Der WhatsApp-Assistent von Typebot, im Tab Share eines Bots, fragt vier Angaben ab: ein App Secret, ein System User Token, eine WhatsApp Business Account ID und eine Phone number ID.
Drei davon stammen direkt aus der Verbindung. Das Dashboard zeigt für die Nummer die WABA-ID, die Phone number ID und das Zugriffstoken an, und das Tool get_api_credentials liefert dieselben Werte, wenn ein Assistent sie für Sie abruft. Fügen Sie sie in die passenden Felder ein.
Das App Secret lassen Sie leer. Typebot nutzt es bei eingehendem Datenverkehr für genau eine Sache: die Prüfung des Headers X-Hub-Signature-256, den Meta jeder Zustellung hinzufügt. Bei einer Nummer, die über einen Tech Provider verbunden ist, signiert Meta mit dem App Secret des Providers, das nie weitergegeben wird. Jeder Wert, den Sie dort eintragen, führt deshalb dazu, dass Typebot jede echte Nachricht ablehnt. Bleibt das Feld leer, überspringt Typebot diese Prüfung und akzeptiert die Zustellung.
Wohin gehören die Callback URL und das Verify Token von Typebot?
In das Webhook-Ziel der Nummer, nicht in das Dashboard einer Meta-App.
Der Assistent von Typebot fordert Sie auf, die Callback URL und das Verify Token in die WhatsApp-Einstellungen Ihrer eigenen Meta-App einzufügen. Bei Coexistence über EasyCoexistence ist keine App von Ihnen beteiligt: Meta leitet die Ereignisse der Nummer an das Ziel weiter, das in der Verbindung hinterlegt ist. Kopieren Sie also beide Werte aus dem letzten Schritt von Typebot und setzen Sie sie als Ziel, im Dashboard oder mit set_webhook_destination.
Meta sendet dann seine Verifizierungs-GET-Anfrage an Typebot, Typebot antwortet mit der Challenge, und ab diesem Moment erreicht jede Nachricht an die Nummer den Bot. Das Verify Token von Typebot ist nur einmal nutzbar: Es wird aus der Datenbank von Typebot gelöscht, sobald eine Verifizierung gelingt. Wenn Sie das Ziel später erneut setzen, erzeugen Sie vorher ein frisches Token, indem Sie den Assistenten noch einmal durchlaufen.
Wie geht der Bot mit dem 24-Stunden-Fenster um?
Typebot antwortet Personen, die ihm geschrieben haben, und damit bleibt fast jede Nachricht innerhalb des Kundenservicefensters. Meta öffnet jedes Mal ein 24-Stunden-Fenster, wenn ein Kunde schreibt, und darin kann jede Art von Servicenachricht ohne Template gesendet werden. Ein Bot, der nur antwortet, ist deshalb der einfache Fall.
Die Grenze ist ein Flow, der wartet. Ein Wait-Block oder eine Session, die fortgesetzt wird, nachdem der Kunde länger als einen Tag still war, versucht eine Freitextnachricht außerhalb des Fensters zu senden, und Meta weist sie mit dem Fehler 131047 ab. Das Session-Timeout von Typebot, standardmäßig 4 Stunden und bis zu 48 einstellbar, entscheidet, wann ein zurückkehrender Kunde einen neuen Chat beginnt, nicht ob Meta die Nachricht annimmt.
Weil es sich um Coexistence handelt, sieht das Team weiterhin jede Unterhaltung in der WhatsApp Business App und kann jederzeit vom Telefon aus eingreifen, wenn der Bot nicht antworten soll.
Häufige Fehler
- Ein Meta App Secret in Typebot eintragen. Die Zustellungen sind mit dem Secret des Tech Providers signiert, daher lehnt Typebot jede Nachricht wegen einer ungültigen Signatur ab.
- Ein altes Verify Token von Typebot wiederverwenden. Es wird nach einer erfolgreichen Verifizierung gelöscht, deshalb braucht das erneute Setzen des Ziels ein frisches Token aus dem Assistenten.
- Die Callback URL weitergeben. Ist die Signaturprüfung aus, lässt allein die Kenntnis der URL eine Anfrage durch, behandeln Sie sie also wie ein Passwort.
Verbinden Sie die Nummer auf easycoexistence.com, kopieren Sie Token, WABA-ID und Phone number ID in Typebot und setzen Sie die Callback URL von Typebot als Webhook-Ziel. Ab US$ 9 pro Nummer und Monat, mit wachsender Nummernzahl sinkend bis US$ 1, die ersten 3 Tage kostenlos.
Häufig gestellte Fragen
Brauche ich für Typebot eine eigene Meta-App?
Nein. Die Anleitung von Typebot setzt eine voraus, weil die meisten eine Nummer selbst verbinden. Bei Coexistence über einen Tech Provider stammen Token und IDs aus der Verbindung, und Meta leitet den Webhook an Typebot weiter.
Sieht das Team die Nachrichten des Bots weiterhin auf dem Telefon?
Ja. Nachrichten, die über die Cloud API gesendet werden, erscheinen in der WhatsApp Business App auf derselben Nummer, sodass eine Person den Verlauf lesen und übernehmen kann.
Können Typebot und n8n beide die Nachrichten derselben Nummer empfangen?
Nein. Eine Nummer hat ein Webhook-Ziel. Brauchen beide die Ereignisse, richten Sie das Ziel auf n8n und lassen Sie den Workflow die rohe Payload an die Callback URL von Typebot weiterleiten.
Speichert Typebot die Unterhaltungen?
Typebot behält seine eigenen Session- und Ergebnisdaten, wie auf jedem Kanal. EasyCoexistence speichert nie den Inhalt von Nachrichten: Meta liefert direkt an das Ziel, das Sie festlegen.
Weiterlesen
Bereit für den Start?
Richten Sie WhatsApp Coexistence in wenigen Minuten statt Monaten ein. Die App funktioniert weiterhin auf dem Telefon.
Kostenlose Testphase startenVerifiziert am