Skip to main content

​
À quoi ça sert

L’intégration Pipedrive relie votre CRM à vos agents vocaux. Pendant l’appel, l’agent peut retrouver un contact, chercher une affaire, lister les affaires d’un pipeline et interroger un champ précis, sans jamais rien modifier dans Pipedrive. Comme pour les autres intégrations, vous branchez votre propre compte : Bookivox ne fournit aucun identifiant. Vous saisissez le domaine de votre entreprise et un jeton API personnel, puis vous cochez les actions à exposer.
L’intégration utilise l’API v2 de Pipedrive, en lecture seule : les quatre actions sont des requêtes GET. Aucun contact, aucune affaire et aucun champ ne sont modifiés pendant l’appel. Le client fournit sa propre clé : Bookivox ne fournit aucun identifiant.

​
Ce qu’il faut préparer

Le jeton n’est affiché qu’une seule fois à sa création. Copiez-le immédiatement : en cas de perte, il faut en générer un nouveau dans Pipedrive.

​
Connecter Pipedrive

1

Créer le jeton dans Pipedrive

Dans Pipedrive, ouvrez Paramètres personnels → API puis générez un jeton personnel. Copiez la valeur affichée : elle ne sera plus visible ensuite.
2

Relever le domaine de l'entreprise

Regardez l’adresse à laquelle vous vous connectez. Pour acme.pipedrive.com, le domaine à saisir est acme.
3

Saisir le compte et la clé

Dans Intégrations → Pipedrive, renseignez le domaine de l’entreprise, puis collez le jeton API. Le formulaire valide le format du domaine et du jeton avant l’enregistrement.
4

Cocher les actions

Sélectionnez les actions à exposer à l’agent. Chacune devient un outil indépendant.
5

Vérifier la connexion

Cliquez sur Créer les outils. Un bandeau vert confirme la création et indique le nombre d’outils créés. La clé disparaît du formulaire : elle reste chiffrée et n’est plus jamais réaffichée.
6

Compléter la connexion

La carte Connexions Pipedrive liste les comptes reliés à l’organisation avec leur état (Complète ou Partielle). Le bouton Créer ajoute une action manquante sans ressaisir la clé.

​
Ce que l’agent peut faire

Chaque action crée un outil distinct : vous pouvez n’en activer qu’une partie, et n’attacher à un agent que celles dont il a besoin.
La recherche libre (search_items) exige un terme d’au moins deux caractères. Pour un champ précis (e-mail ou téléphone), search_fields donne un résultat plus fiable qu’une recherche plein texte.

​
Cas d’usage

​
Comment ça marche

  1. Bookivox crée une credential custom_header contenant un en-tête x-api-token. Pipedrive ne s’authentifie jamais par un jeton Bearer ni par un paramètre d’URL.
  2. Le domaine de l’entreprise est normalisé (minuscules, suppression du préfixe https:// et du suffixe .pipedrive.com) puis figé dans l’URL de l’outil.
  3. L’URL de base devient https://<domaine>.pipedrive.com/api/v2, et chaque action ajoute son chemin : /itemSearch, /persons/search, /deals, /itemSearch/field.
  4. Un outil http_api par action est créé, en GET, avec config.provider = "pipedrive", config.operation et un timeout de 10 000 ms.
  5. Les listes sont bornées par le paramètre limit de chaque action. Pipedrive pagine par curseur, mais le preset n’expose pas ce curseur : l’agent obtient la première page, ce qui suffit pour une réponse courte pendant l’appel.
  6. Seule l’API v2 est exposée : la v1 s’éteint le 31 juillet 2026 et n’est pas utilisée ici.

​
Rédiger la description de l’outil

La description de l’outil est ce qui décide quand l’agent appelle Pipedrive. Rédigez-la comme une consigne :
Si vous exposez à la fois Rechercher un élément et Rechercher par champ, l’agent peut hésiter entre les deux. En général, gardez Rechercher par champ pour les recherches e-mail ou téléphone et désactivez l’autre : moins d’outils, moins d’erreurs.

​
Sécurité

Créez un jeton dédié à l’IA si votre offre Pipedrive le permet, et révoquez-le en cas de doute depuis Paramètres personnels → API. Un jeton partagé avec un autre usage ne peut pas être révoqué sans interrompre cet autre usage.

​
Ce qui est déconseillé

​
Limites et dépannage

Pipedrive n’est pas relié ici par un serveur MCP : chaque action est un outil HTTP distinct, ce qui permet à l’agent de choisir précisément une action plutôt que d’appeler un serveur générique.

Intégrations

Toutes les intégrations et les catégories d’outils.

API HTTP

Comprendre les outils HTTP : paramètres, presets, credentials.
Last modified on November 3, 2026