Eine Coexistence-Nummer als WhatsApp-Cloud-Posteingang in Chatwoot nutzen

Wie verbinden Sie eine Coexistence-Nummer mit Chatwoot?

An zwei Stellen, in dieser Reihenfolge.

Fügen Sie in Chatwoot einen Posteingang hinzu, wählen Sie WhatsApp und dann den Anbieter WhatsApp Cloud mit manueller Einrichtung. Tragen Sie die Nummer, die ID der Telefonnummer, die WABA-ID und das Zugriffs-Token ein. Alle Werte zeigt das EasyCoexistence-Dashboard bei der Verbindung an, oder get_api_credentials liefert sie an einen Assistenten. Chatwoot zeigt dann für den Posteingang eine Webhook-URL und ein Verify-Token an.

Setzen Sie in EasyCoexistence das Webhook-Ziel der Nummer auf diese URL und tragen Sie dasselbe Verify-Token ein. Meta schickt seine Verifizierungsanfrage an Chatwoot, Chatwoot beantwortet sie, und ab dann landet jede Nachricht an die Nummer im Posteingang. Dazwischen läuft nichts, also gibt es keinen Workflow, der am Leben gehalten werden muss.

Erscheinen Antworten vom Telefon auch in Chatwoot?

Ja. Bei einer Coexistence-Nummer meldet Meta eine in der WhatsApp-Business-App getippte Antwort als Ereignis smb_message_echoes. Der Webhook-Job von Chatwoot erkennt dieses Feld und speichert die Nachricht als ausgehend in der richtigen Unterhaltung. Der Quellcode beschreibt den Fall direkt: Unternehmen, die sowohl aus Chatwoot als auch aus der App antworten, mit Nachrichten, die nach Chatwoot synchronisiert werden.

Dadurch funktioniert die Aufteilung in der Praxis. Die Inhaberin oder der Inhaber kann Stammkunden weiter vom Telefon aus antworten, das Team bearbeitet am Schreibtisch den gemeinsamen Posteingang, und jede Seite sieht, was die andere gesendet hat, ohne dass jemand Screenshots weiterleitet.

Nachrichten, die aus Chatwoot gesendet werden, gehen über die Cloud API von derselben Nummer aus, erscheinen also ebenfalls auf dem Telefon.

Warum sollte der Chatwoot-Posteingang kein App-Secret haben?

Weil die Zustellungen mit einem Secret signiert werden, das Sie nicht besitzen. Meta signiert jeden Webhook mit dem App-Secret der App, der das Abonnement gehört, also der EasyCoexistence-App, und dieses Secret wird nie weitergegeben.

Im aktuellen Quellcode von Chatwoot wird der Header X-Hub-Signature-256 bei einem manuell eingerichteten WhatsApp-Cloud-Kanal nur geprüft, wenn dort ein App-Secret gespeichert ist oder wenn der Kanal über das eigene Embedded Signup von Chatwoot angelegt wurde. Ein manueller Posteingang ohne App-Secret akzeptiert die Zustellungen, einer mit beliebigem App-Secret weist jede als nicht autorisiert ab.

Den Schutz bietet hier das Verify-Token. Wählen Sie einen langen Zufallswert, denn daran erkennt Chatwoot die Verifizierungsanfrage von Meta und unterscheidet sie von fremden Anfragen.

Was kann Chatwoot mit dieser Nummer nicht?

Webhooks gleichzeitig an einer zweiten Stelle empfangen. Meta leitet die Webhooks einer Nummer an ein einziges Ziel, solange Chatwoot es belegt, bekommt ein n8n-Workflow dieselben Ereignisse also nicht. Brauchen Sie beides, richten Sie das Ziel auf ein kleines eigenes Relay, das jede Zustellung an Chatwoot und an den Workflow weitergibt.

Die Grenzen von Coexistence gelten wie überall: Die API sendet bis zu 20 Nachrichten pro Sekunde, Freitext geht nur innerhalb von 24 Stunden nach der letzten Nachricht des Kunden hinaus, und danach decken Templates alles ab.

Die WhatsApp-Business-App muss weiterhin mindestens alle 14 Tage geöffnet werden, worauf EasyCoexistence achtet.

Häufige Fehler

• Ein App-Secret im Chatwoot-Posteingang eintragen. Die Zustellungen werden mit dem Secret der EasyCoexistence-App signiert, daher weist Chatwoot jede als nicht autorisiert ab.
• In EasyCoexistence ein anderes Verify-Token verwenden als das, das Chatwoot anzeigt. Die Verifizierung durch Meta schlägt fehl, und der Posteingang erhält nie eine Nachricht.
• Das Embedded Signup von Chatwoot statt der manuellen Einrichtung wählen. Dann wird die Nummer über die eigene Meta-App von Chatwoot verbunden, also über eine getrennte Verbindung.

Häufig gestellte Fragen

Weiterlesen