> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # EspoCRM Avec les [outils webhook](/docs/fr/reception-ai/integrations/webhooks) 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**. > **Warning** > > 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](/docs/fr/reception-ai/receptionist/testing) 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**. > **Tip** > > Ajoutez une [procédure](/docs/fr/reception-ai/receptionist/rules-and-procedures) afin que votre réceptionniste > effectue d’abord une recherche et n’ajoute un prospect qu’en l’absence de correspondance. > **Warning** > > 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**. |