HighLevel | ElevenLabs Documentation

HighLevel ist auch als GoHighLevel bekannt, und seine API läuft unter dem Namen LeadConnector. Mit einem Webhook-Tool kann Ihre Rezeption jeden Anrufer als Kontakt in Ihrem HighLevel-Unterkonto speichern. Ist der Anrufer bereits ein Kontakt, aktualisiert HighLevel den vorhandenen Datensatz, statt ein Duplikat zu erstellen.

Einrichtung

Privates Integrationstoken erstellen

Öffnen Sie in Ihrem HighLevel-Unterkonto Settings → Private Integrations und wählen Sie Create New Integration. Geben Sie ihr einen Namen, wählen Sie nur die Berechtigungen zum Anzeigen und Bearbeiten von Kontakten aus und erstellen Sie die Integration. Kopieren Sie das Token sofort: HighLevel zeigt es nur einmal an.

Wenn Private Integrations in Ihren Einstellungen nicht vorhanden ist, bitten Sie Ihren Agenturadministrator, Ihnen Zugriff darauf zu geben.

Ihre Standort-ID finden

Öffnen Sie im selben Unterkonto Settings → Business Profile und kopieren Sie die Location ID.

Webhook-Tool erstellen

Gehen Sie in Reception.ai zu Integrations, wählen Sie Add integration und dann Webhook Tool.

Feld	Wert
Name	`save_highlevel_contact`
Beschreibung	”Speichern Sie den Anrufer als Kontakt in unserem CRM, sobald Sie seinen Namen und seine Telefonnummer kennen. Verwenden Sie dies bei jedem Anruf eines neuen oder wiederkehrenden Kunden.”
Methode	POST
URL	`https://services.leadconnectorhq.com/contacts/upsert`
Request Headers	`Authorization`: `Bearer` gefolgt von Ihrem Token `Version`: `2021-07-28`
Body Parameters	`locationId` (String, erforderlich): “Immer exakt der Wert `LOCATION_ID`.” `firstName` (String, erforderlich): “Der Vorname des Anrufers.” `lastName` (String): “Der Nachname des Anrufers, falls er ihn genannt hat.” `phone` (String, erforderlich): “Die Telefonnummer des Anrufers im internationalen Format, zum Beispiel +14155550123.” `email` (String): “Die E-Mail-Adresse des Anrufers, falls er sie genannt hat.” `source` (String, erforderlich): “Immer exakt der Wert `Reception.ai phone call`.”
Agenten zuweisen	Receptionist

Ersetzen Sie LOCATION_ID durch die kopierte ID. Wählen Sie Enable.

Testen

Testen Sie Ihre Rezeption mit einem Anruf, bei dem Sie Ihren Namen und Ihre Nummer angeben. Der Kontakt erscheint in HighLevel unter Contacts. Rufen Sie erneut mit derselben Nummer an: HighLevel aktualisiert diesen Kontakt, statt einen neuen hinzuzufügen.

Das Token kann Ihre Kontakte lesen und ändern. Bewahren Sie es nicht in freigegebenen Dokumenten auf und löschen Sie die private Integration in HighLevel, falls es offengelegt wird.

HighLevel entscheidet anhand der Einstellung Allow Duplicate Contact des Unterkontos, ob ein Anrufer bereits ein Kontakt ist. Wenn diese Einstellung sowohl E-Mail als auch Telefonnummer abgleicht, prüft HighLevel sie in der dort aufgeführten Reihenfolge.

Um nach einem Anruf weitere Aktionen auszuführen, etwa eine Opportunity zu eröffnen oder Ihr Team zu benachrichtigen, erstellen Sie einen HighLevel- Workflow, der mit dem Trigger Inbound Webhook beginnt. Richten Sie ein zweites Webhook-Tool auf die URL des Workflows mit den benötigten Feldern aus und ordnen Sie diese Felder dann im Workflow zu. Behandeln Sie die Workflow-URL als Geheimnis. HighLevel führt Inbound Webhook als Premium-Trigger auf. Prüfen Sie daher Ihren Tarif auf Nutzungsgebühren.

Einschränkungen

Der MCP-Server von HighLevel erfordert eine OAuth-Anmeldung, die Reception.ai nicht unterstützt. Verwenden Sie daher das Webhook-Tool.
Tags und benutzerdefinierte Felder sind in der API von HighLevel Listen, während Webhook-Tools flache Werte senden. Legen Sie sie stattdessen mit einem Workflow fest.
Das Hinzufügen von Notizen oder Aufgaben erfordert die ID des Kontakts in der URL, die ein Webhook-Tool während eines Anrufs nicht einfügen kann. Verwenden Sie dafür einen Inbound Webhook-Workflow.

Fehlerbehebung

Problem	Prüfen Sie
401 von HighLevel	Der Header `Authorization` muss `Bearer` gefolgt vom Token sein, mit einem Leerzeichen nach `Bearer`.
403 von HighLevel	Das Token benötigt die Kontaktberechtigungen, und `locationId` muss das Unterkonto sein, in dem das Token erstellt wurde.
HighLevel lehnt die Version ab	Der Header `Version` muss exakt `2021-07-28` sein. Wenn die API-Dokumentation von HighLevel einen neueren erforderlichen Wert nennt, verwenden Sie diesen.
Wiederkehrende Anrufer werden dupliziert	Prüfen Sie die Einstellung Allow Duplicate Contact und ob Telefonnummern im selben internationalen Format gespeichert sind.
Der Kontakt hat keinen Namen	Lassen Sie die Beschreibung des Tools die Rezeption anweisen, vor dem Speichern nach dem Namen des Anrufers zu fragen.