WhatsApp mit Bitrix24 CRM auf einer Coexistence-Nummer verbinden

Wie spricht n8n mit Bitrix24?

Über einen eingehenden Webhook, der in Bitrix24 kein Empfänger ist, sondern eine Zugangsberechtigung. Sie erstellen ihn in den Entwicklerressourcen von Bitrix24, legen die erlaubten Scopes fest und erhalten eine URL mit Ihrer Portaladresse, der ID des Benutzers, der ihn erstellt hat, und einem geheimen Code. Hängen Sie einen Methodennamen an diese URL, wird die REST-API als dieser Benutzer aufgerufen, mit dessen Berechtigungen.

In n8n ist deshalb jeder Bitrix24-Schritt ein HTTP-Anfrage-Node, der an diese URL plus eine Methode wie crm.lead.add.json sendet. Es gibt keinen OAuth-Ablauf und keine App, die veröffentlicht werden muss. Geben Sie dem Webhook nur den CRM-Scope und erstellen Sie ihn mit einem Benutzer, dessen Berechtigungen die Leads und Kontakte abdecken, die der Workflow sehen muss, denn Bitrix24 prüft den Zugriff als dieser Benutzer.

Welche Bitrix24-Methoden ruft der Workflow auf?

Drei, nacheinander, nachdem der n8n-Webhook-Node die Nachricht von Meta erhalten hat.

crm.duplicate.findbycomm mit dem Typ PHONE und der Nummer des Absenders liefert die IDs aller Leads, Kontakte und Unternehmen, die diese Nummer führen. Diese Suche ist die richtige, weil sie alle drei gleichzeitig durchsucht und für den Abgleich von Kommunikationsdaten gebaut ist, nicht für ein Textfeld.

Liefert sie nichts zurück, legt crm.lead.add einen Lead an, mit dem WhatsApp-Profilnamen als Titel und der Nummer im Telefonfeld. Danach schreibt crm.timeline.comment.add den Nachrichtentext als Kommentar zum Datensatz und erwartet ENTITY_TYPE, ENTITY_ID und COMMENT. Der Kommentar erscheint in der Timeline des Datensatzes neben Anrufen und E-Mails, genau dort, wo Vertriebsmitarbeiter ohnehin nachsehen.

POST https://yourcompany.bitrix24.com/rest/1/<secret>/crm.duplicate.findbycomm.json
{ "type": "PHONE", "values": ["14155550188"] }

POST .../crm.lead.add.json
{ "fields": { "TITLE": "WhatsApp: Maria", "PHONE": [{ "VALUE": "14155550188", "VALUE_TYPE": "MOBILE" }] } }

POST .../crm.timeline.comment.add.json
{ "fields": { "ENTITY_TYPE": "lead", "ENTITY_ID": 4211, "COMMENT": "do you have anything friday?" } }

Wie wirkt sich das Ratenlimit auf den Workflow aus?

Bitrix24 misst REST-Aufrufe mit einem Leaky Bucket. Jede Anfrage erhöht einen Zähler, der Zähler sinkt pro Sekunde mit fester Rate, und sobald er einen Schwellenwert überschreitet, erhält die nächste Anfrage ein 503 mit QUERY_LIMIT_EXCEEDED. Bei Enterprise-Tarifen sinkt der Zähler um 5 pro Sekunde bei einem Schwellenwert von 250, bei allen anderen Tarifen um 2 bei einem Schwellenwert von 50.

Jede eingehende Nachricht kostet zwei oder drei Aufrufe, ein gleichmäßiges Rinnsal kommt dem also nie nahe. Ein Schwall schon: Fünfzig Kunden, die innerhalb einer Minute auf dasselbe Template antworten, sind bis zu 150 Aufrufe. Stellen Sie die HTTP-Anfrage-Nodes auf Wiederholung bei Fehlschlag mit kurzer Wartezeit ein und lassen Sie die Ausführungen des Workflows nacheinander laufen, damit ein Schwall in Bitrix24 abfließt, statt daran abzuprallen.

Gelangen am Telefon getippte Antworten nach Bitrix24?

Ja, das ist möglich. Bei einer Coexistence-Nummer funktioniert die WhatsApp Business App weiter, und wenn jemand darin antwortet, sendet Meta ein Echo der ausgehenden Nachricht an dasselbe Webhook-Ziel, im Feld smb_message_echoes.

Ein zweiter Zweig im Workflow behandelt diese Echos wie eingehende Nachrichten, wobei der Kommentar als ausgehend markiert wird. Der Datensatz zeigt dann die vollständige Unterhaltung, mit den Zeilen des Kunden und den Antworten des Shops in der richtigen Reihenfolge.

Antworten, die der Workflow selbst über die Cloud API sendet, liegen dem Workflow beim Versand bereits vor. Protokollieren Sie sie deshalb in diesem Moment, statt auf einen zurückkommenden Webhook zu warten.

Häufige Fehler

• Die URL des eingehenden Webhooks in clientseitigen Code oder ein geteiltes Dokument einfügen. Das darin enthaltene Secret gewährt alle Scopes, die dem Webhook erteilt wurden.
• Den Webhook mit einem Benutzer erstellen, der nicht alle Leads sehen kann. Die Suche übersieht dann Datensätze, und der Workflow legt Duplikate an.
• Einen Schwall von Aufrufen ohne Wiederholungen senden. Bitrix24 antwortet mit 503 QUERY_LIMIT_EXCEEDED, und diese Nachrichten erreichen die Timeline nie.

Häufig gestellte Fragen

Weiterlesen