WhatsApp mit Activepieces auf einer Coexistence-Nummer verbinden

Wie verbinden Sie eine Coexistence-Nummer mit Activepieces?

Legen Sie in Activepieces die WhatsApp-Business-Verbindung mit zwei Werten an: dem Token und der WhatsApp Business Account ID. Das EasyCoexistence-Dashboard zeigt beide für die Verbindung an, und get_api_credentials liefert sie an einen Assistenten. Die Anleitung des Pieces spricht davon, eine Meta-App und einen Systemnutzer zu erstellen, weil sie beides als nicht vorhanden annimmt. Hier ist die Nummer bereits verbunden, also fügen Sie direkt die Werte ein.

Bauen Sie dann einen Flow, der mit dem Trigger für eingehende Nachrichten beginnt, legen Sie dort ein Verify-Token Ihrer Wahl fest und veröffentlichen Sie den Flow. Kopieren Sie die Webhook-URL des Triggers mit demselben Verify-Token in das Webhook-Ziel der Nummer in EasyCoexistence. Meta sendet seine Verifizierungsanfrage, der Trigger beantwortet sie, und jede Nachricht an die Nummer startet einen Durchlauf.

Warum muss das App Secret leer bleiben?

Weil das Secret, mit dem diese Zustellungen signiert werden, nicht Ihnen gehört. Meta signiert jeden Webhook mit dem App Secret der App, der das Abonnement gehört, und bei einer über EasyCoexistence verbundenen Nummer ist das die EasyCoexistence-App, deren Secret nie weitergegeben wird.

Das Piece behandelt das Feld als optional. Bleibt es leer, nehmen die Trigger Zustellungen unverändert an. Mit dem Secret einer anderen App gefüllt, scheitert jede Zustellung an der Prüfung von X-Hub-Signature-256 und wird stillschweigend ignoriert, was genau so aussieht, als kämen keine Nachrichten an.

Das Verify-Token hält Fremde aus dem Handshake heraus. Wählen Sie einen langen Zufallswert und halten Sie die Trigger-URL privat, denn sie ist die Adresse, die Ihren Flow startet.

Was kann ein Flow tun, sobald eine Nachricht eintrifft?

Der Trigger übergibt dem Flow eine abgeflachte Nachricht: Absender, Profilname, Nachrichten-ID, Typ, Text, gegebenenfalls Medien-ID, Antworten auf Buttons und Listen sowie die ID der empfangenden Telefonnummer. Von dort an ist es ein gewöhnlicher Activepieces-Flow über dessen andere Pieces hinweg, etwa ein CRM, eine Tabelle oder ein KI-Schritt.

Antworten laufen über dasselbe Piece. Die Aktion zum Senden von Nachrichten verschickt Freitext und liefert nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden aus. Die Aktion für Template-Nachrichten sendet ein freigegebenes Template, und nur das wird nach Ablauf dieses Fensters zugestellt. Interaktive Buttons, Listen, Medien, Standort und Reaktionen sind eigene Aktionen.

Die Anleitung von Activepieces weist darauf hin, dass Meta pro App nur eine Callback-URL akzeptiert. Mit Zielen pro Nummer gilt die Grenze von einer URL pro Nummer, daher sollte ein Flow, der mehrere Ereignistypen behandeln muss, innerhalb eines Flows verzweigen.

Erreichen auf dem Telefon getippte Antworten den Flow?

Sie erreichen den Webhook, aber nicht diesen Trigger. Bei einer Coexistence-Nummer sendet Meta ein Echo jeder in der WhatsApp-Business-App getippten Antwort an dasselbe Ziel, unter dem Feld smb_message_echoes. Der Trigger für eingehende Nachrichten liest nur das Feld messages und verwirft alles andere.

Brauchen Sie die Antworten vom Telefon im Flow, starten Sie ihn stattdessen mit dem generischen Webhook-Piece von Activepieces, das jede HTTP-Methode akzeptiert, und beantworten Sie das GET zur Verifizierung mit einem Rückgabe-Schritt auf der synchronen URL. Die rohe Payload werten Sie dann selbst aus, beide Felder eingeschlossen.

Für die meisten Flows ist der Trigger des Pieces die einfachere Wahl: Er reagiert auf Kunden, und die Antworten des Teams bleiben in der App auf dem Telefon sichtbar.

Häufige Fehler

• Ein App Secret in die WhatsApp-Verbindung einfügen. Zustellungen werden mit dem Secret der EasyCoexistence-App signiert, daher wird jede ignoriert.
• Das Ziel setzen, bevor der Flow veröffentlicht ist. Meta verifiziert sofort, und ein unveröffentlichter Flow kann nicht antworten.
• Erwarten, dass der Trigger für eingehende Nachrichten auf dem Telefon getippte Antworten sieht. Er liest nur das Feld messages, nicht smb_message_echoes.

Häufig gestellte Fragen

Weiterlesen