> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Twenty Il tuo receptionist può riconoscere i chiamanti già presenti in Twenty e aggiungere nuovi chiamanti come persone, con nome, numero di telefono e motivo della chiamata, così il tuo team commerciale potrà ricontattarli. Reception si connette al [server MCP](/docs/it/reception-ai/integrations/mcp-server) integrato di Twenty, che funziona sia con Twenty Cloud sia con Twenty self-hosted. Potresti anche creare [strumenti webhook](/docs/it/reception-ai/integrations/webhooks) per l'API REST di Twenty, ma il server MCP richiede meno configurazione: offre al tuo receptionist strumenti pronti per trovare e aggiungere persone, già associati ai campi del tuo workspace, incluso il campo del motivo della chiamata descritto sotto. ## Configurazione ### Aggiungi un campo per il motivo della chiamata Le persone in Twenty non hanno un campo per le note. Per conservare il motivo della chiamata nel loro record, vai in **Impostazioni** → **Modello dati**, apri **Persone** e aggiungi un campo **Testo** denominato `Call reason`. Solo gli amministratori del workspace possono modificare il modello dati. ### Crea un ruolo per Reception.ai Vai in **Impostazioni** → **Membri** → **Ruoli** e crea un ruolo che possa solo leggere e creare Persone. Nel passaggio successivo assegnerai a questo ruolo la chiave API. ### Crea una chiave API Vai in **Impostazioni** → **Sviluppatori** → **API** e seleziona **+ Crea chiave**. Assegnale un nome, ad esempio `Reception.ai`, e copiala subito: Twenty la mostra una sola volta. Poi apri il ruolo che hai creato, vai alla scheda **Assegnazione** e assegnagli la chiave. > **Warning** > > La chiave API può leggere e modificare tutto ciò che il suo ruolo consente. Non conservarla in documenti condivisi e > cancellala in Twenty se viene esposta. ### Aggiungi il server MCP In Reception.ai, vai su **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Server MCP**. | Campo | Valore | | ------------------ | -------------------------------------------------------------------- | | **Nome** | Twenty | | **Tipo di server** | HTTP streamable | | **URL del server** | L'indirizzo del tuo workspace seguito da `/mcp`, come indicato sotto | | **Token segreto** | La tua chiave API | | Dove viene eseguito Twenty | URL del server | | -------------------------- | -------------------------------------------------------------------------- | | Twenty Cloud | L'URL del tuo workspace, ad esempio `https://mycompany.twenty.com/mcp` | | Self-hosted | L'URL pubblico della tua istanza, ad esempio `https://crm.example.com/mcp` | Puoi copiare l'indirizzo esatto da **Impostazioni** → **IA** → **MCP** in Twenty. Non aggiungere `?mode=meta` all'URL: questa modalità offre al tuo receptionist un unico strumento in grado di eseguire qualsiasi azione. Seleziona **Abilita**. Reception.ai invia la chiave come bearer token e mostra gli strumenti di Twenty. ### Assegna gli strumenti Twenty elenca uno strumento per ogni azione su ogni oggetto. Apri la scheda **Strumenti** e assegna solo questi al **Client** (receptionist): * `find_many_people`: trova il chiamante in base al numero di telefono. * `create_one_person`: aggiunge un nuovo chiamante con nome, numero di telefono e motivo della chiamata. Lascia non assegnati gli strumenti di aggiornamento ed eliminazione, nonché quelli per altri oggetti. ### Aggiungi una procedura Aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) per i nuovi lead: cerca prima il chiamante per numero di telefono, crea una persona solo quando non trovi corrispondenze e compila sempre nome, cognome, numero di telefono e motivo della chiamata. Aggiungi una regola che impedisca al tuo receptionist di leggere ai chiamanti i record CRM. ### Provala [Metti alla prova il tuo receptionist](/docs/it/reception-ai/receptionist/testing) chiamando da un numero salvato per una persona in Twenty, poi come nuovo chiamante che desidera un preventivo. La nuova persona apparirà in **Persone** con il motivo della chiamata compilato. ## Limitazioni * Twenty memorizza il prefisso internazionale separatamente dal resto del numero. I chiamanti salvati senza prefisso internazionale, o in un formato diverso, potrebbero non essere trovati, quindi un chiamante abituale può essere aggiunto due volte. * Con questa configurazione il tuo receptionist non crea note, attività o opportunità. Il tuo team gestisce le nuove persone dall'elenco **Persone**, ad esempio con una vista filtrata in base a **Motivo della chiamata**. * Le istanze self-hosted richiedono una versione di Twenty che includa il server MCP e l'URL pubblico deve essere raggiungibile da internet tramite HTTPS. * L'API di Twenty consente 100 richieste al minuto. I workspace molto attivi con altre integrazioni potrebbero raggiungere il limite. ## Risoluzione dei problemi | Problema | Cosa controllare | | ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Non viene elencato alcuno strumento | Usa il tipo di server **HTTP streamable** e controlla che l'URL termini con `/mcp`. In self-hosted, l'impostazione `SERVER_URL` deve essere il tuo URL pubblico. | | Uno strumento restituisce un errore di autorizzazione | Il ruolo della chiave non può leggere o creare Persone. Modifica il ruolo in **Impostazioni** → **Membri** → **Ruoli**. | | I chiamanti conosciuti non vengono trovati | Salva i numeri di telefono con il prefisso internazionale e in un unico formato. | | Il motivo della chiamata è vuoto | Seleziona **Aggiorna strumenti** dopo aver aggiunto il campo `Call reason`, quindi seleziona **Aggiorna** sullo strumento modificato. | | Hai modificato la chiave | Modifica l'integrazione e usa **Ruota token segreto (facoltativo)**. La chiave salvata non verrà più mostrata. |