> This is a page from the ElevenLabs documentation. For an index of the documentation, fetch https://elevenlabs.io/docs/llms.txt. # Odoo La tua receptionist può verificare se chi chiama è già tra i tuoi contatti Odoo e aggiungere i nuovi chiamanti a Odoo CRM come lead, includendo ciò di cui hanno bisogno, così il tuo team vendite può ricontattarli. Ci sono due modi per connettersi: * **[Strumenti webhook](#option-1-webhook-tools-recommended)** chiamano direttamente l'API JSON-2 di Odoo, senza account Zapier né utilizzo di task Zapier. Richiedono Odoo 19 o versioni successive, Community o Enterprise, ospitato su odoo.com, su Odoo.sh o sul tuo server. * **[Zapier](#option-2-zapier)** funziona anche con versioni precedenti di Odoo, ma ogni azione usa task del tuo piano Zapier e non può cercare in un database self-hosted. Usa gli strumenti webhook se il tuo database esegue Odoo 19 o versioni successive. La vecchia API di Odoo, JSON-RPC, riceve gli argomenti di ogni metodo come un unico elenco misto di valori, che gli strumenti webhook non possono creare; nelle versioni precedenti, quindi, usa Zapier. > **Note** > > Odoo consente alle app esterne di accedere ai tuoi dati solo con il piano **Custom**. Se il tuo database è > ospitato da Odoo con il piano One App Free o Standard, verifica il tuo piano prima di iniziare. ## Opzione 1: Strumenti webhook (consigliato) ### Controlla la versione di Odoo La versione di Odoo è visualizzata in fondo alla pagina **Impostazioni**. Gli strumenti webhook richiedono la versione 19 o successiva. Per un database self-hosted, il server deve essere raggiungibile da Internet tramite HTTPS. ### Crea un utente per Reception.ai In **Impostazioni** → **Utenti e aziende** → **Utenti**, crea un utente interno per Reception.ai. Assegnagli l'accesso **Vendite**: **Utente: tutti i documenti** e nessun accesso ad altre app, così la chiave API potrà fare solo ciò che serve agli strumenti. **Utente: tutti i documenti** gli consente di assegnare i nuovi lead al venditore che scegli. ### Crea una chiave API Le chiavi API degli utenti che non sono amministratori durano al massimo tre mesi. Per ottenere una chiave che duri un anno: 1. Come amministratore, attiva la modalità sviluppatore, poi vai in **Impostazioni** → **Utenti e aziende** → **Gruppi**. 2. Crea un gruppo denominato, ad esempio, `Reception.ai API key`, imposta **Durata massima delle chiavi API in giorni** su `365` e aggiungi l'utente Reception.ai al gruppo. Poi accedi come utente Reception.ai, apri **Preferenze** → **Sicurezza dell'account** e seleziona **Nuova chiave API**. Assegnale un nome, ad esempio `Reception.ai`, scegli la durata più lunga disponibile e copia subito la chiave: Odoo la mostra una sola volta. Annota la data di scadenza e sostituisci la chiave prima di quella data. > **Warning** > > La chiave API può fare tutto ciò che può fare l'utente Reception.ai. Non inserirla in documenti condivisi e > cancellala in Odoo se viene divulgata. ### Trova gli ID del venditore e del team vendite Apri l'utente del venditore in **Impostazioni** → **Utenti e aziende** → **Utenti**. Il numero alla fine dell'indirizzo della pagina è l'ID utente. Fai lo stesso per il team vendite in **CRM** → **Configurazione** → **Team vendite**. ### Crea gli strumenti webhook Per ogni [strumento qui sotto](#find-the-caller), vai su **Integrazioni**, seleziona **Aggiungi integrazione** e scegli **Strumento webhook**. Sostituisci `YOUR_ODOO_ADDRESS` con l'indirizzo del tuo database, ad esempio `mycompany.odoo.com`. Ogni strumento invia gli stessi header della richiesta: * `Authorization` (Secret): `Bearer ` seguito dalla tua chiave API * `X-Odoo-Database` (Value): il nome del tuo database. Necessario solo se il tuo server ospita più di un database. ### Trova chi chiama | Campo | Valore | | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Nome** | `find_odoo_contact` | | **Descrizione** | "Trova chi chiama tra i nostri contatti usando il suo indirizzo email oppure il nome completo se non ha un'email. Usalo prima di aggiungere un lead." | | **Metodo** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search` | | **Header richiesta** | `Authorization` (Secret): `Bearer ` seguito dalla tua chiave API `X-Odoo-Database` (Value): il nome del tuo database, solo se necessario | | **Parametri body** | `name` (string, obbligatorio): "L'indirizzo email di chi chiama o il suo nome completo, scritto come lo pronuncia." `operator` (string, valore fisso): `=ilike` `limit` (integer, valore fisso): `5` | | **Assegna agli agenti** | **Receptionist** | L'operatore `=ilike` corrisponde all'intero nome o indirizzo email, ignorando le maiuscole, quindi una ricerca di "Jane" non elenca tutte le Jane. Odoo restituisce solo l'ID e il nome di ogni corrispondenza. La ricerca contatti di Odoo non include i numeri di telefono, quindi la tua receptionist deve chiedere un indirizzo email o un nome. ### Aggiungi chi chiama come lead | Campo | Valore | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | **Nome** | `create_odoo_lead` | | **Descrizione** | "Aggiungi chi chiama al nostro CRM come lead quando desidera un preventivo o essere ricontattato." | | **Metodo** | POST | | **URL** | `https://YOUR_ODOO_ADDRESS/json/2/crm.lead/create` | | **Header richiesta** | `Authorization` (Secret): `Bearer ` seguito dalla tua chiave API `X-Odoo-Database` (Value): il nome del tuo database, solo se necessario | | **Parametri body** | `vals_list` (object, obbligatorio), con i campi seguenti | | **Assegna agli agenti** | **Receptionist** | Odoo prevede che i campi del nuovo lead siano inclusi in un oggetto `vals_list`. Seleziona **Aggiungi campo** su `vals_list` per ciascuno di questi: * `name` (string, obbligatorio, dalla conversazione): "Il titolo del lead, ad esempio: Preventivo cucina - Jane Doe." * `contact_name` (string, obbligatorio, dalla conversazione): "Il nome completo di chi chiama." * `email_from` (string, dalla conversazione): "L'indirizzo email di chi chiama, se lo ha fornito." * `phone` (string, obbligatorio, dalla conversazione): "Il numero di telefono di chi chiama in formato internazionale, ad esempio +14155550123." * `description` (string, obbligatorio, dalla conversazione): "Ciò di cui ha bisogno chi chiama, in poche frasi." * `user_id` (integer, valore fisso): l'ID utente del venditore * `team_id` (integer, valore fisso): l'ID del team vendite Il venditore e il team sono valori fissi, quindi ogni lead viene assegnato a loro anche se l'IA invia altri ID. Ometti campi come il fatturato previsto, così la tua receptionist non dovrà stimare importi. Seleziona **Abilita** su ogni strumento, poi [testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) come contatto esistente che fornisce il proprio indirizzo email, quindi come nuovo chiamante che chiede un preventivo. Il nuovo lead apparirà nella pipeline del tuo Odoo CRM. ## 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 Odoo Nel tuo server MCP Zapier su [mcp.zapier.com](https://mcp.zapier.com), aggiungi le [azioni qui sotto](#zapier-actions) dall'app **Odoo CRM** e accedi a Odoo quando Zapier lo richiede. Per ogni campo, imposta un valore fisso oppure lascia che lo compili l'IA, come indicato. L'app **Odoo CRM** funziona con database ospitati su odoo.com. Per un database self-hosted, consulta [Limitazioni](#limitations). Le azioni possono fare tutto ciò che può fare l'utente Odoo con cui accedi. Valuta di creare un utente dedicato con accesso solo a CRM e contatti. ### Assegna gli strumenti In Reception.ai, apri la scheda **Strumenti** dell'integrazione Zapier, seleziona **Aggiorna strumenti** e assegna ogni azione al **Client** (receptionist). ### Provalo [Testa la tua receptionist](/docs/it/reception-ai/receptionist/testing) come contatto esistente che fornisce il proprio indirizzo email, quindi come nuovo chiamante che chiede un preventivo. Il nuovo lead apparirà nella pipeline del tuo Odoo CRM. ### Azioni Zapier #### Trova chi chiama | Campo | Valore | | --------------------------- | --------------------------------------------------------------------------- | | **Azione Zapier** | **Trova contatto** | | **Imposta in Zapier** | Nulla. | | **Lascia compilare all'IA** | L'indirizzo email di chi chiama oppure il nome completo se non ha un'email. | | **Assegna a** | **Client** | L'app Zapier di Odoo trova i contatti in base al nome o all'indirizzo email, non al numero di telefono, quindi la tua receptionist deve chiederne uno. #### Aggiungi chi chiama come lead | Campo | Valore | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Azione Zapier** | **Crea lead** | | **Imposta in Zapier** | Il venditore e il team vendite a cui assegnare i nuovi lead, se il tuo account mostra questi campi. | | **Lascia compilare all'IA** | Il titolo del lead (ad esempio, "Preventivo cucina - Jane Doe"), il nome, l'email e il numero di telefono del contatto, nonché una descrizione di ciò di cui ha bisogno chi chiama. | | **Assegna a** | **Client** | Lascia vuoti i campi come il fatturato previsto, così la tua receptionist non dovrà stimare importi. > **Tip** > > Qualunque opzione tu utilizzi, aggiungi una [procedura](/docs/it/reception-ai/receptionist/rules-and-procedures) > affinché la tua receptionist chieda l'indirizzo email di chi chiama e lo cerchi prima di creare un > lead. > **Warning** > > La ricerca può restituire contatti che non corrispondono a chi chiama e **Trova contatto** in Zapier restituisce > tutto ciò che è salvato nel contatto. Aggiungi una > [regola](/docs/it/reception-ai/receptionist/rules-and-procedures) che dica alla tua receptionist di non > leggere mai a chi chiama i dettagli di un contatto e di usarli solo per riconoscerlo. ## Limitazioni * La tua receptionist non può cercare chi chiama in base al numero di telefono. Ha bisogno del suo indirizzo email o del nome esatto. * La descrizione del lead contiene ciò che desiderava chi chiamava. L'app **Odoo CRM** di Zapier non ha un'azione per aggiungere una nota o registrare una chiamata. * Con gli strumenti webhook, la chiave API scade. Sostituiscila prima della data di scadenza, altrimenti gli strumenti smetteranno di funzionare. * Con Zapier, un database Odoo self-hosted richiede invece l'app **Odoo ERP Self Hosted** di Zapier. La sua azione **Crea lead/opportunità** aggiunge lead, ma non ha azioni di ricerca, quindi un chiamante abituale può essere aggiunto due volte. Gli strumenti webhook possono cercare in un database self-hosted con Odoo 19 o versioni successive. * La tua receptionist non può verificare la disponibilità o prenotare riunioni in Odoo. Usa invece la funzione di prenotazione di Reception con [Google Calendar](/docs/it/reception-ai/integrations/google-calendar). * Con Zapier, ogni azione 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 fermano fino al ripristino. ## Risoluzione dei problemi | Problema | Cosa controllare | | ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 401 da Odoo | L'header deve essere `Authorization` con `Bearer `, uno spazio e la chiave. Verifica che la chiave non sia scaduta né stata eliminata. | | 404 da Odoo | Controlla l'indirizzo e che l'URL termini con `/json/2/res.partner/name_search` o `/json/2/crm.lead/create`. Il tuo database deve eseguire Odoo 19 o versioni successive e CRM deve essere installato. | | Odoo restituisce un errore di accesso | L'utente Reception.ai deve avere l'accesso **Vendite**: **Utente: tutti i documenti**. | | Odoo non trova il database | Aggiungi l'header `X-Odoo-Database` con il nome del tuo database. | | Un'azione Odoo non appare in Reception.ai | Seleziona **Aggiorna strumenti** nell'integrazione Zapier dopo aver aggiunto azioni in Zapier. | | Un'azione mostra **Modificato** e non viene usata | L'hai modificata in Zapier. Seleziona **Aggiorna** nella scheda **Strumenti**. | | Zapier non riesce a connettersi a Odoo | Verifica che il tuo piano Odoo consenta le app esterne e di usare l'app corretta per la posizione in cui è ospitato il database. | | I chiamanti già noti non vengono trovati | Verifica con chi chiama l'ortografia dell'indirizzo email. Le ricerche per nome richiedono il nome come salvato in Odoo e un contatto appartenente a un'azienda viene salvato con il nome dell'azienda, una virgola e il nome della persona. | | I lead vengono assegnati al venditore o team sbagliato | Imposta il venditore e il team vendite come valori fissi, nello strumento webhook o in Zapier. |