> 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.

# Nutshell

La tua receptionist può riconoscere i chiamanti già presenti in Nutshell e aggiungere nuovi chiamanti come persone con un lead affinché il tuo team possa ricontattarli. La ricerca dei chiamanti usa uno [strumento webhook](/docs/it/reception-ai/integrations/webhooks). L'aggiunta di persone e lead avviene tramite [Zapier](/docs/it/reception-ai/integrations/zapier), perché l'API di Nutshell richiede liste e valori annidati per creare record, che gli strumenti webhook non possono inviare.

## Cerca i chiamanti

### Crea una chiave API

In Nutshell, seleziona **Settings** nell'angolo in basso a sinistra, poi **API keys** in **Connections**. Seleziona **Add API key** e scegli **API + user impersonation**, necessaria anche per Zapier. Copia la chiave.

### Crea l'header di autorizzazione

L'API di Nutshell usa il tuo indirizzo email Nutshell come nome utente e la chiave API come password. Codificali in un terminale, sostituendo entrambi i valori e mantenendo i due punti tra loro:

```bash
printf 'YOUR_EMAIL:YOUR_API_KEY' | base64
```

Il valore dell'header è `Basic ` seguito dall'output.

> **Warning**
>
> Non incollare la tua chiave API in un codificatore online. Chiunque disponga della chiave o dell'header codificato può
> leggere e modificare i tuoi dati Nutshell.

### Crea lo strumento webhook

Vai a **Integrations**, seleziona **Add integration** e scegli **Webhook Tool**.

| Campo                      | Valore                                                                                                                                          |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Nome**                   | `find_nutshell_person`                                                                                                                          |
| **Descrizione**            | "Trova il chiamante nel nostro CRM tramite numero di telefono, nome o email. Usalo all'inizio di una chiamata per verificare se è già cliente." |
| **Metodo**                 | GET                                                                                                                                             |
| **URL**                    | `https://app.nutshell.com/rest/contacts`                                                                                                        |
| **Header della richiesta** | `Authorization`: `Basic ` seguito dal valore codificato                                                                                         |
| **Parametri query**        | `q` (stringa, obbligatorio): "Il numero di telefono, il nome completo o l'indirizzo email del chiamante."                                       |
| **Assegna agli agenti**    | **Receptionist**                                                                                                                                |

Seleziona **Enable**.

## Aggiungi persone e lead

### Collega Zapier

Se non l'hai ancora fatto, collega [Zapier](/docs/it/reception-ai/integrations/zapier) in Reception.ai.

### Aggiungi le azioni di Nutshell

Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), collega il tuo account Nutshell con la chiave API e aggiungi queste azioni:

* **Create Person**: lascia che l'IA compili il nome, il numero di telefono e l'indirizzo email del chiamante.
* **Create Lead**: imposta origine, pipeline e assegnatario come valori fissi e lascia che l'IA compili una descrizione di ciò che desidera il chiamante e della persona a cui si riferisce.

> **Tip**
>
> Per registrare la chiamata nella timeline della persona, aggiungi anche **Log Activity** e lascia che l'IA compili
> un breve riepilogo.

### Assegna gli strumenti

In Reception.ai, apri la scheda **Tools** dell'integrazione Zapier, seleziona **Refresh tools** e assegna le azioni Nutshell al **Client** (receptionist).

### Testalo

[Testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) con una chiamata da un numero salvato per una persona in Nutshell, poi come nuovo chiamante che desidera un preventivo. La nuova persona e il relativo lead appariranno in Nutshell.

## Limitazioni

* L'app Nutshell di Zapier non dispone di un'azione per creare un'attività di follow-up. L'assegnatario del lead vedrà invece i nuovi lead in Nutshell.
* L'app Nutshell di Zapier non può verificare la disponibilità di nessuno, quindi la tua receptionist non può fissare riunioni in Nutshell. Usa la prenotazione integrata di Reception con [Google Calendar](/docs/it/reception-ai/integrations/google-calendar).
* Ogni azione Zapier eseguita dalla tua receptionist usa task del tuo piano Zapier. Attualmente Zapier conta due task per ogni chiamata riuscita; le chiamate non riuscite non vengono conteggiate. Quando il piano si esaurisce, le azioni si interrompono finché non viene ripristinato.

## Risoluzione dei problemi

| Problema                                      | Cosa verificare                                                                                                           |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| 401 da Nutshell                               | Codifica il tuo indirizzo email Nutshell, i due punti e la chiave, quindi inizia il valore dell'header con `Basic `.      |
| I chiamanti già noti non vengono trovati      | Prova una chiamata di test da un numero salvato per una persona in Nutshell, oppure chiedi al chiamante il nome.          |
| La receptionist crea persone duplicate        | Indica nella descrizione dello strumento di ricerca di aggiungere una persona solo quando il chiamante non viene trovato. |
| Un'azione Nutshell non appare in Reception.ai | Seleziona **Refresh tools** nell'integrazione Zapier dopo aver aggiunto azioni in Zapier.                                 |
| Zapier non riesce a collegarsi a Nutshell     | Usa una chiave API con **API + user impersonation**.                                                                      |