Vai alla navigazione

Odoo

Trova i chiamanti tra i tuoi contatti Odoo e aggiungi i nuovi chiamanti come lead CRM.

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 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 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.

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)

1

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.

2

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.

3

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.

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.

4

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.

5

Crea gli strumenti webhook

Per ogni strumento qui sotto, 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

CampoValore
Nomefind_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.”
MetodoPOST
URLhttps://YOUR_ODOO_ADDRESS/json/2/res.partner/name_search
Header richiestaAuthorization (Secret): Bearer seguito dalla tua chiave API
X-Odoo-Database (Value): il nome del tuo database, solo se necessario
Parametri bodyname (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 agentiReceptionist

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

CampoValore
Nomecreate_odoo_lead
Descrizione”Aggiungi chi chiama al nostro CRM come lead quando desidera un preventivo o essere ricontattato.”
MetodoPOST
URLhttps://YOUR_ODOO_ADDRESS/json/2/crm.lead/create
Header richiestaAuthorization (Secret): Bearer seguito dalla tua chiave API
X-Odoo-Database (Value): il nome del tuo database, solo se necessario
Parametri bodyvals_list (object, obbligatorio), con i campi seguenti
Assegna agli agentiReceptionist

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 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

1

Connetti Zapier

Se non l’hai ancora fatto, connetti Zapier in Reception.ai.

2

Aggiungi le azioni Odoo

Nel tuo server MCP Zapier su mcp.zapier.com, aggiungi le azioni qui sotto 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.

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.

3

Assegna gli strumenti

In Reception.ai, apri la scheda Strumenti dell’integrazione Zapier, seleziona Aggiorna strumenti e assegna ogni azione al Client (receptionist).

4

Provalo

Testa la tua receptionist 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

CampoValore
Azione ZapierTrova contatto
Imposta in ZapierNulla.
Lascia compilare all’IAL’indirizzo email di chi chiama oppure il nome completo se non ha un’email.
Assegna aClient

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

CampoValore
Azione ZapierCrea lead
Imposta in ZapierIl venditore e il team vendite a cui assegnare i nuovi lead, se il tuo account mostra questi campi.
Lascia compilare all’IAIl 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 aClient

Lascia vuoti i campi come il fatturato previsto, così la tua receptionist non dovrà stimare importi.

Qualunque opzione tu utilizzi, aggiungi una procedura affinché la tua receptionist chieda l’indirizzo email di chi chiama e lo cerchi prima di creare un lead.

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 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.
  • 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

ProblemaCosa controllare
401 da OdooL’header deve essere Authorization con Bearer , uno spazio e la chiave. Verifica che la chiave non sia scaduta né stata eliminata.
404 da OdooControlla 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 accessoL’utente Reception.ai deve avere l’accesso Vendite: Utente: tutti i documenti.
Odoo non trova il databaseAggiungi l’header X-Odoo-Database con il nome del tuo database.
Un’azione Odoo non appare in Reception.aiSeleziona Aggiorna strumenti nell’integrazione Zapier dopo aver aggiunto azioni in Zapier.
Un’azione mostra Modificato e non viene usataL’hai modificata in Zapier. Seleziona Aggiorna nella scheda Strumenti.
Zapier non riesce a connettersi a OdooVerifica 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 trovatiVerifica 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 sbagliatoImposta il venditore e il team vendite come valori fissi, nello strumento webhook o in Zapier.