> 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

Dzięki poniższym [narzędziom webhook](/docs/pl/reception-ai/integrations/webhooks) twój recepcjonista może rozpoznawać dzwoniących, którzy są już w Pipedrive, otwierać transakcje dla nowych szans sprzedażowych i planować kontakt zwrotny dla twojego zespołu.

## Zanim zaczniesz

W Pipedrive otwórz **Personal preferences** → **API** i skopiuj token API. Każde z poniższych narzędzi wysyła go w nagłówku żądania `x-api-token`. Narzędzia działają w twoim imieniu, więc użyj tokenu użytkownika, który widzi właściwy lejek.

## Utwórz narzędzia

Dla każdego narzędzia przejdź do **Integrations**, wybierz **Add integration**, wybierz **Webhook Tool** i ustaw **Assign to agents** na **Receptionist**.

### Znajdź dzwoniącego

| Pole                    | Wartość                                                                                                                                     |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**               | `find_pipedrive_person`                                                                                                                     |
| **Opis**                | "Znajdź dzwoniącego w naszym CRM po numerze telefonu lub nazwie. Użyj na początku rozmowy o sprzedaży, wycenie lub istniejącej transakcji." |
| **Metoda**              | GET                                                                                                                                         |
| **URL**                 | `https://api.pipedrive.com/api/v2/persons/search`                                                                                           |
| **Nagłówki żądania**    | `x-api-token`: twój token API                                                                                                               |
| **Parametry zapytania** | `term` (string, wymagane): "Numer telefonu lub pełne imię i nazwisko dzwoniącego, co najmniej 2 znaki."                                     |

### Otwórz transakcję

| Pole                 | Wartość                                                                                                                                                                                                                                                                 |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**            | `create_pipedrive_deal`                                                                                                                                                                                                                                                 |
| **Opis**             | "Otwórz transakcję, gdy dzwoniący chce wycenę lub chce kupić. Dodaj imię i nazwisko dzwoniącego w tytule."                                                                                                                                                              |
| **Metoda**           | POST                                                                                                                                                                                                                                                                    |
| **URL**              | `https://api.pipedrive.com/api/v2/deals`                                                                                                                                                                                                                                |
| **Nagłówki żądania** | `x-api-token`: twój token API                                                                                                                                                                                                                                           |
| **Parametry body**   | `title` (string, wymagane): "Krótki tytuł z imieniem i nazwiskiem dzwoniącego oraz tym, czego chce."  `person_id` (number): "Id z `find_pipedrive_person`. Pomiń, jeśli nie znaleziono dzwoniącego."  `value` (number): "Wartość transakcji, jeśli podał ją dzwoniący." |

### Zaplanuj kontakt zwrotny

| Pole                 | Wartość                                                                                                                                                                                                                                                                                                                                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nazwa**            | `create_pipedrive_followup`                                                                                                                                                                                                                                                                                                                                                                              |
| **Opis**             | "Zaplanuj telefon od zespołu, gdy obiecasz dzwoniącemu kontakt zwrotny."                                                                                                                                                                                                                                                                                                                                 |
| **Metoda**           | POST                                                                                                                                                                                                                                                                                                                                                                                                     |
| **URL**              | `https://api.pipedrive.com/api/v2/activities`                                                                                                                                                                                                                                                                                                                                                            |
| **Nagłówki żądania** | `x-api-token`: twój token API                                                                                                                                                                                                                                                                                                                                                                            |
| **Parametry body**   | `subject` (string, wymagane): "Na przykład: Oddzwoń do Jane Doe w sprawie wyceny kuchni."  `type` (string, wymagane): "Zawsze dokładna wartość `call`."  `due_date` (string, wymagane): "Data kontaktu zwrotnego w formacie YYYY-MM-DD."  `note` (string, wymagane): "Imię i nazwisko dzwoniącego, numer telefonu oraz to, czego potrzebuje."  `deal_id` (number): "Id transakcji, jeśli ją otworzyłeś." |

Wybierz **Enable** dla każdego narzędzia, a potem [przetestuj recepcjonistę](/docs/pl/reception-ai/receptionist/testing) rozmową z prośbą o wycenę.

## Ograniczenia

Narzędzia webhook wysyłają płaskie wartości, a Pipedrive przechowuje numery telefonów osoby jako zagnieżdżoną listę. Dlatego te narzędzia nie mogą utworzyć nowego kontaktu z numerem telefonu. Zamiast tego numer dzwoniącego jest zapisany w notatce kontaktu zwrotnego. Aby tworzyć kontakty, użyj akcji **Create Person** Pipedrive przez [Zapier](/docs/pl/reception-ai/integrations/zapier).

## Rozwiązywanie problemów

| Problem                            | Co sprawdzić                                                                                                           |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| 401 z Pipedrive                    | Nagłówek musi nazywać się `x-api-token` i zawierać aktualny token.                                                     |
| Nie znaleziono znanych dzwoniących | Pipedrive dopasowuje numery telefonów tak, jak są zapisane. Zapisuj numery w jednym formacie lub szukaj też po nazwie. |
| Kontakt zwrotny nie ma typu        | `call` musi być typem aktywności na twoim koncie Pipedrive. Sprawdź **Company settings** → **Activities**.             |