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 integrato di Twenty, che funziona sia con Twenty Cloud sia con Twenty self-hosted. Potresti anche creare strumenti webhook 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.
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.
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 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 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.