La plupart des CRM se contentent d’une seule clé API. Pipedrive en veut deux : un jeton API personnel qui appartient à un utilisateur et non à l’entreprise, et le domaine d’entreprise sur lequel votre compte répond, car chaque compte Pipedrive possède sa propre adresse API. Une fois les deux en place, les contacts captés arrivent sous forme de Personnes Pipedrive. Comptez environ 90 secondes.
Ce que Pipedrive demande, et pourquoi
- Un jeton API personnel. Pipedrive émet un jeton par utilisateur, et non par application. Il est limité à votre utilisateur Pipedrive : les Personnes créées vous appartiennent et héritent exactement de vos permissions. Si vous êtes l’administrateur, cela couvre tout.
- Votre domaine d’entreprise. Pipedrive achemine le trafic API par le sous-domaine propre à votre compte : les requêtes vont vers
votreentreprise.pipedrive.com, et non vers un hôte API partagé. Anexus a besoin de cette adresse pour savoir où les envoyer, c’est pourquoi cette intégration comporte un deuxième champ là où la plupart des CRM n’en ont qu’un. - N’importe quel forfait Pipedrive convient, essai gratuit inclus. L’authentification par jeton est indépendante de votre méthode de connexion : un compte qui se connecte via Google ou une authentification unique SAML fonctionne donc normalement.
Étape 1 — Copiez votre jeton API personnel
Dans Pipedrive, cliquez sur votre avatar de profil (en haut à droite) → Préférences personnelles.
Passez à l’onglet API.
Copiez la valeur Votre jeton API personnel. C’est une chaîne de 40 caractères composée de lettres et de chiffres.
Il ne s’agit pas d’une procédure de « création d’application ». Il n’y a aucun client OAuth à enregistrer, aucune portée à cocher, aucune URL de rappel. Si vous vous retrouvez dans le Developer Hub de Pipedrive à créer une application publique, vous êtes allé une porte trop loin — revenez aux Préférences personnelles.
Étape 2 — Lisez le domaine d’entreprise dans votre barre d’adresse
L’URL que vous utilisez pour vous connecter à Pipedrive ressemble à https://votreentreprise.pipedrive.com. Anexus attend l’hôte seul : votreentreprise.pipedrive.com — sans https://, sans chemin, sans barre oblique finale.
Un administrateur Pipedrive peut renommer ce sous-domaine plus tard dans les Paramètres de l’entreprise. L’adresse API suit ce changement : si votre équipe modifie un jour l’URL Pipedrive, revenez mettre ce champ à jour.
Étape 3 — Collez les deux dans Anexus
Dans Anexus, allez à Paramètres → Intégrations CRM → Pipedrive → Connecter.
Remplissez :
- Domaine d’entreprise :
votreentreprise.pipedrive.com - Jeton API personnel : la chaîne de 40 caractères
Cliquez sur Enregistrer et connecter.
Où atterrissent les contacts : la liste Personnes, pas la boîte de réception des prospects
Pipedrive conserve deux espaces distincts qui se ressemblent beaucoup au premier abord : la boîte de réception des prospects, une liste d’attente pour les prospects non qualifiés, et Contacts → Personnes, le carnet d’adresses des fiches Personne. Les nouveaux contacts venus d’Anexus vont dans Contacts → Personnes. Triez cette vue par Date d’ajout décroissante, ou filtrez sur « Récemment ajoutés », et vos derniers contacts captés seront en haut.
Correspondance des champs : formulaire de captation vers la Personne Pipedrive
Chaque contact capté devient une Personne Pipedrive. Voici ce qui va où, et la particularité Pipedrive derrière chaque ligne.
| Capté par Anexus | Arrive dans Pipedrive comme | Bon à savoir |
|---|---|---|
| Prénom + nom | Personne → Nom | Une Personne Pipedrive stocke un seul champ Nom combiné, et non des colonnes prénom et nom distinctes. |
| Courriel | Personne → Courriel, marqué principal avec l’étiquette « travail » | Une Personne peut contenir plusieurs adresses courriel ; chacune porte une étiquette (travail / domicile / autre) et une seule est marquée comme principale. |
| Téléphone (si fourni) | Personne → Téléphone | Même modèle à valeurs multiples que le courriel — des numéros étiquetés dont un principal. Pipedrive ne reformate pas les numéros : ce que le visiteur a saisi est ce que vous composerez. |
| Entreprise (si fournie) | Personne → Organisation | L’Organisation est un objet à part entière dans Pipedrive, et non du texte libre — le champ Organisation d’une Personne pointe vers une fiche Organisation, ce qui explique que les noms d’entreprise soient interrogeables sous Contacts → Organisations. |
| Titre du poste (si fourni) | Personne → titre du poste, si votre compte possède ce champ | Les champs Personne intégrés de Pipedrive sont Nom, Organisation, Courriel, Téléphone et Étiquette — le titre du poste n’en fait pas partie. La plupart des équipes en ajoutent un dans Paramètres de l’entreprise → Champs de données → Personne. Si un titre attendu n’apparaît pas sur une Personne synchronisée, vérifiez d’abord à cet endroit que le champ existe. |
| Message (si le visiteur en a écrit un) | Envoyé avec le contact | Anexus envoie le texte du message avec le reste des informations captées. Ce n’est pas un champ Personne intégré de Pipedrive : n’attendez donc pas de colonne pour lui dans la vue tableau Personnes. |
| Source de captation (tapotement NFC, lecture QR, Apple Wallet, lien partagé) | Une note indiquant la source | Anexus consigne la façon dont le contact vous est parvenu — un tapotement, une lecture, une carte Apple Wallet ou un lien partagé — pour que vous sachiez plus tard d’où vient une Personne. |
Les contacts sans adresse courriel valide sont ignorés plutôt qu’envoyés, et les notes privées que vous rédigez dans le Mini CRM d’Anexus restent dans Anexus.
Personnes, Affaires et votre tableau de pipeline
Pipedrive est construit autour des Affaires. Une Affaire occupe une Étape d’un Pipeline, et le tableau de pipeline est ce que la plupart des utilisateurs Pipedrive regardent toute la journée. Les Personnes et les Organisations constituent le carnet d’adresses derrière ce tableau.
Une Personne seule n’apparaît sur aucun tableau de pipeline — dans Pipedrive, rien ne s’affiche sur le tableau tant qu’une Affaire n’y est pas rattachée. Décidez donc à l’avance qui ouvre l’Affaire pour un nouveau contact capté, et dans quel Pipeline et quelle Étape elle atterrit.
La même logique s’applique aux Activités de Pipedrive. Toute la méthodologie de Pipedrive repose sur le fait que chaque Affaire ouverte porte une prochaine Activité planifiée — un appel, une réunion, un courriel — et c’est ce qui déclenche ses rappels. Une Personne toute neuve ne porte aucune Activité : Pipedrive ne vous relancera donc jamais à son sujet. Si un contact capté compte, ajoutez-lui une Activité le jour même de la rencontre.
Doublons : pourquoi Pipedrive les laisse passer
Nous recherchons d’abord les Personnes existantes par courriel : un même visiteur qui soumet deux fois votre formulaire met donc à jour la Personne existante au lieu d’en créer une seconde.
Pipedrive, en revanche, n’impose pas l’unicité des adresses courriel sur les Personnes. Votre liste Personnes peut très bien contenir trois Personnes partageant une même adresse, et Pipedrive ne les révèle que via son outil manuel Fusionner les doublons. Si votre liste est déjà en désordre, faites ce ménage avant de connecter — le courriel est la clé de rapprochement, donc une liste propre donne des résultats propres.
Récupérer les contacts captés avant la connexion
Cliquez sur Synchroniser les contacts passés sur la carte Pipedrive pour envoyer tout ce qui a été capté avant la connexion, par lots de 50 Personnes.
Pipedrive mesure l’usage de l’API par entreprise, et chaque intégration que vous utilisez — Zapier, Make, scripts maison, celle-ci — puise dans le même quota. Si un gros rattrapage coïncide avec un autre outil qui traite des lots, c’est Pipedrive qui ralentira l’ensemble.
Dépannage Pipedrive
« Pipedrive a rejeté le jeton (vérifiez aussi le domaine d’entreprise) »
Comme il y a deux champs, ce message a deux causes possibles :
- Faute de frappe dans le jeton. Recopiez-le depuis Préférences personnelles → API. Une espace finale ramassée à la copie est le coupable classique.
- Format de domaine incorrect. Ce doit être l’hôte seul
votreentreprise.pipedrive.com— pashttps://votreentreprise.pipedrive.com, pas un lien profond copié depuis une Affaire, pasapp.pipedrive.com. - Le sous-domaine a été renommé. Si un administrateur a modifié l’URL de l’entreprise dans les Paramètres de l’entreprise, le jeton reste valide mais l’adresse ne répond plus. Connectez-vous, regardez la barre d’adresse, collez le nouvel hôte.
Ça fonctionnait hier et plus aujourd’hui
L’écran API de Pipedrive comporte un bouton Régénérer, et la régénération invalide instantanément le jeton précédent. Quiconque a cliqué dessus — vous, ou un administrateur qui fait le ménage côté sécurité — casse d’un coup tous les outils qui utilisent ce jeton, car Pipedrive attribue un jeton par utilisateur et non un par intégration. Même chose si cet utilisateur Pipedrive est désactivé ou perd son siège : le jeton meurt avec l’utilisateur. Appuyez sur Tester sur la carte Anexus pour confirmer, puis collez un nouveau jeton.
Le jeton s’authentifie mais rien n’est créé
Un jeton personnel porte exactement les permissions de son propriétaire, rien de plus. Si votre administrateur Pipedrive a placé votre utilisateur dans un ensemble d’autorisations restreint, la connexion peut se valider sans problème et être malgré tout refusée à l’écriture. Demandez à un administrateur d’assouplir votre ensemble d’autorisations, ou connectez-vous avec le jeton d’un utilisateur autorisé à créer des Personnes et des Organisations.
Vous voyez les nouvelles Personnes, pas vos collègues
Les Personnes créées avec votre jeton appartiennent à votre utilisateur Pipedrive. Sur les comptes qui utilisent des groupes de visibilité, les coéquipiers hors de votre groupe ne les trouveront pas dans leurs filtres — les fiches existent, elles ne sont simplement pas visibles pour cette personne. Modifiez la visibilité de la fiche, ou réattribuez le propriétaire, dans Pipedrive.
Se déconnecter, et vraiment révoquer le jeton
Cliquez sur Déconnecter dans Anexus et nous cessons immédiatement d’envoyer vers Pipedrive. Les Personnes déjà créées restent en place.
Pour révoquer l’accès du côté de Pipedrive, vous devez régénérer le jeton dans Préférences personnelles → API → Régénérer. Voyez cela comme un avertissement, pas comme une étape : puisque Pipedrive émet un jeton par utilisateur, la régénération coupe au même instant toutes les autres intégrations connectées en votre nom. Si Zapier, Make ou un script maison utilise ce jeton, prévoyez de recoller la nouvelle valeur partout avant d’appuyer.