# Pipedrive

Connectez Pipedrive pour que l'assistant reconnaisse les appelants par téléphone, crée des personnes et des affaires, et consigne chaque appel en note

> Full REST + WebSocket API reference: https://api.happ.tools/reference

Pipedrive se connecte avec votre jeton d'API personnel. Une fois la liaison faite, l'assistant salue les clients connus par leur nom en ayant leur dernière affaire sous les yeux, crée une personne et une affaire quand quelqu'un laisse une demande, et écrit le résultat de chaque appel dans la fiche du client.

## Ce que l'assistant peut faire [#what-the-assistant-can-do]

* **Reconnaître l'appelant** — au début d'un appel, il recherche le numéro de téléphone dans Pipedrive et obtient le nom, l'e-mail, l'organisation de la personne et sa dernière affaire (titre, étape, valeur).
* **Créer une affaire** — trouve la personne par téléphone ou en crée une nouvelle, puis crée une affaire dans le pipeline et l'étape de votre choix. La demande, l'adresse de livraison, les produits et l'annonce qui a amené le client sont ajoutés à l'affaire sous forme de note.
* **Consigner les appels** — après chaque appel, il ajoute une note à la personne et à son affaire : sens, durée, résultat, résumé, lien vers l'enregistrement et, si vous le souhaitez, la transcription complète.

## Avant de commencer [#before-you-start]

* **Utilisateur Pipedrive** dont les droits couvrent les affaires que l'assistant doit voir et créer — le jeton agit au nom de cet utilisateur.
* **Espace de travail HAPP** avec au moins un assistant.
* **Pipedrive activé pour votre espace de travail** — l'intégration est activée par entreprise. Demandez au support HAPP de l'activer.

## Obtenir le jeton d'API [#get-the-api-token]

1. Dans Pipedrive, cliquez sur votre avatar et ouvrez **Personal preferences > API**.
2. Copiez **Votre jeton d'API personnel**.

## Connecter [#connect]

1. Dans HAPP, ouvrez **Intégrations** et trouvez Pipedrive sous **Ajouter un CRM**.
2. Cliquez sur **Connecter**, collez le jeton et confirmez.
3. Pipedrive apparaît sous **Mes intégrations** avec le nom de votre entreprise.

## Paramètres [#settings]

Ouvrez l'icône d'engrenage de la carte dans l'onglet **Intégrations** de l'assistant.

* **Rechercher** — reconnaître l'appelant par téléphone.
* **Créer** — des affaires. Choisissez le **pipeline**, l'**étape** et le **propriétaire** ; sans eux, l'affaire va dans votre pipeline par défaut. Sans propriétaire, les affaires appartiennent à l'utilisateur du jeton.
* **Notes d'appel** — une note après chaque appel. **Transcription complète** ajoute le texte de la conversation.

## Limites [#limits]

* Pipedrive stocke les numéros de téléphone tels qu'ils ont été saisis ; l'assistant compare les 9 derniers chiffres, donc `050 111 22 33` et `+380501112233` sont le même client.
* Un numéro absent de Pipedrive ne reçoit pas de note d'appel — il n'y a aucune fiche à laquelle l'attacher.
* Le jeton est personnel : si cet utilisateur est désactivé, l'intégration cesse de fonctionner.

## Dépannage [#troubleshooting]

| Problème                                                                   | Cause                                                | Solution                                                                           |
| -------------------------------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------- |
| « Pipedrive rejected the API token »                                       | Le jeton a été régénéré ou l'utilisateur désactivé   | Copiez le jeton actuel et cliquez à nouveau sur **Connecter**.                     |
| « The Pipedrive user behind this token has no permission for this action » | L'utilisateur ne peut pas voir ou créer ces affaires | Utilisez le jeton d'un utilisateur disposant des droits de visibilité nécessaires. |
| « Pipedrive rate limit reached »                                           | Trop de requêtes à la fois                           | Rien à faire — la requête suivante passe.                                          |

## Déconnecter [#disconnect]

Déconnectez la carte dans HAPP. Pour révoquer complètement l'accès, régénérez le jeton d'API dans **Personal preferences > API**. Les personnes, affaires et notes déjà dans Pipedrive restent.

## Ensuite [#next]

* [CRM](/docs/integrations/crm) — toutes les intégrations CRM
* [Outils](/docs/agents/tools) — ce que l'assistant appelle pendant les conversations