> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Attio La tua receptionist può riconoscere i chiamanti già presenti in Attio, aggiungere i nuovi chiamanti come persone con nome e numero di telefono e lasciare una nota su ciò che desideravano, così il tuo team può ricontattarli. Ci sono due modi per connettersi: * Gli **[strumenti webhook](#option-1-webhook-tools-recommended)** chiamano direttamente l'API di Attio, senza account Zapier né utilizzo di task Zapier. * Le azioni di **[Zapier](#option-2-zapier)** accedono ad Attio per tuo conto, ma ogni azione utilizza task del tuo piano Zapier. Usa gli strumenti webhook, a meno che tu non riesca a ottenere da un amministratore di Attio la creazione di un token di accesso. ## Opzione 1: Strumenti webhook (consigliato) ### Crea un token di accesso Devi essere un amministratore di Attio. Seleziona il menu a discesa accanto al nome del tuo workspace, apri **Impostazioni del workspace**, vai alla scheda **Sviluppatori** e seleziona **Nuovo token di accesso**. Assegnagli un nome, ad esempio `Reception.ai`, e concedigli solo gli scope necessari a questi strumenti: lettura della configurazione degli oggetti (`object_configuration:read`), lettura-scrittura dei record (`record_permission:read-write`) e lettura-scrittura delle note (`note:read-write`). Le etichette in Attio potrebbero essere leggermente diverse da questi nomi. Il token non scade e può visualizzare tutte le persone nel tuo workspace. Eliminalo in Attio se viene compromesso. ### Crea gli strumenti webhook Per ogni [strumento qui sotto](#find-the-caller), vai a **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Strumento webhook**. Ogni strumento invia lo stesso header: `Authorization` (Segreto), impostato su `Bearer ` seguito dal tuo token. ### Aggiungi una regola Aggiungi una [regola](/docs/it/reception-ai/receptionist/rules-and-procedures) che indichi alla tua receptionist di usare Attio solo per riconoscere i chiamanti e di non leggere mai record o note ad alta voce. ### Trova il chiamante | Campo | Valore | | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `find_attio_person` | | **Descrizione** | "Trova il chiamante tra le nostre persone in Attio usando il numero di telefono. Usalo all'inizio di una chiamata. Passa il record_id della persona allo strumento per le note." | | **Metodo** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records/query` | | **Header della richiesta** | `Authorization` (Segreto): `Bearer ` seguito dal tuo token | | **Parametri del body** | `filter` (oggetto, obbligatorio), con il campo seguente `limit` (intero, valore fisso): `5` | | **Assegna agli agenti** | **Receptionist** | Seleziona **Aggiungi campo** in `filter` e aggiungi: * `phone_numbers` (stringa, obbligatorio, dalla conversazione): "Il numero di telefono del chiamante in formato internazionale, ad esempio +14155550123." Attio restituisce solo le persone il cui numero salvato corrisponde esattamente, quindi salva i numeri con il prefisso internazionale. ### Aggiungi il chiamante | Campo | Valore | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_attio_person` | | **Descrizione** | "Aggiungi il chiamante come persona solo quando `find_attio_person` non lo ha trovato. Passa il record_id della nuova persona allo strumento per le note." | | **Metodo** | POST | | **URL** | `https://api.attio.com/v2/objects/people/records` | | **Header della richiesta** | `Authorization` (Segreto): `Bearer ` seguito dal tuo token | | **Parametri del body** | `data` (oggetto, obbligatorio), con i campi seguenti | | **Assegna agli agenti** | **Receptionist** | Seleziona **Aggiungi campo** in `data` e aggiungi `values` (oggetto, obbligatorio). In `values`, aggiungi: * `name` (oggetto, obbligatorio), con tre campi: * `first_name` (stringa, obbligatorio, dalla conversazione): "Il nome del chiamante." * `last_name` (stringa, obbligatorio, dalla conversazione): "Il cognome del chiamante oppure una stringa vuota se non lo ha fornito." * `full_name` (stringa, obbligatorio, dalla conversazione): "Il nome e il cognome del chiamante." * `phone_numbers` (array, obbligatorio, dalla conversazione): "Esattamente un elemento, per il numero di telefono del chiamante." In **Ogni elemento**, scegli `string`, con descrizione "Il numero di telefono del chiamante in formato internazionale, ad esempio +14155550123." * `email_addresses` (array, dalla conversazione): "Esattamente un elemento, per l'indirizzo email del chiamante. Omettilo se non ne ha fornito uno." In **Ogni elemento**, scegli `string`, con descrizione "L'indirizzo email del chiamante." ### Registra una nota | Campo | Valore | | -------------------------- | ----------------------------------------------------------------------------------------------- | | **Nome** | `add_attio_note` | | **Descrizione** | "Annota ciò che desiderava il chiamante nel suo record persona, prima che la chiamata termini." | | **Metodo** | POST | | **URL** | `https://api.attio.com/v2/notes` | | **Header della richiesta** | `Authorization` (Segreto): `Bearer ` seguito dal tuo token | | **Parametri del body** | `data` (oggetto, obbligatorio), con i campi seguenti | | **Assegna agli agenti** | **Receptionist** | Seleziona **Aggiungi campo** in `data` per ciascuno dei seguenti: * `parent_object` (stringa, valore fisso): `people` * `parent_record_id` (stringa, obbligatorio, dalla conversazione): "Il record_id della persona da `find_attio_person` o `create_attio_person`." * `title` (stringa, obbligatorio, dalla conversazione): "Un titolo breve, ad esempio: Chiamata da Jane Doe per un preventivo." * `format` (stringa, valore fisso): `plaintext` * `content` (stringa, obbligatorio, dalla conversazione): "Ciò che desiderava il chiamante, in poche frasi." L'oggetto principale e il formato sono valori fissi, quindi le note vengono sempre aggiunte a una persona, anche se l'IA invia altri valori. > **Warning** > > `find_attio_person` restituisce tutto ciò che è salvato nella persona. Mantieni la regola attiva affinché la tua > receptionist usi Attio solo per riconoscere il chiamante e i chiamanti non sentano mai i dettagli di un'altra > persona. Seleziona **Abilita** su ogni strumento, quindi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) con una chiamata da un numero salvato per una persona in Attio, poi come nuovo chiamante che richiede di essere ricontattato. La nuova persona e una nota vengono visualizzate in Attio. ## Opzione 2: Zapier ### Connetti Zapier Se non l'hai ancora fatto, connetti [Zapier](/docs/it/reception-ai/integrations/zapier) in Reception.ai. ### Aggiungi le azioni Attio Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), aggiungi le [azioni qui sotto](#zapier-actions) dall'app **Attio** e connetti il tuo workspace Attio. Per ogni campo, imposta un valore fisso oppure lascia che l'IA lo compili, come indicato. ### Assegna gli strumenti In Reception.ai, apri la scheda **Strumenti** dell'integrazione Zapier, seleziona **Aggiorna strumenti** e assegna ogni azione come indicato. ### Aggiungi una regola Aggiungi una [regola](/docs/it/reception-ai/receptionist/rules-and-procedures) che indichi alla tua receptionist di usare Attio solo per riconoscere i chiamanti e di non leggere mai record o note ad alta voce. > **Warning** > > Zapier agisce come l'utente Attio che ha connesso il workspace e può vedere tutto ciò che quell'utente può vedere. > Connettilo con un membro il cui accesso sia limitato ai record necessari alla tua receptionist e mantieni la > regola attiva affinché i chiamanti non sentano mai i dettagli di un'altra persona. ### Testalo [Testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) con una chiamata da un numero salvato per una persona in Attio, poi come nuovo chiamante che richiede di essere ricontattato. La nuova persona e una nota vengono visualizzate in Attio. ### Azioni Zapier #### Trova il chiamante | Campo | Valore | | --------------------------- | -------------------------------------------------------------------------- | | **Azione Zapier** | **Trova record** | | **Imposta in Zapier** | L'oggetto: Persone. L'attributo in base a cui cercare: numero di telefono. | | **Lascia compilare all'IA** | Il valore da cercare: il numero di telefono del chiamante. | | **Assegna a** | **Cliente** | #### Aggiungi il chiamante | Campo | Valore | | --------------------------- | ----------------------------------------------------------------------------------- | | **Azione Zapier** | **Crea record** | | **Imposta in Zapier** | L'oggetto: Persone. Eventuali attributi che devono essere sempre uguali, se li usi. | | **Lascia compilare all'IA** | Nome, cognome, numero di telefono e indirizzo email. | | **Assegna a** | **Cliente** | #### Registra una nota | Campo | Valore | | --------------------------- | --------------------------------------------------------------------------------------------------------------------- | | **Azione Zapier** | **Crea nota** | | **Imposta in Zapier** | L'oggetto principale: Persone. | | **Lascia compilare all'IA** | L'ID del record principale (dalle azioni precedenti), un titolo e il testo della nota con ciò che serve al chiamante. | | **Assegna a** | **Cliente** | > **Tip** > > Qualunque opzione tu usi, aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) > affinché la tua receptionist cerchi prima il chiamante, crei una persona solo quando non trova corrispondenze > e poi registri una nota. ## Limitazioni * Attio verifica che i numeri di telefono siano validi. Indica alla tua receptionist, nella descrizione dello strumento o dell'azione, di inviare i numeri in formato internazionale, ad esempio `+14155550123`. * La creazione di una persona non riesce quando un'altra persona ha già lo stesso valore univoco, come un indirizzo email. La tua receptionist deve cercare prima. * I task creati tramite Zapier non possono essere collegati a un record Attio, quindi usa la nota per i dettagli della chiamata. * Con Zapier, ogni azione eseguita dalla tua receptionist utilizza task del tuo piano Zapier. Zapier attualmente 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 reimpostato. ## Risoluzione dei problemi | Problema | Cosa controllare | | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | 401 o 403 da Attio | Inizia il valore dell'header con `Bearer ` e uno spazio, quindi verifica che il token abbia gli scope indicati sopra e non sia stato eliminato. | | Un'azione Attio non viene visualizzata in Reception.ai | Seleziona **Aggiorna strumenti** nell'integrazione Zapier dopo aver aggiunto le azioni in Zapier. | | Un'azione mostra **Modificata** e non viene usata | L'hai modificata in Zapier. Seleziona **Aggiorna** nella scheda **Strumenti**. | | I chiamanti conosciuti non vengono trovati | Verifica che i numeri siano salvati con il prefisso internazionale. Con Zapier, verifica che **Trova record** cerchi nell'oggetto Persone in base al numero di telefono. | | La creazione di una persona non riesce | Il numero di telefono potrebbe non essere in formato internazionale oppure l'indirizzo email del chiamante è già salvato. | | Le note non sono collegate al chiamante | La tua receptionist ha bisogno dell'ID del record dallo strumento di ricerca o creazione oppure da **Trova record** o **Crea record** in Zapier. |