> 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. # Copper La tua receptionist può riconoscere i chiamanti già presenti in Copper, aggiungere nuovi chiamanti come lead, annotare ciò di cui ogni chiamante ha bisogno e creare un'attività di follow-up per il tuo team. Per cercare i chiamanti e creare attività vengono usati [strumenti webhook](/docs/it/reception-ai/integrations/webhooks). L'aggiunta di lead e note avviene tramite [Zapier](/docs/it/reception-ai/integrations/zapier), perché Copper memorizza i numeri di telefono e i collegamenti alle note come dati annidati che gli strumenti webhook non possono inviare. ## Prima di iniziare In Copper, apri **Impostazioni di sistema** → **Chiavi API** e seleziona **Genera chiave API**. Assegnale un'etichetta, ad esempio `Reception.ai`. La chiave agisce per tuo conto, quindi può visualizzare e modificare tutto ciò che puoi visualizzare e modificare tu. Ogni strumento webhook seguente invia questi header della richiesta: | Header | Valore | | ------------------ | ----------------------------------------------------- | | `X-PW-AccessToken` | la tua chiave API | | `X-PW-Application` | `developer_api` | | `X-PW-UserEmail` | l'indirizzo email dell'utente che ha creato la chiave | > **Warning** > > Chiunque disponga della chiave API e del tuo indirizzo email può leggere e modificare i tuoi dati Copper. Non inserire la chiave > in documenti condivisi e cancellala da Copper se viene divulgata. ## Crea gli strumenti webhook Per ogni strumento, vai su **Integrazioni**, seleziona **Aggiungi integrazione**, scegli **Strumento webhook** e imposta **Assegna agli agenti** su **Receptionist**. Gli endpoint di ricerca di Copper usano POST con la ricerca nel body. ### Trova un contatto | Campo | Valore | | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `find_copper_person` | | **Descrizione** | "Trova il chiamante tra i nostri contatti in base al numero di telefono. Usalo all'inizio di una chiamata per verificare se è un cliente." | | **Metodo** | POST | | **URL** | `https://api.copper.com/developer_api/v1/people/search` | | **Header della richiesta** | Gli header di [Prima di iniziare](#before-you-start) | | **Parametri del body** | `phone_number` (stringa, obbligatorio): "Il numero di telefono del chiamante." | ### Trova un lead | Campo | Valore | | -------------------------- | ------------------------------------------------------------------------------------------------------------------ | | **Nome** | `find_copper_lead` | | **Descrizione** | "Trova il chiamante tra i nostri lead in base al numero di telefono. Usalo quando il chiamante non è un contatto." | | **Metodo** | POST | | **URL** | `https://api.copper.com/developer_api/v1/leads/search` | | **Header della richiesta** | Gli header di [Prima di iniziare](#before-you-start) | | **Parametri del body** | `phone_number` (stringa, obbligatorio): "Il numero di telefono del chiamante." | ### Crea un'attività di follow-up | Campo | Valore | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_copper_task` | | **Descrizione** | "Crea un'attività per il team ogni volta che prometti al chiamante di richiamarlo." | | **Metodo** | POST | | **URL** | `https://api.copper.com/developer_api/v1/tasks` | | **Header della richiesta** | Gli header di [Prima di iniziare](#before-you-start) | | **Parametri del body** | `name` (stringa, obbligatorio): "Ad esempio: Richiama Jane Doe per un preventivo della cucina." `details` (stringa, obbligatorio): "Il nome, il numero di telefono e ciò di cui ha bisogno il chiamante." | Seleziona **Abilita** per ogni strumento. ## Aggiungi lead e note ### Collega Zapier Se non l'hai già fatto, collega [Zapier](/docs/it/reception-ai/integrations/zapier) in Reception.ai. ### Aggiungi le azioni Copper Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), collega il tuo account Copper e aggiungi queste azioni: * **Crea lead**: imposta il proprietario e la fonte del lead come valori fissi e lascia che l'IA compili il nome, il numero di telefono, l'indirizzo email e la richiesta del chiamante. * **Crea attività**: imposta il tipo di attività su nota e lascia che l'IA compili la persona o il lead trovato dagli strumenti di ricerca e ciò di cui il chiamante ha bisogno. ### Assegna gli strumenti In Reception.ai, apri la scheda **Strumenti** dell'integrazione Zapier, seleziona **Aggiorna strumenti** e assegna entrambe le azioni Copper al **Client** (receptionist). ### Provala [Prova la tua receptionist](/docs/it/reception-ai/receptionist/testing) con una chiamata da un numero salvato in un contatto Copper, poi da un nuovo numero che richiede di essere richiamato. Il nuovo chiamante viene visualizzato come lead e l'attività viene visualizzata in Copper. > **Tip** > > Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) affinché la tua receptionist > cerchi prima contatti e lead e crei un lead solo quando nessuna delle due ricerche trova il chiamante. ## Limitazioni * Gli strumenti webhook inviano valori non annidati, mentre Copper collega un'attività a una persona o a un lead con un valore annidato. Di conseguenza, le attività create da `create_copper_task` non sono collegate al record del chiamante; nei dettagli dell'attività vengono invece mantenuti il nome e il numero del chiamante. * Copper accetta le date di scadenza come timestamp Unix, che l'IA non può calcolare in modo affidabile, quindi `create_copper_task` lascia vuota la data di scadenza. * Per collegare le attività al chiamante o impostare una data di scadenza, usa l'azione **Crea attività** di Copper tramite Zapier anziché lo strumento webhook. * Ogni azione Zapier eseguita dalla tua receptionist usa attività del tuo piano Zapier. Quando il piano si esaurisce, le azioni si interrompono fino al ripristino. ## Risoluzione dei problemi | Problema | Cosa verificare | | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 401 o 403 da Copper | Verifica tutti e tre gli header. `X-PW-UserEmail` deve essere l'email dell'utente che ha generato la chiave. | | I chiamanti conosciuti non vengono trovati | Copper confronta i numeri di telefono nel formato in cui sono memorizzati. Salva i numeri in un unico formato e verifica che il chiamante sia una persona o un lead, non un'azienda. | | La receptionist crea lead duplicati | Indica nelle descrizioni degli strumenti di ricerca di creare un lead solo quando il chiamante non viene trovato. | | Un'azione Copper non viene visualizzata | Dopo aver aggiunto le azioni in Zapier, seleziona **Aggiorna strumenti** nell'integrazione Zapier. | | Un'azione mostra **Modificata** e non viene usata | L'hai modificata in Zapier. Seleziona **Aggiorna** nella scheda **Strumenti**. |