# Pipedrive

> **Info: Plan Découverte**
>
> Sur le plan Découverte, une seule connexion CRM est active à la fois (erreur `plan_free_one_crm` au-delà).

### Ce que ça fait

Pipedrive envoie vos contacts, vos affaires et vos réunions en temps réel vers DURUM.ai. La connexion se fait en un clic : DURUM.ai crée lui-même les abonnements webhook dans votre compte Pipedrive. Il n'y a aucune URL à coller.

En résumé :

- une **personne ajoutée** dans Pipedrive devient un **lead** ;
- une **affaire gagnée** devient une **vente** (montant = valeur de l'affaire, produit selon le pipeline) ;
- une **affaire perdue** devient une **perte** ;
- une **activité de type réunion** devient un **rendez-vous** (booking).

DURUM.ai importe aussi, pour l'enrichissement, vos utilisateurs Pipedrive (ils deviennent des reps), vos pipelines et leurs étapes, vos contacts, vos affaires, vos activités, vos notes et vos courriels envoyés. Cet import ne crée aucun lead ni aucune vente : les événements ne sont comptés qu'à partir de la connexion.

### Avant de commencer

- Un compte Pipedrive avec les droits pour installer une application. L'autorisation donne à DURUM.ai un accès complet à l'API Pipedrive (Pipedrive ne propose pas de permissions partielles pour ce type de connexion).
- Un accès à DURUM.ai avec un rôle agence ou client. Les rôles rep et affilié ne peuvent pas connecter une intégration.
- Vos produits déjà créés dans DURUM.ai si vous voulez associer chaque pipeline à un produit (étape 2 de l'assistant).

### Connexion étape par étape

Deux chemins mènent à la même connexion.

#### Option A : depuis DURUM.ai

1. Dans DURUM.ai, allez dans **Paramètres** puis **Intégrations**.
2. Sur la carte **Pipedrive** (catégorie CRM), cliquez sur **Connecter**.
3. Vous êtes redirigé vers Pipedrive. Connectez-vous et autorisez l'application DURUM.ai.
4. Vous revenez dans DURUM.ai avec le message « Pipedrive connecté ». DURUM.ai a créé trois abonnements webhook dans votre compte Pipedrive : personnes, affaires, activités.

#### Option B : depuis le Marketplace Pipedrive

1. Dans le Marketplace Pipedrive, ouvrez l'application DURUM.ai et cliquez sur **Install**.
2. Autorisez l'accès. Pipedrive vous envoie sur `https://app.durum.ai/connect/pipedrive`.
3. Connectez-vous à votre compte DURUM.ai. Le lien d'installation est valable **1 heure** et ne sert qu'une seule fois.
4. Compte client : la liaison se fait automatiquement. Compte agence : choisissez dans la liste le client auquel rattacher ce compte Pipedrive, puis cliquez sur **Lier Pipedrive à ce client**.

#### Assistant de configuration

Après la connexion, ouvrez les paramètres de l'intégration (icône de réglages sur la carte Pipedrive). L'assistant a trois étapes :

1. **Rôle de Pipedrive pour ce client** : Marketing, Ventes ou Les deux. Un client peut utiliser un autre CRM pour le marketing et Pipedrive pour les ventes.
2. **Mapper les pipelines Pipedrive** : associez chaque pipeline à un produit DURUM.ai. Au moins un pipeline doit être associé pour enregistrer. Sans cette association, une affaire gagnée est enregistrée comme vente mais sans produit.
3. **Mapping des champs UTM** (optionnel) : si vos contacts Pipedrive portent des champs personnalisés contenant les UTM, associez-les à `utm_source`, `utm_medium`, `utm_campaign`, `utm_content` et `utm_term`. Ils sont utilisés lors de l'import des contacts.

Les pipelines et les champs affichés viennent d'un import en arrière-plan de votre compte Pipedrive. Si l'assistant affiche « Aucun pipeline trouvé », refermez-le et réessayez un peu plus tard.

### Vérifier que ça marche

1. Dans Pipedrive, créez une personne de test avec un courriel facile à reconnaître.
2. Attendez 30 secondes.
3. Dans DURUM.ai, ouvrez **Logs Data** : un événement `lead` de source `pipedrive` doit apparaître avec le statut `success`.
4. Passez une affaire de test au statut **Won** : un événement `sale` doit suivre.

### Événements captés

| Côté Pipedrive | Événement DURUM.ai | Ce qu'il alimente |
|----------------|--------------------|-------------------|
| Personne ajoutée (`person`, action `added`) | `lead` | Leads. Le contact est identifié par son courriel ou son téléphone principal. |
| Affaire qui passe au statut `won` (`deal`) | `sale` | Ventes. Montant = valeur de l'affaire, devise de l'affaire, produit selon le pipeline associé dans l'assistant, rep = propriétaire de l'affaire. |
| Affaire qui passe au statut `lost` (`deal`) | `sale_lost` | Pertes. |
| Activité de type `meeting` ajoutée (`activity`) | `booking` | Rendez-vous. Le courriel et le téléphone du contact sont lus dans les contacts importés. |
| Activité de type `meeting` supprimée | `booking_cancel` | Annulations. |
| Personne modifiée ou supprimée, affaire modifiée sans changement de statut, activité d'un autre type (appel, tâche, courriel) | aucun | Reçu puis ignoré, visible dans Logs Data avec le statut `ignored`. |

Les types d'événements se désactivent un à un dans les paramètres de l'intégration. Un événement désactivé apparaît dans Logs Data avec le statut `gated`.

### Dépannage

| Problème | Solution |
|----------|----------|
| Aucun événement n'arrive | Dans Pipedrive, vérifiez que les trois abonnements webhook créés par DURUM.ai existent et sont actifs. Sinon, déconnectez puis reconnectez l'intégration. |
| Statut `ignored` dans Logs Data | Normal pour une personne modifiée, une affaire qui n'est ni gagnée ni perdue, ou une activité qui n'est pas une réunion. |
| Rendez-vous rejeté avec la raison `ghost_booking_no_contact` | La réunion est liée à une personne dont DURUM.ai n'a pas encore le courriel ni le téléphone. Vérifiez que la personne a un courriel dans Pipedrive et que l'import en arrière-plan a tourné. |
| Vente enregistrée sans produit | L'assistant n'a pas été terminé. Associez le pipeline concerné à un produit (étape 2). |
| Statut `gated` | Le type d'événement est désactivé dans les paramètres de l'intégration. Réactivez-le. |
| « Ce lien d'installation a expiré » | Le lien du Marketplace est valable 1 heure. Relancez l'installation depuis le Marketplace Pipedrive. |
| « Cette installation Pipedrive a déjà été connectée à un compte DURUM.ai » | Le lien a déjà servi. Si la connexion n'apparaît pas dans vos intégrations, relancez l'installation. |
| « Votre rôle ne permet pas de connecter une intégration » | Seuls les rôles agence et client peuvent finaliser la connexion. Demandez à un administrateur. |

### FAQ

**Est-ce que DURUM.ai importe mon historique Pipedrive ?**

DURUM.ai importe vos reps, pipelines, étapes, contacts, affaires, activités, notes et courriels envoyés pour l'enrichissement des fiches. Aucun lead, aucune vente et aucun rendez-vous ne sont créés à partir de l'historique : les événements sont comptés à partir de la connexion.

**D'où viennent les reps ?**

Chaque utilisateur actif de Pipedrive est importé comme rep (rôle ventes) avec son nom, son courriel et son téléphone.

**Je désinstalle DURUM.ai depuis Pipedrive, que se passe-t-il ?**

Pipedrive prévient DURUM.ai et la connexion passe en statut `revoked`. Les données déjà reçues sont conservées.

**Et si je déconnecte depuis DURUM.ai ?**

Les abonnements webhook créés par DURUM.ai sont supprimés de votre compte Pipedrive. Les événements de cette source cessent d'arriver immédiatement.

**Puis-je garder un autre CRM en parallèle ?**

Oui. Choisissez le rôle de Pipedrive dans l'assistant (Marketing, Ventes ou Les deux) pour refléter votre organisation.

---

---

Source: https://docs.durum.ai/integrations/pipedrive