Vai alla navigazione
IntegrazioniGuide alla configurazioneCRM

HighLevel

Salva i chiamanti come contatti in HighLevel con uno strumento webhook.

HighLevel è noto anche come GoHighLevel e la sua API opera con il nome LeadConnector. Con uno strumento webhook, il tuo receptionist può salvare ogni chiamante come contatto nel tuo sotto-account HighLevel. Se il chiamante è già un contatto, HighLevel aggiorna il record esistente invece di crearne un duplicato.

Configurazione

1

Crea un token di integrazione privato

Nel tuo sotto-account HighLevel, apri Settings → Private Integrations e seleziona Create New Integration. Assegnagli un nome, seleziona solo gli ambiti per visualizzare e modificare i contatti, quindi crealo. Copia subito il token: HighLevel lo mostra una sola volta.

Se Private Integrations non è presente nelle impostazioni, chiedi all’amministratore della tua agenzia di concederti l’accesso.

2

Trova l’ID della sede

Apri Settings → Business Profile nello stesso sotto-account e copia il Location ID.

3

Crea lo strumento webhook

In Reception.ai, vai su Integrations, seleziona Add integration e scegli Webhook Tool.

CampoValore
Nomesave_highlevel_contact
Descrizione”Salva il chiamante come contatto nel nostro CRM quando conosci il suo nome e numero di telefono. Usalo in ogni chiamata di un cliente nuovo o esistente.”
MetodoPOST
URLhttps://services.leadconnectorhq.com/contacts/upsert
Header della richiestaAuthorization: Bearer seguito dal tuo token
Version: 2021-07-28
Parametri del bodylocationId (stringa, obbligatorio): “Sempre il valore esatto LOCATION_ID.”
firstName (stringa, obbligatorio): “Il nome del chiamante.”
lastName (stringa): “Il cognome del chiamante, se lo ha fornito.”
phone (stringa, obbligatorio): “Il numero di telefono del chiamante in formato internazionale, ad esempio +14155550123.”
email (stringa): “L’indirizzo email del chiamante, se lo ha fornito.”
source (stringa, obbligatorio): “Sempre il valore esatto Reception.ai phone call.”
Assegna agli agentiReceptionist

Sostituisci LOCATION_ID con l’ID che hai copiato. Seleziona Enable.

4

Verificalo

Testa il tuo receptionist con una chiamata in cui fornisci il tuo nome e numero. Il contatto comparirà in HighLevel in Contacts. Chiama di nuovo con lo stesso numero: HighLevel aggiornerà quel contatto invece di aggiungerne uno nuovo.

Il token può leggere e modificare i tuoi contatti. Non inserirlo in documenti condivisi ed elimina l’integrazione privata in HighLevel se viene esposto.

HighLevel stabilisce se un chiamante è già un contatto usando l’impostazione Allow Duplicate Contact del sotto-account. Se l’impostazione cerca corrispondenze sia nell’email sia nel telefono, li controlla nell’ordine indicato dall’impostazione.

Per fare altro dopo una chiamata, ad esempio aprire un’opportunità o avvisare il tuo team, crea un workflow HighLevel che inizi con il trigger Inbound Webhook. Indirizza un secondo strumento webhook all’URL del workflow con i campi necessari, quindi mappa questi campi nel workflow. Considera l’URL del workflow come un segreto. HighLevel indica Inbound Webhook come trigger premium, quindi controlla nel tuo piano eventuali costi di utilizzo.

Limitazioni

  • Il server MCP di HighLevel richiede un accesso OAuth, che Reception.ai non supporta, quindi usa lo strumento webhook.
  • I tag e i campi personalizzati sono elenchi nell’API di HighLevel e gli strumenti webhook inviano valori semplici. Impostali invece con un workflow.
  • L’aggiunta di note o attività richiede l’ID del contatto nell’URL, che uno strumento webhook non può inserire durante una chiamata. Per queste operazioni usa un workflow Inbound Webhook.

Risoluzione dei problemi

ProblemaCosa controllare
401 da HighLevelL’header Authorization deve essere Bearer seguito dal token, con uno spazio dopo Bearer.
403 da HighLevelIl token deve avere gli ambiti per i contatti e locationId deve corrispondere al sotto-account in cui è stato creato il token.
HighLevel rifiuta la versioneL’header Version deve essere esattamente 2021-07-28. Se la documentazione API di HighLevel indica un valore richiesto più recente, usa quello.
I chiamanti abituali sono duplicatiControlla l’impostazione Allow Duplicate Contact e che i numeri di telefono siano salvati nello stesso formato internazionale.
Il contatto non ha un nomeNella descrizione dello strumento, indica al receptionist di chiedere il nome del chiamante prima di salvarlo.