Connecter Pipedrive à votre logiciel métier

Que couvre l'API de Pipedrive ?

L'API de Pipedrive ouvre les objets du cycle de vente. Le guide de migration vers la version 2, que Pipedrive recommande dès qu'un appel y existe, liste notamment :

• les affaires (deals), personnes, organisations et activités ;
• les produits, leurs variantes et les produits rattachés à une affaire ;
• les pipelines et leurs étapes ;
• les définitions de champs, champs personnalisés compris, regroupés dans un objet custom_fields ;
• la recherche sur les affaires, personnes, organisations, prospects (leads) et produits ;
• les projets, tableaux, phases et tâches.

La version 2 apporte une pagination par curseur, plus rapide sur de longues listes, des dates au format RFC 3339 qui lèvent les ambiguïtés de fuseau horaire, et des réponses allégées qui n'embarquent plus les objets liés. Pipedrive publie des bibliothèques officielles pour Node.js et PHP. Le guide ne fixe pas de date de fin pour les appels v1 ; un développement neuf part néanmoins sur la v2.

Jeton d'API ou OAuth 2.0 : qui signe les appels ?

Toute requête à l'API Pipedrive doit être authentifiée, de l'une de ces deux façons :

Le jeton d'API impose deux précautions. Un utilisateur n'a qu'un jeton actif à la fois, et le changer coupe toutes les intégrations qui l'utilisent. Et le choix de l'utilisateur porteur fixe les droits de l'intégration : le compte nominatif d'un commercial lui donne exactement ses accès, jusqu'au jour de son départ. Un utilisateur dédié à l'intégration, ou OAuth, évite ces deux écueils.

Comment ménager les limites de l'API Pipedrive ?

Pipedrive applique une limitation de débit à son API, décrite sur la page « Rate limiting » de sa documentation développeur. Les valeurs évoluent : relevez celles qui s'appliquent à votre compte au moment du cadrage, puis concevez le flux pour en consommer le moins possible. Quatre règles de conception y aident, quelle que soit l'offre.

Exemple : un programme qui, pour 1 000 commandes quotidiennes, cherche l'organisation puis met à jour l'affaire envoie 2 000 appels par jour. S'il garde en mémoire la correspondance des identifiants, la recherche disparaît et il n'en envoie plus que 1 000. Supprimer la recherche fiabilise aussi le rapprochement : deux organisations au nom proche ne peuvent plus être confondues.

Les webhooks Pipedrive et leurs règles de livraison

Un webhook Pipedrive envoie une requête POST avec un corps JSON quand un objet est créé, modifié ou supprimé ; une fusion apparaît comme une suppression signalée dans les métadonnées. Les objets suivis sont notamment les activités, affaires, notes, organisations, personnes, pipelines, produits, étapes et utilisateurs. Pour une modification, le message contient l'état actuel et l'état précédent de l'objet : on sait quel champ a changé sans relire la fiche. La version 2 des webhooks est celle par défaut.

Le guide des webhooks v2 fixe des règles de livraison strictes :

1. votre service répond par un code 2XX en moins de 10 secondes ;
2. en cas d'échec, Pipedrive retente trois fois, après 3, 30 puis 150 secondes ;
3. après 10 échecs de première tentative, le webhook est suspendu 30 minutes et les événements de cette période sont perdus ;
4. sans aucune livraison réussie pendant 3 jours consécutifs, le webhook est supprimé.

Les webhooks ne sont pas soumis à la limitation de débit de l'API, ce qui en fait le bon outil pour suivre les changements. Mais une panne de serveur un vendredi soir peut faire disparaître le webhook avant lundi. Le service de réception répond donc immédiatement, traite ensuite, vérifie chaque jour que ses webhooks existent, et rattrape les trous en relisant les fiches modifiées. Le guide prévoit aussi une authentification HTTP Basic sur l'adresse de réception.

Quatre scénarios Pipedrive pour une PME

1. Affaire gagnée, chantier planifié. Une entreprise de rénovation énergétique gagne une affaire ; le webhook déclenche la création du chantier dans le logiciel de planification, avec l'adresse de l'organisation et les produits vendus (pompe à chaleur, isolation des combles).
2. Compte client ouvert, organisation mise à jour. Quand la comptabilité ouvre un compte client, son numéro est écrit dans un champ personnalisé de l'organisation : le commercial voit que le prospect est devenu client.
3. Visite technique, activité enregistrée. Le technicien qui termine un relevé sur son application mobile crée une activité dans Pipedrive, compte rendu en note, sans repasser par le bureau. La partie terrain est décrite dans notre page sur les applications mobiles pour équipes terrain.
4. Catalogue aligné. Chaque nuit, les produits modifiés dans la gestion commerciale sont mis à jour dans Pipedrive, pour que chaque affaire parte avec le bon tarif.

Du compte sandbox à la production : le déroulé

Pipedrive propose l'inscription à un compte sandbox, présenté comme l'équivalent d'un compte société classique, réservé au développement et aux tests. Il compte 5 sièges par défaut et accepte l'import de données d'exemple depuis un tableur. Sa durée de vie est encadrée : il est supprimé si aucune application n'y est créée dans les 45 jours, ou si aucune application publique n'est publiée ni aucune application privée mise en service dans les six mois.

1. Cartographier les flux et désigner, pour chaque donnée, l'outil qui fait foi.
2. Estimer le nombre d'appels de chaque flux et le confronter aux limites publiées par Pipedrive pour votre compte.
3. Construire et tester sur le sandbox, y compris les cas d'échec : webhook suspendu, limite d'appels atteinte, fiche supprimée.
4. Répéter sur une copie réaliste de vos données, avec ses doublons d'organisations et ses affaires sans produit, selon notre méthode de recette logicielle.
5. Ouvrir les flux en production un par un, avec contrôle quotidien des webhooks et de la consommation d'appels.

Marketplace, Zapier ou service sur mesure ?

La page des tarifs de Pipedrive annonce plus de 500 intégrations, dont Zapier, Zoom et Lemlist, dès l'offre Lite. Si votre logiciel métier y figure, le connecteur existant se teste en premier. Zapier ou un outil équivalent suffit pour un flux simple et peu volumineux, comme créer une affaire depuis un formulaire.

Un service sur mesure devient pertinent quand le flux touche la facturation ou la planification, quand le volume oblige à compter les appels, ou quand les règles de rapprochement sont propres à votre activité. YMHB Web l'écrit sur la bibliothèque officielle Node.js, l'héberge sur votre compte et vous remet, au paiement intégral, le code, la documentation des correspondances de champs, contrôle quotidien des webhooks et suivi de la consommation d'appels. Côté RGPD, Pipedrive indique héberger principalement les nouveaux comptes de clients de l'Union européenne dans sa région européenne, chez AWS, avec des exceptions possibles ; l'emplacement exact se demande au support. Pour le cadre général, voir connecter ses logiciels par API, et pour changer d'outil, les alternatives à Pipedrive.