HighLevel | ElevenLabs Documentation

HighLevel est également connu sous le nom de GoHighLevel, et son API fonctionne sous le nom de LeadConnector. Avec un outil webhook, 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 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.

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.

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.