Connecter Pipedrive à Nicoka

Le connecteur Pipedrive fait arriver dans Nicoka les fiches de votre compte Pipedrive :

• Une organisation créée dans Pipedrive devient un compte dans Nicoka, une personne devient un contact, rattaché au compte de son organisation.
• Une modification faite dans Pipedrive met à jour la fiche Nicoka, sur les champs que vous choisissez.

Le connecteur ne fait que recevoir : il n'écrit rien dans Pipedrive, et les affaires et activités Pipedrive ne sont pas reprises. Ces réglages demandent les droits d'administration de Nicoka et un compte administrateur Pipedrive.

Étape 1 – Copier le jeton d'API d'un administrateur Pipedrive

1. Connectez-vous à Pipedrive avec un utilisateur administrateur.
2. Cliquez sur votre nom en haut à droite, puis sur Préférences personnelles > API.
3. Copiez le jeton d'API personnel.

Nicoka ne reçoit que les organisations et les personnes que cet utilisateur voit dans Pipedrive : avec le jeton d'un utilisateur qui n'en voit qu'une partie, seule cette partie arrive. Si cet utilisateur régénère son jeton, la connexion s'arrête : collez le nouveau jeton dans la configuration (étape 3).

Étape 2 – Connecter le compte dans Nicoka

1. Dans le menu latéral, ouvrez Paramétrage > Intégrations.
2. Sur la tuile Pipedrive, cliquez sur Configurer.

3. Cliquez sur Connecter un compte, saisissez un libellé libre et collez le jeton d'API, puis cliquez sur Sauvegarder. Le jeton est vérifié auprès de Pipedrive avant l'enregistrement : un jeton refusé ne crée aucune connexion.

À la connexion, Nicoka s'abonne lui-même aux créations et aux modifications d'organisations et de personnes : il n'y a rien à régler dans Pipedrive. Un seul compte Pipedrive peut être connecté à votre espace Nicoka.

Étape 3 – Régler la correspondance des champs

Cliquez sur Configurer sur la ligne du compte. Le cadre bleu confirme que Nicoka reçoit les créations et les modifications. S'il est orange, Pipedrive a refusé l'abonnement et le cadre en donne la raison : le plus souvent, le jeton n'est pas celui d'un administrateur. Collez alors le jeton d'un administrateur et cliquez sur Sauvegarder pour réessayer.

La fenêtre présente une section Comptes et une section Contacts :

• Sens de synchronisation : Pipedrive vers Nicoka, ou Ne pas synchroniser pour couper la réception de ce type de fiche.
• Type et Statut des comptes, Statut et Provenance des contacts : les valeurs données aux fiches créées, que Pipedrive ne porte pas. Tant que le type et le statut ne sont pas choisis, aucune fiche n'est créée.
• Le tableau de correspondance : pour chaque ligne, le champ Nicoka à alimenter et le champ Pipedrive qui le remplit, vos champs personnalisés Pipedrive compris. Une adresse se découpe en parties : address.locality pour la ville, address.postal_code pour le code postal, address.country pour le pays. Le compte démarre avec le nom et le site web des organisations, et le prénom, le nom, l'e-mail et le téléphone des personnes.
• Mise à jour : cochée, une modification dans Pipedrive met aussi à jour la fiche déjà présente dans Nicoka ; décochée, le champ ne sert qu'à la création.
• Valeurs : pour un champ à liste, la correspondance valeur Pipedrive = identifiant Nicoka, par exemple Client=1, Prospect=2. Une valeur absente de la table n'est pas reprise.

Cliquez sur Sauvegarder pour enregistrer la configuration.

Reprendre les fiches déjà présentes dans Pipedrive

Les abonnements ne font arriver que ce qui est créé ou modifié après la connexion. Pour importer les organisations et les personnes que votre compte Pipedrive contient déjà, contactez le support Nicoka une fois la correspondance réglée : la reprise se fait en arrière-plan, et une fiche déjà présente dans Nicoka est retrouvée, jamais dupliquée.

Bon à savoir

• Le compte d'un contact vient de son organisation Pipedrive, créée au passage si elle n'est pas encore dans Nicoka. Un contact qui a déjà un compte le garde, même si la personne change d'organisation dans Pipedrive.
• Une fiche déjà présente dans Nicoka est retrouvée par son SIRET ou son nom (compte), ou par son e-mail (contact). Deux organisations Pipedrive du même nom, ou deux personnes avec le même e-mail, ne sont pas fusionnées : seule la première est reprise.
• Une suppression dans Pipedrive ne supprime rien dans Nicoka.
• Le poste, l'adresse postale et la date de naissance d'une personne ne sont proposés que si la synchronisation des contacts est activée sur votre compte Pipedrive.
• Retirer le compte dans Nicoka supprime aussi ses abonnements dans Pipedrive.