WhatsApp mit GoHighLevel-Kontakten auf einer Coexistence-Nummer verbinden

Wie gelangt eine WhatsApp-Nachricht zu einem HighLevel-Kontakt?

Meta sendet jede Nachricht an die Nummer per POST an das von Ihnen festgelegte Webhook-Ziel, hier ein n8n-Webhook-Node. Der Workflow übergibt die Nummer des Absenders und dessen WhatsApp-Profilnamen an den HighLevel-Node von n8n. Dessen Kontakt-Ressource bietet eine Operation zum Anlegen oder Aktualisieren: Ein neuer Absender wird zum Kontakt, ein bekannter wird gefunden statt dupliziert.

Mit der Kontakt-ID sendet ein HTTP-Anfrage-Node den Text der Nachricht per POST an /contacts/{contactId}/notes. Die Notiz erscheint im Kontaktdatensatz, und jeder, der ihn öffnet, sieht, was der Kunde geschrieben hat. Erfordert die Nachricht eine Nachverfolgung, kann der HighLevel-Node außerdem eine Aufgabe am Kontakt oder eine Opportunity in einer Pipeline anlegen. Beides unterstützt er direkt.

Das Team antwortet währenddessen weiter aus der WhatsApp Business App.

Welches Token sollte der Workflow verwenden?

Ein Private-Integration-Token. Die API v2 von HighLevel erreichen Sie entweder per OAuth oder mit einem solchen Token, und die alten API-Schlüssel der v1 sind abgekündigt. Ein Private-Integration-Token erstellen Sie in den Einstellungen des Unterkontos, es ist auf die angehakten Berechtigungen begrenzt und wird wie jedes Access-Token im Authorization-Header gesendet.

Es erneuert sich nicht selbst, was zu einer Automatisierung passt: Es funktioniert, bis jemand es rotiert. Wenn Sie es rotieren, hält HighLevel das alte und das neue Token sieben Tage lang gleichzeitig gültig. In diesem Zeitfenster tragen Sie das neue Token in n8n ein, bevor das alte ausläuft.

Wählen Sie nur die Scopes aus, die der Workflow braucht: Kontakte, Notizen und, falls Sie sie nutzen, Opportunities und Aufgaben. Finden Sie Private Integrations nicht in den Einstellungen, müssen Sie die Funktion laut HighLevel in den Labs aktivieren.

Wie bedient ein Workflow mehrere Kunden-Unterkonten?

Durch Routing anhand der empfangenden Nummer. Jeder Webhook von Meta enthält die phone_number_id der Unternehmensnummer, die die Nachricht empfangen hat. Richten Sie die Nummern aller Kunden auf denselben n8n-Webhook, führen Sie eine kleine Tabelle, die jede phone_number_id dem Unterkonto des Kunden und dessen Token zuordnet, und schlagen Sie das Token zu Beginn jedes Durchlaufs nach.

So pflegen Sie nur einen Workflow für alle Kunden, was für eine Agentur wichtiger ist als für jeden anderen. Eine Korrektur an der Zuordnungslogik oder am Notizformat gilt sofort für alle.

Die Ratenlimits werden pro App und Unterkonto gezählt, sodass sich Kunden das Kontingent nicht gegenseitig wegnehmen: Jeder erhält seine eigenen 100 Anfragen pro zehn Sekunden und 200.000 pro Tag.

Gelangen am Telefon getippte Antworten zu HighLevel?

Ja, das ist möglich. Auf einer Coexistence-Nummer bleibt die WhatsApp Business App im Einsatz. Antwortet jemand darüber, sendet Meta ein Echo der ausgehenden Nachricht an dasselbe Webhook-Ziel, im Feld smb_message_echoes.

Fügen Sie für diese Echos einen eigenen Zweig hinzu und schreiben Sie sie als Notizen, die als gesendet markiert sind. Der Kontaktdatensatz enthält dann die Zeilen des Kunden und die Antworten des Unternehmens in der richtigen Reihenfolge, genau das, was ein Kunde im CRM zu sehen erwartet.

Sendet der Workflow selbst eine Nachricht über die Cloud API, etwa ein genehmigtes Template nach einer Terminbuchung, schreiben Sie die Notiz im Moment des Sendens. Der Workflow kennt den Text und die Kontakt-ID bereits.

Häufige Fehler

• Einen API-Schlüssel der v1 verwenden. Die v1-API von HighLevel ist abgekündigt, die API v2 erfordert ein Private-Integration-Token oder OAuth.
• Das Private-Integration-Token rotieren, ohne n8n innerhalb der siebentägigen Überlappung zu aktualisieren. Sobald das alte Token abläuft, schlägt jeder Aufruf fehl.
• Die Nachrichten aller Kunden mit dem Token eines einzigen Unterkontos schreiben. Ordnen Sie zuerst phone_number_id dem richtigen Unterkonto zu, sonst landen Datensätze beim falschen Kunden.

Häufig gestellte Fragen

Weiterlesen