> 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.

# Pipedrive

Grâce aux [outils webhook](/docs/fr/reception-ai/integrations/webhooks) ci-dessous, votre réceptionniste peut reconnaître les appelants déjà présents dans Pipedrive, ouvrir une opportunité et planifier un appel de suivi pour votre équipe.

## Avant de commencer

Dans Pipedrive, ouvrez **Personal preferences** → **API** et copiez votre jeton API. Chaque outil ci-dessous l’envoie dans l’en-tête de requête `x-api-token`. Les outils agissent en votre nom. Utilisez donc le jeton d’un utilisateur qui peut voir le bon pipeline.

## 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**.

### Rechercher un appelant

| Champ                     | Valeur                                                                                                                                                                         |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nom**                   | `find_pipedrive_person`                                                                                                                                                        |
| **Description**           | "Recherchez l’appelant dans notre CRM par numéro de téléphone ou par nom. Utilisez cet outil au début d’un appel concernant une vente, un devis ou une opportunité existante." |
| **Méthode**               | GET                                                                                                                                                                            |
| **URL**                   | `https://api.pipedrive.com/api/v2/persons/search`                                                                                                                              |
| **En-têtes de requête**   | `x-api-token` : votre jeton API                                                                                                                                                |
| **Paramètres de requête** | `term` (chaîne, obligatoire) : "Le numéro de téléphone ou le nom complet de l’appelant, avec au moins 2 caractères."                                                           |

### Ouvrir une opportunité

| Champ                   | Valeur                                                                                                                                                                                                                                                                                       |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nom**                 | `create_pipedrive_deal`                                                                                                                                                                                                                                                                      |
| **Description**         | "Ouvrez une opportunité lorsqu’un appelant souhaite obtenir un devis ou acheter. Incluez le nom de l’appelant dans le titre."                                                                                                                                                                |
| **Méthode**             | POST                                                                                                                                                                                                                                                                                         |
| **URL**                 | `https://api.pipedrive.com/api/v2/deals`                                                                                                                                                                                                                                                     |
| **En-têtes de requête** | `x-api-token` : votre jeton API                                                                                                                                                                                                                                                              |
| **Paramètres du corps** | `title` (chaîne, obligatoire) : "Titre court avec le nom de l’appelant et ce qu’il souhaite."  `person_id` (nombre) : "L’identifiant de `find_pipedrive_person`. Omettez-le si l’appelant n’a pas été trouvé."  `value` (nombre) : "La valeur de l’opportunité, si l’appelant l’a indiquée." |

### Planifier un suivi

| Champ                   | Valeur                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Nom**                 | `create_pipedrive_followup`                                                                                                                                                                                                                                                                                                                                                                                                                      |
| **Description**         | "Planifiez un rappel de l’équipe chaque fois que vous promettez un suivi à l’appelant."                                                                                                                                                                                                                                                                                                                                                          |
| **Méthode**             | POST                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| **URL**                 | `https://api.pipedrive.com/api/v2/activities`                                                                                                                                                                                                                                                                                                                                                                                                    |
| **En-têtes de requête** | `x-api-token` : votre jeton API                                                                                                                                                                                                                                                                                                                                                                                                                  |
| **Paramètres du corps** | `subject` (chaîne, obligatoire) : "Par exemple : rappeler Jane Doe à propos d’un devis de cuisine."  `type` (chaîne, obligatoire) : "Toujours la valeur exacte `call`."  `due_date` (chaîne, obligatoire) : "La date de suivi au format AAAA-MM-JJ."  `note` (chaîne, obligatoire) : "Le nom de l’appelant, son numéro de téléphone et ce dont il a besoin."  `deal_id` (nombre) : "L’identifiant de l’opportunité, si vous en avez ouvert une." |

Sélectionnez **Activer** sur chaque outil, puis [testez votre réceptionniste](/docs/fr/reception-ai/receptionist/testing) avec un appel demandant un devis.

## Limites

Les outils webhook envoient des valeurs à plat, tandis que Pipedrive stocke les numéros de téléphone d’une personne sous forme de liste imbriquée. Ces outils ne peuvent donc pas créer de nouveau contact avec un numéro de téléphone. La note du suivi conserve le numéro de l’appelant à la place. Pour créer des contacts, utilisez l’action **Create Person** de Pipedrive via [Zapier](/docs/fr/reception-ai/integrations/zapier).

## Résolution des problèmes

| Problème                               | Vérification à effectuer                                                                                                                                  |
| -------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 401 de Pipedrive                       | L’en-tête doit s’appeler `x-api-token` et contenir un jeton actuel.                                                                                       |
| Les appelants connus sont introuvables | Pipedrive fait correspondre les numéros de téléphone tels qu’ils sont enregistrés. Stockez les numéros dans un format unique ou recherchez aussi par nom. |
| Le suivi n’a pas de type               | `call` doit être un type d’activité dans votre compte Pipedrive. Vérifiez **Company settings** → **Activities**.                                          |