> 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 è noto anche come GoHighLevel e la sua API opera con il nome LeadConnector. Con uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks), 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 ### 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. ### Trova l'ID della sede Apri **Settings** → **Business Profile** nello stesso sotto-account e copia il **Location ID**. ### Crea lo strumento webhook In Reception.ai, vai su **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**. | Campo | Valore | | -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `save_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." | | **Metodo** | POST | | **URL** | `https://services.leadconnectorhq.com/contacts/upsert` | | **Header della richiesta** | `Authorization`: `Bearer ` seguito dal tuo token `Version`: `2021-07-28` | | **Parametri del body** | `locationId` (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 agenti** | **Receptionist** | Sostituisci `LOCATION_ID` con l'ID che hai copiato. Seleziona **Enable**. ### Verificalo [Testa il tuo receptionist](/docs/it/reception-ai/receptionist/testing) 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. > **Warning** > > 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. > **Tip** > > 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 | Problema | Cosa controllare | | ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 da HighLevel | L'header `Authorization` deve essere `Bearer ` seguito dal token, con uno spazio dopo `Bearer`. | | 403 da HighLevel | Il token deve avere gli ambiti per i contatti e `locationId` deve corrispondere al sotto-account in cui è stato creato il token. | | HighLevel rifiuta la versione | L'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 duplicati | Controlla l'impostazione **Allow Duplicate Contact** e che i numeri di telefono siano salvati nello stesso formato internazionale. | | Il contatto non ha un nome | Nella descrizione dello strumento, indica al receptionist di chiedere il nome del chiamante prima di salvarlo. |