Pipedrive | ElevenLabs Documentation

Con gli strumenti webhook qui sotto, la tua receptionist può riconoscere i chiamanti già presenti in Pipedrive, aprire una trattativa per una nuova opportunità e programmare una chiamata di follow-up per il tuo team.

Prima di iniziare

In Pipedrive, apri Personal preferences → API e copia il tuo token API. Ogni strumento qui sotto lo invia nell’header della richiesta x-api-token. Gli strumenti agiscono per tuo conto, quindi usa il token di un utente che può visualizzare la pipeline corretta.

Crea gli strumenti

Per ogni strumento, vai a Integrations, seleziona Add integration, scegli Webhook Tool e imposta Assign to agents su Receptionist.

Trova un chiamante

Campo	Valore
Nome	`find_pipedrive_person`
Descrizione	”Trova il chiamante nel nostro CRM in base al numero di telefono o al nome. Usalo all’inizio di una chiamata relativa a una vendita, un preventivo o una trattativa esistente.”
Metodo	GET
URL	`https://api.pipedrive.com/api/v2/persons/search`
Header della richiesta	`x-api-token`: il tuo token API
Parametri query	`term` (stringa, obbligatorio): “Il numero di telefono o il nome completo del chiamante, di almeno 2 caratteri.”

Apri una trattativa

Campo	Valore
Nome	`create_pipedrive_deal`
Descrizione	”Apri una trattativa quando un chiamante desidera un preventivo o vuole acquistare. Includi il nome del chiamante nel titolo.”
Metodo	POST
URL	`https://api.pipedrive.com/api/v2/deals`
Header della richiesta	`x-api-token`: il tuo token API
Parametri del body	`title` (stringa, obbligatorio): “Titolo breve con il nome del chiamante e ciò che desidera.” `person_id` (numero): “L’id da `find_pipedrive_person`. Omettilo se il chiamante non è stato trovato.” `value` (numero): “Il valore della trattativa, se il chiamante ne ha indicato uno.”

Programma un follow-up

Campo	Valore
Nome	`create_pipedrive_followup`
Descrizione	”Programma una richiamata del team ogni volta che prometti un follow-up al chiamante.”
Metodo	POST
URL	`https://api.pipedrive.com/api/v2/activities`
Header della richiesta	`x-api-token`: il tuo token API
Parametri del body	`subject` (stringa, obbligatorio): “Ad esempio: Richiama Jane Doe per un preventivo della cucina.” `type` (stringa, obbligatorio): “Sempre l’esatto valore `call`.” `due_date` (stringa, obbligatorio): “La data del follow-up nel formato AAAA-MM-GG.” `note` (stringa, obbligatorio): “Il nome del chiamante, il numero di telefono e ciò di cui ha bisogno.” `deal_id` (numero): “L’id della trattativa, se ne hai aperta una.”

Seleziona Enable su ogni strumento, quindi testa la tua receptionist con una chiamata in cui viene richiesto un preventivo.

Limitazioni

Gli strumenti webhook inviano valori semplici e Pipedrive memorizza i numeri di telefono di una persona come elenco annidato. Quindi questi strumenti non possono creare un nuovo contatto con un numero di telefono. La nota del follow-up conserva invece il numero del chiamante. Per creare contatti, usa l’azione Create Person di Pipedrive tramite Zapier.

Risoluzione dei problemi

Problema	Cosa controllare
401 da Pipedrive	L’header deve chiamarsi `x-api-token` e contenere un token valido.
I chiamanti noti non vengono trovati	Pipedrive confronta i numeri di telefono così come sono memorizzati. Memorizza i numeri in un unico formato oppure cerca anche per nome.
Il follow-up non ha un tipo	`call` deve essere un tipo di attività nel tuo account Pipedrive. Controlla Company settings → Activities.