> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Pipedrive

Mit den folgenden [Webhook-Tools](/docs/de/reception-ai/integrations/webhooks) kann Ihr Empfangsassistent Anrufende erkennen, die bereits in Pipedrive vorhanden sind, einen Deal für eine neue Gelegenheit eröffnen und einen Rückruf für Ihr Team planen.

## Bevor Sie beginnen

Öffnen Sie in Pipedrive **Personal preferences** → **API** und kopieren Sie Ihr API-Token. Jedes Tool unten sendet es im Request Header `x-api-token`. Die Tools handeln in Ihrem Namen. Verwenden Sie daher das Token eines Nutzers, der die richtige Pipeline sehen kann.

## Tools erstellen

Gehen Sie für jedes Tool zu **Integrationen**, wählen Sie **Integration hinzufügen**, dann **Webhook-Tool**, und setzen Sie **Agenten zuweisen** auf **Receptionist**.

### Anrufenden finden

| Feld                 | Wert                                                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**             | `find_pipedrive_person`                                                                                                                                                                    |
| **Beschreibung**     | "Finde den Anrufenden anhand seiner Telefonnummer oder seines Namens in unserem CRM. Verwende dies zu Beginn eines Gesprächs über einen Verkauf, ein Angebot oder einen bestehenden Deal." |
| **Methode**          | GET                                                                                                                                                                                        |
| **URL**              | `https://api.pipedrive.com/api/v2/persons/search`                                                                                                                                          |
| **Request Headers**  | `x-api-token`: Ihr API-Token                                                                                                                                                               |
| **Query Parameters** | `term` (String, erforderlich): "Die Telefonnummer oder der vollständige Name des Anrufenden, mindestens 2 Zeichen."                                                                        |

### Deal eröffnen

| Feld                | Wert                                                                                                                                                                                                                                                                                      |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `create_pipedrive_deal`                                                                                                                                                                                                                                                                   |
| **Beschreibung**    | "Eröffne einen Deal, wenn ein Anrufender ein Angebot möchte oder kaufen will. Nimm den Namen des Anrufenden in den Titel auf."                                                                                                                                                            |
| **Methode**         | POST                                                                                                                                                                                                                                                                                      |
| **URL**             | `https://api.pipedrive.com/api/v2/deals`                                                                                                                                                                                                                                                  |
| **Request Headers** | `x-api-token`: Ihr API-Token                                                                                                                                                                                                                                                              |
| **Body Parameters** | `title` (String, erforderlich): "Kurzer Titel mit dem Namen des Anrufenden und seinem Anliegen."  `person_id` (Zahl): "Die ID aus `find_pipedrive_person`. Weglassen, wenn der Anrufende nicht gefunden wurde."  `value` (Zahl): "Der Deal-Wert, sofern der Anrufende einen genannt hat." |

### Nachfassaktion planen

| Feld                | Wert                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**            | `create_pipedrive_followup`                                                                                                                                                                                                                                                                                                                                                                                      |
| **Beschreibung**    | "Plane einen Rückruf durch das Team, wenn du dem Anrufenden eine Nachfassaktion zusagst."                                                                                                                                                                                                                                                                                                                        |
| **Methode**         | POST                                                                                                                                                                                                                                                                                                                                                                                                             |
| **URL**             | `https://api.pipedrive.com/api/v2/activities`                                                                                                                                                                                                                                                                                                                                                                    |
| **Request Headers** | `x-api-token`: Ihr API-Token                                                                                                                                                                                                                                                                                                                                                                                     |
| **Body Parameters** | `subject` (String, erforderlich): "Zum Beispiel: Jane Doe wegen eines Küchenangebots zurückrufen."  `type` (String, erforderlich): "Immer der exakte Wert `call`."  `due_date` (String, erforderlich): "Das Datum der Nachfassaktion im Format JJJJ-MM-TT."  `note` (String, erforderlich): "Name, Telefonnummer und Anliegen des Anrufenden."  `deal_id` (Zahl): "Die Deal-ID, falls Sie einen eröffnet haben." |

Wählen Sie bei jedem Tool **Aktivieren** und [testen Sie Ihren Empfangsassistenten](/docs/de/reception-ai/receptionist/testing) mit einem Anruf, bei dem ein Angebot angefragt wird.

## Einschränkungen

Webhook-Tools senden flache Werte, und Pipedrive speichert die Telefonnummern einer Person als verschachtelte Liste. Daher können diese Tools keinen neuen Kontakt mit einer Telefonnummer erstellen. Die Notiz der Nachfassaktion enthält stattdessen die Nummer des Anrufenden. Um Kontakte zu erstellen, verwenden Sie die Pipedrive-Aktion **Create Person** über [Zapier](/docs/de/reception-ai/integrations/zapier).

## Fehlerbehebung

| Problem                                  | Prüfen Sie                                                                                                                                |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 401 von Pipedrive                        | Der Header muss `x-api-token` heißen und ein aktuelles Token enthalten.                                                                   |
| Bekannte Anrufende werden nicht gefunden | Pipedrive gleicht Telefonnummern wie gespeichert ab. Speichern Sie Nummern in einem einheitlichen Format oder suchen Sie auch nach Namen. |
| Die Nachfassaktion hat keinen Typ        | `call` muss in Ihrem Pipedrive-Konto ein Aktivitätstyp sein. Prüfen Sie **Company settings** → **Activities**.                            |