> 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 est également connu sous le nom de GoHighLevel, et son API fonctionne sous le nom de LeadConnector. Avec un [outil webhook](/docs/fr/reception-ai/integrations/webhooks), votre réceptionniste peut enregistrer chaque appelant comme contact dans votre sous-compte HighLevel. Si l'appelant est déjà un contact, HighLevel met à jour l'enregistrement existant au lieu de créer un doublon.

## Configuration

### Créez un jeton d'intégration privé

Dans votre sous-compte HighLevel, ouvrez **Paramètres** → **Intégrations privées** et sélectionnez **Créer une intégration**. Donnez-lui un nom, sélectionnez uniquement les autorisations permettant d'afficher et de modifier les contacts, puis créez-la. Copiez immédiatement le jeton : HighLevel ne l'affiche qu'une seule fois.

Si **Intégrations privées** n'apparaît pas dans vos paramètres, demandez à l'administrateur de votre agence de vous y donner accès.

### Trouvez votre ID d'emplacement

Ouvrez **Paramètres** → **Profil de l'entreprise** dans le même sous-compte et copiez l'**ID d'emplacement**.

### Créez l'outil webhook

Dans Reception.ai, accédez à **Intégrations**, sélectionnez **Ajouter une intégration**, puis choisissez **Outil webhook**.

| Champ                    | Valeur                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                  | `save_highlevel_contact`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Description**          | "Enregistrez l'appelant comme contact dans notre CRM dès que vous connaissez son nom et son numéro de téléphone. Utilisez cet outil à chaque appel d'un nouveau client ou d'un client existant."                                                                                                                                                                                                                                                                                                          |
| **Méthode**              | POST                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **URL**                  | `https://services.leadconnectorhq.com/contacts/upsert`                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| **En-têtes de requête**  | `Authorization`: `Bearer ` suivi de votre jeton  `Version`: `2021-07-28`                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Paramètres du corps**  | `locationId` (chaîne, requis) : "Toujours la valeur exacte `LOCATION_ID`."  `firstName` (chaîne, requis) : "Le prénom de l'appelant."  `lastName` (chaîne) : "Le nom de famille de l'appelant, s'il l'a communiqué."  `phone` (chaîne, requis) : "Le numéro de téléphone de l'appelant au format international, par exemple +14155550123."  `email` (chaîne) : "L'adresse email de l'appelant, s'il l'a communiquée."  `source` (chaîne, requis) : "Toujours la valeur exacte `Reception.ai phone call`." |
| **Attribuer aux agents** | **Réceptionniste**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

Remplacez `LOCATION_ID` par l'ID que vous avez copié. Sélectionnez **Activer**.

### Testez l'outil

[Testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) en l'appelant et en indiquant votre nom et votre numéro. Le contact apparaît dans HighLevel, sous **Contacts**. Appelez à nouveau avec le même numéro : HighLevel met à jour ce contact au lieu d'en ajouter un nouveau.

> **Warning**
>
> Le jeton peut lire et modifier vos contacts. Ne le partagez pas dans des documents partagés et supprimez
> l'intégration privée dans HighLevel s'il est divulgué.

HighLevel détermine si un appelant est déjà un contact à l'aide du paramètre **Autoriser les contacts en double** du sous-compte. Si ce paramètre vérifie à la fois l'email et le numéro de téléphone, HighLevel les vérifie dans l'ordre indiqué par le paramètre.

> **Tip**
>
> Pour effectuer d'autres actions après un appel, comme ouvrir une opportunité ou alerter votre équipe, créez un workflow HighLevel
> qui commence par le déclencheur **Webhook entrant**. Dirigez un second outil webhook vers l'URL du
> workflow avec les champs nécessaires, puis mappez ces champs dans le workflow. Considérez l'URL du
> workflow comme un secret. HighLevel répertorie Webhook entrant comme un déclencheur premium, vérifiez donc les frais
> d'utilisation de votre forfait.

## Limites

* Le serveur MCP de HighLevel nécessite une connexion OAuth, que Reception.ai ne prend pas en charge. Utilisez donc l'outil webhook.
* Les tags et les champs personnalisés sont des listes dans l'API de HighLevel, tandis que les outils webhook envoient des valeurs simples. Définissez-les plutôt avec un workflow.
* L'ajout de notes ou de tâches nécessite l'ID du contact dans l'URL, qu'un outil webhook ne peut pas renseigner pendant un appel. Utilisez un workflow **Webhook entrant** pour ces actions.

## Résolution des problèmes

| Problème                                | Vérification à effectuer                                                                                                                                  |
| --------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401 de HighLevel                        | L'en-tête `Authorization` doit être `Bearer ` suivi du jeton, avec un espace après `Bearer`.                                                              |
| 403 de HighLevel                        | Le jeton nécessite les autorisations de contact, et `locationId` doit correspondre au sous-compte dans lequel le jeton a été créé.                        |
| HighLevel refuse la version             | L'en-tête `Version` doit être exactement `2021-07-28`. Si la documentation de l'API HighLevel indique une valeur requise plus récente, utilisez celle-ci. |
| Les appelants récurrents sont dupliqués | Vérifiez le paramètre **Autoriser les contacts en double** et que les numéros de téléphone sont enregistrés au même format international.                 |
| Le contact n'a pas de nom               | La description de l'outil doit indiquer à la réceptionniste de demander le nom de l'appelant avant de l'enregistrer.                                      |