HighLevel | ElevenLabs Documentation

HighLevel staat ook bekend als GoHighLevel en de API werkt onder de naam LeadConnector. Met een webhooktool kan je receptionist elke beller als contact opslaan in je HighLevel-subaccount. Als de beller al een contact is, werkt HighLevel het bestaande record bij in plaats van een duplicaat te maken.

Instellen

Maak een token voor een private integratie

Open in je HighLevel-subaccount Settings → Private Integrations en selecteer Create New Integration. Geef de integratie een naam, selecteer alleen de scopes voor het bekijken en bewerken van contacten en maak de integratie. Kopieer de token meteen: HighLevel toont deze maar één keer.

Staat Private Integrations niet in je instellingen? Vraag je agencybeheerder dan om je hier toegang toe te geven.

Zoek je locatie-ID

Open Settings → Business Profile in hetzelfde subaccount en kopieer de Location ID.

Maak de webhooktool

Ga in Reception.ai naar Integrations, selecteer Add integration en kies Webhook Tool.

Veld	Waarde
Naam	`save_highlevel_contact`
Beschrijving	”Sla de beller op als contact in onze CRM zodra je de naam en het telefoonnummer weet. Gebruik dit bij elk gesprek met een nieuwe of terugkerende klant.”
Methode	POST
URL	`https://services.leadconnectorhq.com/contacts/upsert`
Requestheaders	`Authorization`: `Bearer` gevolgd door je token `Version`: `2021-07-28`
Bodyparameters	`locationId` (string, vereist): “Altijd precies de waarde `LOCATION_ID`.” `firstName` (string, vereist): “De voornaam van de beller.” `lastName` (string): “De achternaam van de beller, als die deze heeft gegeven.” `phone` (string, vereist): “Het telefoonnummer van de beller in internationaal formaat, bijvoorbeeld +14155550123.” `email` (string): “Het e-mailadres van de beller, als die dit heeft gegeven.” `source` (string, vereist): “Altijd precies de waarde `Reception.ai phone call`.”
Toewijzen aan agents	Receptionist

Vervang LOCATION_ID door de ID die je hebt gekopieerd. Selecteer Enable.

Testen

Test je receptionist met een gesprek waarin je je naam en nummer geeft. Het contact verschijnt in HighLevel onder Contacts. Bel opnieuw met hetzelfde nummer: HighLevel werkt dat contact bij in plaats van een nieuw contact toe te voegen.

De token kan je contacten lezen en wijzigen. Bewaar deze niet in gedeelde documenten en verwijder de private integratie in HighLevel als de token uitlekt.

HighLevel bepaalt aan de hand van de instelling Allow Duplicate Contact van het subaccount of een beller al een contact is. Als die instelling overeenkomsten zoekt op zowel e-mail als telefoon, controleert HighLevel deze in de volgorde die in de instelling staat.

Wil je na een gesprek meer doen, zoals een opportunity openen of je team waarschuwen, maak dan een HighLevel- workflow die begint met de trigger Inbound Webhook. Richt een tweede webhooktool op de URL van de workflow met de velden die je nodig hebt en koppel die velden vervolgens in de workflow. Behandel de workflow-URL als een geheim. HighLevel vermeldt Inbound Webhook als premium trigger, dus controleer je abonnement op gebruikskosten.

Beperkingen

De MCP-server van HighLevel vereist een OAuth-aanmelding, die Reception.ai niet ondersteunt. Gebruik daarom de webhooktool.
Tags en aangepaste velden zijn lijsten in de API van HighLevel, terwijl webhooktools platte waarden versturen. Stel deze in met een workflow.
Voor het toevoegen van notities of taken is de ID van het contact in de URL nodig. Een webhooktool kan die tijdens een gesprek niet invullen. Gebruik hiervoor een Inbound Webhook-workflow.

Problemen oplossen

Probleem	Wat je moet controleren
401 van HighLevel	De header `Authorization` moet `Bearer` gevolgd door de token zijn, met een spatie na `Bearer`.
403 van HighLevel	De token heeft de contactscopes nodig en `locationId` moet het subaccount zijn waarin de token is gemaakt.
HighLevel weigert de versie	De header `Version` moet precies `2021-07-28` zijn. Als de API-documentatie van HighLevel een nieuwere vereiste waarde vermeldt, gebruik je die.
Terugkerende bellers worden gedupliceerd	Controleer de instelling Allow Duplicate Contact en of telefoonnummers in hetzelfde internationale formaat zijn opgeslagen.
Het contact heeft geen naam	Zorg dat in de beschrijving van de tool staat dat de receptionist vóór het opslaan naar de naam van de beller moet vragen.