> 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

Con gli [strumenti webhook](/docs/it/reception-ai/integrations/webhooks) 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](/docs/it/reception-ai/receptionist/testing) 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](/docs/it/reception-ai/integrations/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**.                       |