Naar navigatie springen

HighLevel

Sla bellers op als contacten in HighLevel en leg notities en opvolgtaken vast met webhooktools.

HighLevel staat ook bekend als GoHighLevel en de API werkt onder de naam LeadConnector. Met webhook tools kan je receptionist elke beller als contact opslaan in je HighLevel-subaccount, noteren wat diegene wilde en een opvolgtaak voor je team maken. Als de beller al een contact is, werkt HighLevel het bestaande record bij in plaats van een duplicaat te maken.

Instellen

1

Maak een token voor een private integratie

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

Als Private Integrations niet in je instellingen staat, vraag je agencybeheerder dan om je toegang te geven.

2

Zoek je locatie-ID

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

3

Maak de contacttool

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

VeldWaarde
Naamsave_highlevel_contact
Beschrijving”Sla de beller op als contact in onze CRM zodra je hun naam en telefoonnummer weet. Gebruik deze tool bij elk gesprek met een nieuwe of terugkerende klant. Geef de contact-id die de tool terugstuurt door aan de tools voor notities en taken.”
MethodePOST
URLhttps://services.leadconnectorhq.com/contacts/upsert
RequestheadersAuthorization (Secret): Bearer gevolgd door je token
Version (Value): 2021-07-28
BodyparameterslocationId (string, vaste waarde): je locatie-ID
firstName (string, verplicht): “De voornaam van de beller.”
lastName (string): “De achternaam van de beller, als die is opgegeven.”
phone (string, verplicht): “Het telefoonnummer van de beller in internationale indeling, bijvoorbeeld +14155550123.”
email (string): “Het e-mailadres van de beller, als die is opgegeven.”
source (string, vaste waarde): Reception.ai phone call
Toewijzen aan agentsReceptionist

Selecteer Enable. Het antwoord van HighLevel bevat de id van het contact, die je receptionist doorgeeft aan de volgende twee tools.

4

Maak de notitietool

Voeg nog een webhook tool toe:

VeldWaarde
Naamadd_highlevel_note
Beschrijving”Noteer wat de beller wilde bij het contact, nadat je diegene hebt opgeslagen met save_highlevel_contact.”
MethodePOST
URLhttps://services.leadconnectorhq.com/contacts/{contactId}/notes
RequestheadersAuthorization (Secret): Bearer gevolgd door je token
Version (Value): 2021-07-28
PadparameterscontactId (string, verplicht): “De contact-id uit het antwoord van save_highlevel_contact.”
Bodyparametersbody (string, verplicht): “Wat de beller wilde, in een paar zinnen.”
Toewijzen aan agentsReceptionist

Selecteer Enable.

5

Maak de takentool

Voeg een derde webhook tool toe:

VeldWaarde
Naamcreate_highlevel_task
Beschrijving”Maak een opvolgtaak wanneer je de beller belooft terug te bellen, nadat je diegene hebt opgeslagen met save_highlevel_contact.”
MethodePOST
URLhttps://services.leadconnectorhq.com/contacts/{contactId}/tasks
RequestheadersAuthorization (Secret): Bearer gevolgd door je token
Version (Value): 2021-07-28
PadparameterscontactId (string, verplicht): “De contact-id uit het antwoord van save_highlevel_contact.”
Bodyparameterstitle (string, verplicht): “Bijvoorbeeld: Bel Jane Doe terug over een offerte.”
body (string): “De naam en het telefoonnummer van de beller, en wat diegene nodig heeft.”
dueDate (string, verplicht): “Wanneer het team moet terugbellen, als ISO 8601-datum en -tijd, bijvoorbeeld 2026-06-21T11:00:00Z.”
completed (boolean, vaste waarde): false
Toewijzen aan agentsReceptionist

Selecteer Enable. De taak is niet aan iemand toegewezen, dus controleer nieuwe taken regelmatig of wijs ze toe met een workflow.

6

Testen

Test je receptionist met een gesprek waarin je je naam en nummer doorgeeft en vraagt om teruggebeld te worden. Het contact verschijnt in HighLevel onder Contacts, met een notitie en een taak. Bel opnieuw met hetzelfde nummer: HighLevel werkt dat contact bij in plaats van een nieuw contact toe te voegen.

Het token kan je contacten lezen en wijzigen. Bewaar het niet in gedeelde documenten en verwijder de private integratie in HighLevel als het 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 zowel op e-mail als telefoonnummer overeenkomsten zoekt, controleert HighLevel die in de volgorde die in de instelling staat.

Als je na een gesprek meer wilt doen, zoals een opportunity openen of je team waarschuwen, maak dan een HighLevel- workflow die begint met de trigger Inbound Webhook. Laat een tweede webhook tool verwijzen naar 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 een premium trigger, dus controleer je abonnement op gebruikskosten.

Beperkingen

  • De MCP-server van HighLevel vereist een OAuth-login, die Reception.ai niet ondersteunt. Gebruik daarom webhook tools.
  • De contacttool stelt geen tags in. HighLevel vervangt alle bestaande tags van een contact door de verzonden tags, en een webhook tool kan de waarden van een lijst niet vastzetten, dus je receptionist zou ze kiezen. Voeg tags in plaats daarvan toe met een workflow.
  • De contacttool stelt geen aangepaste velden in. Elk veld heeft de interne ID van het veld nodig, dus het is eenvoudiger om ze met een workflow in te stellen.

Problemen oplossen

ProbleemWat je moet controleren
401 van HighLevelDe header Authorization moet Bearer gevolgd door het token zijn, met een spatie na Bearer.
403 van HighLevelHet token heeft de contactscopes nodig en locationId moet het subaccount zijn waarin het token is gemaakt.
Notities of taken mislukken met 404 of 422De receptionist moet de contact-id uit het antwoord van save_highlevel_contact doorgeven als contactId. Vermeld dit in de beschrijving van elke tool.
HighLevel weigert de versie2021-07-28 wordt nog steeds ondersteund. De huidige referentie van HighLevel vermeldt v3; als HighLevel 2021-07-28 weigert, stel je Version bij alle drie de tools in op v3.
Terugkerende bellers worden gedupliceerdControleer de instelling Allow Duplicate Contact en of telefoonnummers in dezelfde internationale indeling zijn opgeslagen.
Het contact heeft geen naamLaat de beschrijving van de tool de receptionist vertellen om vóór het opslaan naar de naam van de beller te vragen.