Come collegare Odoo a BOTS4.me: guida all’installazione del connettore (Odoo 13–19)

🧭 Prima di tutto scelga il percorso: dove gira il suo Odoo?

I percorsi di installazione sono due, e a decidere tra i due è solo il tipo di hosting del suo Odoo. Entrambi portano allo stesso punto: un solo collegamento serve tutte le app BOTS4.me che lavorano con Odoo.

Non sa quale hosting ha — oppure lo sta ancora scegliendo? Veda Odoo Online, Odoo.sh o on-premise a confronto: quale si può automatizzare?

Nota sul piano: Odoo Online richiede il piano Custom di Odoo per l’accesso API; Odoo.sh e on-premise funzionano con qualsiasi piano.

🔌 Percorso A: Odoo.sh & on-premise — il connettore con installazione in un clic

• Passo 1 — Crei il suo account BOTS4.me. Si registri su bots4.me/bots, oppure salti questo passo e crei l’account all’interno di Odoo nel Passo 3. Ogni app ad avvio gratuito inizia poi con un mese Discovery gratuito.
• Passo 2 — Installi «BOTS4.me Connect». Su apps.odoo.com apra BOTS4.me Connect, scelga la sua versione di Odoo (dalla 13.0 alla 19.0) e scarichi lo zip gratuito; contiene una cartella, b4m_connect. On-premise: metta quella cartella in una directory del suo addons path, riavvii il servizio Odoo, attivi la modalità sviluppatore, apra App → Aggiorna elenco app, cerchi «BOTS4.me Connect» e clicchi Attiva (Installa nelle versioni precedenti). Odoo.sh: faccia il commit della cartella nel suo repository (meglio prima su un branch di staging) e il push; quando la build è verde, lo installi da App nel database di quella build. I moduli per singola app presenti nello store (per esempio «Mail2ERP by BOTS4.me») si installano allo stesso modo e mostrano solo la propria app. Il codice sorgente è LGPL-3, quindi lei o il suo integratore potete leggerne ogni riga prima dell’installazione.
• Passo 3 — Esegua la procedura guidata di collegamento. Come amministratore Odoo, apra BOTS4.me Connect → Impostazioni e clicchi Connetti. Scelga «Crea un nuovo account su www.bots4.me» (inserisca la sua e-mail; se un partner BOTS4.me ci ha consigliati, inserisca il suo codice in Codice partner) oppure «Ho già un account su www.bots4.me» (e-mail e password). Poi inserisca il codice a 6 cifre ricevuto via e-mail, o quello della sua app di autenticazione se ne usa una. La procedura comunica direttamente con bots4.me tramite HTTPS; nessuna credenziale viene digitata in schermate di terze parti.
• Passo 4 — Le chiavi vengono generate per lei. Dopo l’accesso riuscito, BOTS4.me emette una chiave API e un segreto di firma HMAC per questo specifico database Odoo, e il modulo crea un utente tecnico locale, «BOTS4.me Connect», così i bot leggono e scrivono i record di Odoo tramite XML-RPC con la propria identità, mai con il suo login personale di amministratore. Quell’utente riceve solo i diritti Odoo delle app che attiva. Come ogni utente interno, conta ai fini di un abbonamento Odoo Enterprise per utente. Da Odoo 18 in poi, Odoo limita la durata di validità delle chiavi API: quando il modulo mostra «La chiave API sta per scadere», clicchi Disconnetti, poi Connetti, e nessuna impostazione delle app va persa.
• Passo 5 — I moduli di configurazione sono precompilati. Il connettore invia i metadati del suo Odoo (URL, UUID del database, dati di fatturazione dell’azienda, indirizzi dei server di posta IMAP) per precompilare i moduli di configurazione di BOTS4.me. Le password della posta restano nel suo Odoo finché non affida una casella a un’app, con + La mia posta IMAP (1 clic) oppure cliccando Inizia il mese Discovery gratuito su un’app che legge la posta. Vengono crittografate prima di lasciare il suo Odoo.
• Passo 6 — Attivi la sua prima app. In App, ogni app mostra il suo stato (Non attivata, Richiede configurazione, Attiva, Configurata). Clicchi una volta Completi prima la fatturazione, compili i dati di fatturazione su bots4.me, poi clicchi Inizia il mese Discovery gratuito sull’app che desidera. Quel solo clic attiva l’app, collega questo Odoo come suo ERP e, per le app che leggono la posta, le affida la casella IMAP del suo Odoo. Per tutto ciò che manca ancora, l’app ha un pulsante dedicato: + Questo Odoo come ERP (1 clic), + La mia posta IMAP (1 clic), + Casella di posta (Gmail, Microsoft 365) o + Archiviazione cloud. Dashboard, Registri e Impostazioni aprono bots4.me con l’accesso già effettuato.

☁️ Percorso B: Odoo Online — configurazione senza codice con una chiave API

Odoo Online (l’edizione SaaS su odoo.com) non consente moduli Python personalizzati — è una regola della piattaforma, non un limite di BOTS4.me. Perciò il percorso Online usa un modulo XML di supporto senza codice più una normale chiave API di Odoo che crea lei stesso (l’accesso all’API esterna fa parte del piano Custom di Odoo):

• Passo 1 — crei il suo account BOTS4.me su bots4.me/bots.
• Passo 2 — Crei una chiave API di Odoo. Nel suo database Odoo Online vada in Impostazioni → Utenti e aziende → Utenti → il suo utente → Sicurezza account (attivi la modalità sviluppatore se la scheda è nascosta) e clicchi Nuova chiave API. La chiami «BOTS4.me», scelga per quanto tempo resta valida (Odoo 18 e successivi lo chiedono) e copi la chiave; Odoo la mostra una sola volta. Prima che scada, ne crei una nuova e la incolli nello stesso collegamento Odoo su bots4.me (Modifica → Aggiorna l’account ERP).
• Passo 3 — Avvii l’app e incolli la chiave su bots4.me. Acceda a bots4.me/bots, clicchi Inizia il mese Discovery gratuito sulla scheda dell’app e accetti una volta i Termini — nessuna carta di credito necessaria. Poi apra Impostazioni (ingranaggio) → l’app → Access Manager, clicchi Aggiungi destinazione o Aggiungi origine (l’app mostra quello che le serve), scelga ERP → Odoo e compili URL di Odoo (per https://yourcompany.odoo.com il nome del database si compila da solo), la sua e-mail di login come Nome utente e la chiave API in Password o chiave API. Clicchi Aggiungi account ERP.
• Passo 4 — Aggiunga il modulo di supporto senza codice (facoltativo). Il modulo «BOTS4.me for Odoo Online» su apps.odoo.com contiene solo record di dati, niente Python, quindi Odoo Online lo accetta. Aggiunge al suo Odoo un’app BOTS4.me con Connetti / Dashboard, Guida alla configurazione e Come creare una chiave API. In ogni caso i bot si collegano tramite l’API esterna standard di Odoo.
• Passo 5 — Verifichi in DEMO. Nella scheda Controlli dell’app attivi l’Accensione del bot e lasci la Modalità su DEMO. Dopo la prima esecuzione riceve un’e-mail di report DEMO che elenca cosa ha letto il bot e cosa avrebbe scritto, e la scheda Registri mostra ogni decisione; in Odoo non cambia nulla. Quando i report DEMO la convincono, imposti Modalità su LIVE nella scheda Controlli — si sblocca dopo la prima e-mail di report DEMO.

🧭 Lo provi nel suo mese Discovery gratuito

Il primo mese di ogni app ad avvio gratuito è un mese Discovery gratuito: il volume di utilizzo del piano Personal, con molte funzioni Family e Business sbloccate per la prova, e nessuna carta di credito necessaria. Ecco il percorso più breve da «collegato» a un primo risultato in Odoo.

• 1 — Avvii l’app. In Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Impostazioni, clicchi una volta Completi prima la fatturazione, poi Inizia il mese Discovery gratuito sull’app. Su Odoo Online: acceda a bots4.me/bots, clicchi Inizia il mese Discovery gratuito sulla scheda dell’app e accetti una volta i Termini — nessuna carta di credito necessaria. In entrambi i casi la dashboard mostra poi «Mese Discovery gratuito — mancano N giorni».
• 2 — Colleghi ciò di cui l’app ha bisogno. In Odoo, avviare l’app collega già questo Odoo e, se il suo Odoo ha un server di posta IMAP, la relativa casella. Usi + Questo Odoo come ERP (1 clic) o + Casella di posta (Gmail, Microsoft 365) per tutto ciò che manca ancora. Su Odoo Online, aggiunga il collegamento Odoo nell’Access Manager come descritto nel Percorso B, e la casella con Aggiungi origine.
• 3 — Lo esegua in DEMO. Apra la scheda Controlli dell’app (oppure Controllo rapido in Odoo), attivi l’Accensione del bot e lasci la Modalità su DEMO. Gli interruttori con il tag Discovery nella scheda Controlli sono inclusi nel suo mese gratuito e partono disattivati — attivi quelli che desidera provare.
• 4 — Verifichi il risultato. Dopo la prima esecuzione legga l’e-mail di report DEMO e la scheda Registri: ogni documento letto dal bot e ciò che avrebbe creato o modificato in Odoo.
• 5 — Passi in LIVE. Quando i report DEMO la convincono, imposti Modalità su LIVE nella scheda Controlli — si sblocca dopo la prima e-mail di report DEMO. Il bot scrive ora in Odoo attraverso il collegamento che ha configurato, con i diritti del suo utente Odoo.
• 6 — Dopo il mese. Alla fine del mese, l’app prosegue da sola con il piano gratuito e una piccola quota mensile: quando è esaurita, i nuovi elementi attendono il mese successivo o finché non sceglie un piano, e un elemento già avviato viene sempre completato. Scelga un piano per mantenere tutte le funzioni — veda la tabella dei piani nella pagina prodotto dell’app.

🔒 Il modello di sicurezza, spiegato con onestà

Sta dando a un servizio esterno l’accesso al suo ERP, quindi è giusto pretendere dettagli concreti — non solo un bollino “sicurezza di livello bancario”. Ecco esattamente com’è costruito BOTS4.me Connect:

• Solo HTTPS, scritto nel codice. L’endpoint dell’API è fissato a https://bots4.me nel sorgente del modulo — non è un campo modificabile nelle impostazioni, quindi un record di configurazione compromesso non può dirottare il suo traffico API verso un server ostile. Ogni URL restituito dall’API viene verificato prima che il browser lo apra; le risposte non HTTPS o provenienti da altri host vengono rifiutate.
• Firma delle richieste con HMAC-SHA256. Ogni chiamata che il modulo fa a BOTS4.me è firmata con il segreto specifico del database, così le richieste non possono essere falsificate né alterate durante il transito.
• Credenziali riservate agli amministratori. I campi della chiave API, del segreto di firma e dell’utente tecnico hanno un controllo degli accessi a livello di campo limitato al gruppo di amministrazione di Odoo (base.group_system). Gli utenti interni normali vedono il menu di avvio e gli stati delle app, ma i segreti non compaiono mai in nessuna lettura di record che possano eseguire — e tutte le azioni di connessione, disconnessione e configurazione sono riservate agli amministratori.
• Open source, LGPL-3. Il codice sorgente completo è incluso nello zip che scarica da apps.odoo.com, così il suo integratore può verificare esattamente cosa lascia il suo server: metadati per precompilare i moduli, una password della casella solo quando affida quella casella a un’app (crittografata prima di uscire) e mai i suoi documenti aziendali.
• Tracciabilità su entrambi i lati. Il modulo tiene dentro Odoo un registro locale degli eventi di connessione, delle modifiche di configurazione e degli errori; la dashboard BOTS4.me conserva i registri completi delle decisioni di ogni esecuzione.
• Aggiornamento automatico dei diritti. Un cron pianificato ricontrolla regolarmente i suoi abbonamenti, così gli stati delle app nel menu di avvio restano aggiornati — e un’app disdetta smette di essere servita in tempi brevi.

Altre informazioni sulla sicurezza della piattaforma e sull’accesso graduale: bots4.me/security e livelli di accesso. La piattaforma è ospitata nell’UE, progettata per il GDPR, e la 2FA è disponibile su ogni account.

✅ Dopo il collegamento: un solo collegamento per ogni app Odoo

Il connettore si installa una sola volta; non c’è altro da installare per ogni app. Un solo collegamento serve tutte le app BOTS4.me che funzionano con Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP e AutoCASH, più AutoSTOCK, AutoPURCHASE e ClientFACTORY. AutoSPAM, Mail2CLOUD e Mail2KNOW richiedono solo una casella di posta, che il connettore può passare dal suo Odoo in un clic. Ogni app si avvia separatamente, dalla sua riga in Odoo o dalla sua scheda su bots4.me/bots.

Ogni app parte in DEMO: legge, decide e le invia un report DEMO, ma non scrive nulla. Quando i report DEMO la convincono, imposti Modalità su LIVE nella scheda Controlli — si sblocca dopo la prima e-mail di report DEMO. Su bots4.me, la scheda Controlli di ogni app contiene l’Accensione del bot, la Modalità, la Modalità IA (Disattivata, IA Essential, IA Premium o Ultra, a seconda dell’app), la Pianificazione delle esecuzioni e l’Orario di funzionamento dove l’app li prevede, e i suoi interruttori delle funzioni. La scheda Registri mostra ogni decisione. In Odoo, Controllo rapido sulla riga dell’app comprende Accensione del bot, Pianificazione delle esecuzioni, Modalità demo e Modalità IA. Per sapere cosa automatizzare per primo, veda la guida generale: Come automatizzare Odoo dall’inizio alla fine.

📚 Guide correlate

• Cominci da qui: Come automatizzare Odoo dall’inizio alla fine: dall’ordine via e-mail alla fattura pagata
• Hosting: Odoo Online, Odoo.sh o on-premise a confronto: quale si può automatizzare?
• Primi bot da collegare: Importare in Odoo gli ordini ricevuti via e-mail · Abbinare automaticamente i pagamenti bancari alle fatture
• Per gli integratori: Guadagnare ricavi ricorrenti come partner Odoo

🔗 Fonti e approfondimenti

Documentazione ufficiale e standard citati in questa guida. I link esterni si aprono in una nuova scheda.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions