Pipedrive | ElevenLabs Documentation

Dzięki poniższym narzędziom webhook 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ę 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.

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.