EspoCRM | ElevenLabs Documentation

Avec les outils webhook ci-dessous, votre réceptionniste peut reconnaître les appelants déjà présents dans EspoCRM et ajouter les nouveaux appelants comme prospects, avec leur nom, leur numéro de téléphone et leurs besoins, afin que votre équipe puisse les recontacter. L’API d’EspoCRM utilise une clé API statique et des corps de requête JSON. Son fonctionnement est donc identique pour EspoCRM Cloud et les installations auto-hébergées.

Avant de commencer

Créer un rôle

Dans EspoCRM, accédez à Administration → Rôles et créez un rôle capable de lire et de créer des prospects, ainsi que de lire des contacts. Laissez toutes les autres portées désactivées.

Créer un utilisateur API

Accédez à Administration → Utilisateurs API et créez un utilisateur. Définissez la méthode d’authentification sur Clé API, puis attribuez le rôle que vous venez de créer. Enregistrez, puis copiez la clé API depuis la vue détaillée de l’utilisateur.

Chaque outil ci-dessous envoie la clé dans un en-tête de requête nommé X-Api-Key. Définissez son Type sur Secret.

La clé API peut lire et modifier tout ce que son rôle autorise. Limitez les autorisations du rôle et régénérez la clé dans EspoCRM si elle est compromise.

Trouver votre adresse EspoCRM

Les URL de vos outils commencent par l’adresse que vous ouvrez dans votre navigateur pour utiliser EspoCRM, suivie de /api/v1/. Les tableaux ci-dessous utilisent https://YOUR-CRM.example.com ; remplacez-la par votre propre adresse.

Créer les outils

Pour chaque outil, accédez à Intégrations, sélectionnez Ajouter une intégration, choisissez Outil webhook, puis définissez Attribuer aux agents sur Réceptionniste. Pour chaque paramètre indiqué comme « Toujours » ci-dessous, définissez Valeur sur Valeur fixe.

Trouver un prospect

Champ	Valeur
Nom	`find_espocrm_lead`
Description	« Trouvez l’appelant parmi nos prospects à l’aide de son numéro de téléphone. Utilisez cet outil au début d’un appel pour vérifier s’il nous a déjà contactés. »
Méthode	GET
URL	`https://YOUR-CRM.example.com/api/v1/Lead`
En-têtes de requête	`X-Api-Key` : votre clé API
Paramètres de requête	`textFilter` (chaîne, requis) : « Le numéro de téléphone de l’appelant avec son indicatif pays, par exemple +14155550123. » `select` (chaîne) : Toujours `id,name,status`. `maxSize` (entier) : Toujours `5`.

Pour reconnaître également les clients existants, créez un second outil nommé find_espocrm_contact avec les mêmes paramètres et l’URL https://YOUR-CRM.example.com/api/v1/Contact.

Ajouter un nouveau prospect

Champ	Valeur
Nom	`create_espocrm_lead`
Description	« Ajoutez l’appelant comme nouveau prospect lorsque `find_espocrm_lead` ne le trouve pas. »
Méthode	POST
URL	`https://YOUR-CRM.example.com/api/v1/Lead`
En-têtes de requête	`X-Api-Key` : votre clé API
Paramètres du corps	`firstName` (chaîne, requis) : « Le prénom de l’appelant. » `lastName` (chaîne, requis) : « Le nom de famille de l’appelant. » `phoneNumber` (chaîne, requis) : « Le numéro de téléphone de l’appelant au format international, par exemple +14155550123. » `emailAddress` (chaîne) : « L’adresse email de l’appelant, s’il en a fourni une. » `description` (chaîne, requis) : « Les besoins de l’appelant et le moment auquel il souhaite être rappelé. » `status` (chaîne) : Toujours `New`. `source` (chaîne) : Toujours `Call`.

Pour attribuer les nouveaux prospects à un commercial, ajoutez assignedUserId (chaîne) en tant que valeur fixe avec l’ID de cet utilisateur. Vous trouverez cet ID dans la barre d’adresse lorsque vous ouvrez l’utilisateur dans EspoCRM.

Sélectionnez Activer sur chaque outil, puis testez votre réceptionniste en vous faisant passer pour un nouvel appelant demandant un devis. Le prospect apparaît dans EspoCRM avec le statut New et la source Call.

Ajoutez une procédure afin que votre réceptionniste effectue d’abord une recherche et n’ajoute un prospect qu’en l’absence de correspondance.

La recherche trouve également les noms et les adresses email ; un appelant pourrait donc tenter de rechercher quelqu’un d’autre. Ajoutez une règle selon laquelle votre réceptionniste ne communique jamais les enregistrements CRM aux appelants et limitez select à id,name,status.

Limites

textFilter correspond à la recherche intégrée d’EspoCRM : elle cherche dans les noms, les adresses email et les numéros de téléphone. Une recherche par numéro de téléphone peut aussi renvoyer un autre enregistrement dont le numéro commence par les mêmes chiffres. Votre réceptionniste doit donc confirmer le nom de l’appelant.
Votre réceptionniste ne peut pas ajouter de note ni de tâche à un prospect ou contact existant avec ces outils. La description du nouveau prospect contient les détails de l’appel.
Les outils ne définissent pas les équipes. EspoCRM attend une liste d’ID d’équipe (teamsIds), et un outil webhook remplit toujours une liste à partir de la conversation. Il ne peut donc pas placer chaque prospect dans la même équipe, et votre réceptionniste ne doit pas choisir les équipes. Utilisez plutôt assignedUserId pour attribuer les prospects.

Résolution des problèmes

Problème	Vérifications à effectuer
401 renvoyé par EspoCRM	L’en-tête doit être nommé `X-Api-Key` et contenir la clé affichée dans la vue détaillée de l’utilisateur API. Vérifiez que l’utilisateur API est actif.
403 renvoyé par EspoCRM	Le rôle de l’utilisateur API ne peut pas lire ou créer de prospects. Modifiez le rôle dans Administration → Rôles.
409 lors de l’ajout d’un prospect	EspoCRM a trouvé un doublon potentiel, par exemple un prospect portant le même nom ou utilisant la même adresse email. Votre réceptionniste doit d’abord effectuer une recherche.
Les appelants connus ne sont pas trouvés	Enregistrez les numéros de téléphone au format international, par exemple `+14155550123`, et vérifiez que le numéro est associé à un prospect ou à un contact, pas seulement à un compte.
Erreurs `status` ou `source`	Les valeurs doivent correspondre exactement à vos options Statut et Source de prospect, telles qu’elles sont définies dans Administration → Gestionnaire d’entités → Prospect.