> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# HighLevel

HighLevel ist auch als GoHighLevel bekannt, und seine API läuft unter dem Namen LeadConnector. Mit einem [Webhook-Tool](/docs/de/reception-ai/integrations/webhooks) 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](/docs/de/reception-ai/receptionist/testing) 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.

> **Warning**
>
> 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.

> **Tip**
>
> 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.                                     |