# Pipedrive

Verbinden Sie Pipedrive, damit der Agent Anrufer anhand der Telefonnummer erkennt, Personen und Deals anlegt und jeden Anruf als Notiz festhält

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

Pipedrive wird über Ihr persönliches API-Token verbunden. Danach begrüßt der Agent bekannte Kunden mit Namen und hat ihren letzten Deal parat, legt eine Person und einen Deal an, wenn jemand eine Anfrage hinterlässt, und trägt das Ergebnis jedes Anrufs in den Datensatz des Kunden ein.

## Was der Agent kann [#what-the-assistant-can-do]

* **Anrufer erkennen** — zu Beginn eines Anrufs sucht er die Telefonnummer in Pipedrive und erhält Name, E-Mail und Organisation der Person sowie ihren letzten Deal (Titel, Phase, Wert).
* **Deal anlegen** — findet die Person über die Telefonnummer oder legt eine neue an und erstellt dann einen Deal in der gewählten Pipeline und Phase. Die Anfrage, die Lieferadresse, die Produkte und die Anzeige, über die der Kunde gekommen ist, landen als Notiz im Deal.
* **Anrufe protokollieren** — nach jedem Anruf fügt er der Person und ihrem Deal eine Notiz hinzu: Richtung, Dauer, Ergebnis, Zusammenfassung, Link zur Aufzeichnung und auf Wunsch das vollständige Transkript.

## Bevor Sie beginnen [#before-you-start]

* **Pipedrive-Benutzer**, dessen Rechte die Deals abdecken, die der Agent sehen und anlegen soll — das Token handelt im Namen dieses Benutzers.
* **HAPP-Workspace** mit mindestens einem Agenten.
* **Pipedrive für Ihren Workspace freigeschaltet** — die Integration wird pro Unternehmen freigeschaltet. Bitten Sie den HAPP-Support um die Aktivierung.

## API-Token abrufen [#get-the-api-token]

1. Klicken Sie in Pipedrive auf Ihren Avatar und öffnen Sie **Personal preferences > API**.
2. Kopieren Sie **Your personal API token**.

## Verbinden [#connect]

1. Öffnen Sie in HAPP **Integrationen** und suchen Sie Pipedrive unter **CRM hinzufügen**.
2. Klicken Sie auf **Verbinden**, fügen Sie das Token ein und bestätigen Sie.
3. Pipedrive erscheint unter **Meine Integrationen** mit dem Namen Ihres Unternehmens.

## Einstellungen [#settings]

Klicken Sie im Tab **Integrationen** des Agenten auf das Zahnradsymbol der Karte.

* **Suchen** — den Anrufer anhand der Telefonnummer erkennen.
* **Erstellen** — Deals anlegen. Wählen Sie **Pipeline**, **Phase** und **Verantwortlich**; ohne diese Angaben landet der Deal in Ihrer Standard-Pipeline. Ohne Verantwortlichen gehören Deals dem Benutzer des Tokens.
* **Anrufnotizen** — eine Notiz nach jedem Anruf. **Vollständiges Transkript** fügt den Gesprächstext hinzu.

## Einschränkungen [#limits]

* Pipedrive speichert Telefonnummern so, wie sie eingegeben wurden; der Agent vergleicht die letzten 9 Ziffern, daher gelten `050 111 22 33` und `+380501112233` als derselbe Kunde.
* Zu einer Nummer, die es in Pipedrive nicht gibt, wird keine Anrufnotiz angelegt — es gibt keinen Datensatz, dem sie zugeordnet werden könnte.
* Das Token ist persönlich: Wird dieser Benutzer deaktiviert, funktioniert die Integration nicht mehr.

## Fehlerbehebung [#troubleshooting]

| Problem                                                                  | Ursache                                                     | Lösung                                                                        |
| ------------------------------------------------------------------------ | ----------------------------------------------------------- | ----------------------------------------------------------------------------- |
| „Pipedrive rejected the API token“                                       | Das Token wurde neu generiert oder der Benutzer deaktiviert | Kopieren Sie das aktuelle Token und klicken Sie erneut auf **Verbinden**.     |
| „The Pipedrive user behind this token has no permission for this action“ | Der Benutzer darf diese Deals nicht sehen oder anlegen      | Verwenden Sie das Token eines Benutzers mit den nötigen Sichtbarkeitsrechten. |
| „Pipedrive rate limit reached“                                           | Zu viele Anfragen gleichzeitig                              | Kein Handlungsbedarf — die nächste Anfrage wird wieder ausgeführt.            |

## Trennen [#disconnect]

Trennen Sie die Karte in HAPP. Um den Zugriff vollständig zu entziehen, generieren Sie das API-Token unter **Personal preferences > API** neu. Personen, Deals und Notizen, die bereits in Pipedrive sind, bleiben erhalten.

## Weiter [#next]

* [CRM](/docs/integrations/crm) — alle CRM-Integrationen
* [Tools](/docs/agents/tools) — was der Agent während des Gesprächs aufruft