bots4.me

Odoo Connector Install Guide

Written by

in

How to Connect Odoo to BOTS4.me: Connector Install Guide (Odoo 13–19) | BOTS4.me
BOTS4.me Logo

How to Connect Odoo to BOTS4.me: Connector Install Guide (Odoo 13–19)

One free connector. All 11 automation apps. Works on Odoo Online, Odoo.sh, and on-premise.

Connecting Odoo to an external automation platform usually means custom endpoints, shared admin passwords, or a middleware server someone has to babysit. The BOTS4.me Connect module removes all of that: a free, open-source (LGPL-3) module from apps.odoo.com that links your Odoo — versions 13 through 19 — to the whole BOTS4.me suite in one guided flow. This guide walks through both install paths, step by step, and explains exactly how the security works.

🧭 First, Pick Your Path: Where Does Your Odoo Run?

There are two install paths, and the only thing that decides between them is your Odoo hosting type. Both end in the same place: one connector serving all eleven apps.

Path A — Odoo.sh or On-Premise

You can install custom modules, so you get the full one-click Python connector: guided 2FA login, automatic key provisioning, and a launchpad menu inside Odoo showing each app’s live status.

Path B — Odoo Online (SaaS)

Odoo Online forbids custom Python modules, so you use the zero-code XML helper plus an API key you create yourself in Odoo’s settings — about five minutes, no code at all.

Not sure which hosting you have — or still choosing? See Odoo Online vs Odoo.sh vs on-premise: which can you automate?

🔌 Path A: Odoo.sh & On-Premise — the One-Click Connector

📥

Install module
from apps.odoo.com

🔐

Log in with
2FA email code

🔑

Keys minted
automatically

🚀

Launchpad shows
all 11 apps

  • Step 1 — Create your BOTS4.me account. Register at bots4.me/bots if you haven’t already. Every app comes with the first month free.
  • Step 2 — Install “BOTS4.me Connect”. Find the free module on apps.odoo.com (or install it from your Odoo Apps menu). It ships one zip per Odoo major version, 13.0 through 19.0, from a single audited codebase. The source is LGPL-3 — you or your integrator can read every line before installing.
  • Step 3 — Run the connect wizard. Open the BOTS4.me menu in Odoo’s left sidebar and click Connect. Enter your BOTS4.me email and password; a 2FA code is emailed to you. No credentials are typed into any third-party screen — the wizard talks directly to bots4.me over HTTPS.
  • Step 4 — Keys are minted for you. On successful login, BOTS4.me mints an API key and an HMAC signing secret for this specific Odoo database and provisions a local technical user, so the BOTS4.me pipeline can read and write Odoo records over XML-RPC with a dedicated identity — never your personal admin login.
  • Step 5 — Setup forms are pre-filled. The connector sends your Odoo’s metadata — URL, database UUID, company billing block, IMAP mail-server addresses — to pre-fill the BOTS4.me setup forms. Mail passwords stay inside your Odoo unless you explicitly click “+ My IMAP mail”.
  • Step 6 — Use the launchpad. The left-menu launchpad shows every app’s status (Active / Configured / Quota) and deep-links straight into the matching page on bots4.me, already logged in as the bound user — no second sign-in.

☁️ Path B: Odoo Online — Zero-Code Setup with an API Key

Odoo Online (the SaaS edition at odoo.com) does not allow custom Python modules — that’s a platform rule, not a BOTS4.me limitation. So the Online path uses a zero-code XML helper module plus a standard Odoo API key that you create yourself:

  • Step 1 — Create your BOTS4.me account at bots4.me/bots.
  • Step 2 — Create an Odoo API key. In your Odoo Online database, go to Settings → Users → your user → Account Security and click New API Key. Give it a recognizable name like “BOTS4.me” and copy the key — Odoo shows it only once.
  • Step 3 — Paste it at bots4.me. In the BOTS4.me dashboard, open your app’s ERP Access settings, choose Odoo Online, and paste your database URL, database name, login email, and the API key.
  • Step 4 — Add the zero-code helper. The XML helper module (data records only, no Python) is available for Odoo Online to smooth field access — install it like any other module. Your connection works over Odoo’s standard XML-RPC API either way.
  • Step 5 — Verify in Demo Mode. Switch the bot on in Demo Mode and check its first report: it lists exactly what it read and what it would have written, without changing anything.

⚠️ Tip: use a dedicated Odoo user

For clean audit trails, create a dedicated Odoo user (e.g. “BOTS4.me Integration”) and mint the API key under that user. Every record the bots create or update is then clearly attributed in Odoo’s own logs.

🔒 The Security Model, Honestly Explained

You are giving an external service access to your ERP, so you should demand specifics — not just a “bank-grade security” badge. Here is exactly how BOTS4.me Connect is built:

  • HTTPS only, hard-coded. The API endpoint is fixed to https://bots4.me in the module source — it is not an editable settings field, so a compromised configuration record can’t redirect your API traffic to a hostile server. Every URL returned by the API is verified before your browser opens it; non-HTTPS or off-host responses are rejected.
  • HMAC-SHA256 request signing. Every API call between your Odoo and BOTS4.me is signed with the per-database secret, so requests can’t be forged or tampered with in transit.
  • Credentials restricted to admins. The API key, signing secret, and technical-user fields carry field-level access limited to Odoo’s admin group (base.group_system). Regular internal users can see the launchpad and app statuses, but the secrets never appear in any record read they could run — and all connect/disconnect/configure actions are admin-only.
  • Open source, LGPL-3. The module’s full source is published. Your integrator can audit exactly what leaves your server: metadata to pre-fill forms, never your mail passwords (unless you explicitly share an IMAP account), never your business documents.
  • Audit trail on both sides. The module keeps a local event log of connects, configuration changes, and errors inside Odoo; the BOTS4.me dashboard keeps full per-run decision logs.
  • 15-minute entitlement refresh. A scheduled cron re-checks your subscriptions every 15 minutes, so app statuses in the launchpad stay current — and a cancelled app stops being served promptly.

More on platform security and graduated access: bots4.me/security and access levels. The platform is EU-hosted, GDPR-native, with 2FA on every account.

✅ After Connecting: One Connector, All 11 Apps

You install the connector exactly once. From then on, every BOTS4.me app — Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP, AutoCASH, AutoSTOCK, AutoPURCHASE, AutoSPAM, Mail2CLOUD, Mail2KNOW, and ClientFACTORY — is simply toggled on or off from the dashboard at bots4.me/bots. Nothing extra to install per app.

Each app starts in Demo Mode — it reads, decides, and reports, but writes nothing — then graduates to read-only and finally full automation when you’re confident. Per-app Control, Logs, and Settings tabs give you Bot Power on/off, AI Mode (Off → Essential → Premium → Ultra), run schedules from every 15 minutes to weekly, operating hours, and individually toggleable features. For what to automate first, see the hub guide: How to automate Odoo end-to-end.

❓ Frequently Asked Questions

Is the BOTS4.me Connect module for Odoo really free?

Yes. The connector module on apps.odoo.com is free and open source under LGPL-3, for all supported Odoo versions 13 through 19. You pay only for the BOTS4.me app subscriptions you actually use — and every app’s first month is free.

Does the connector work with Odoo Online (the SaaS version)?

Yes, via the zero-code path. Odoo Online forbids custom Python modules platform-wide, so instead of the Python connector you create a standard API key under Settings → Users → Account Security in Odoo, paste it at bots4.me, and optionally add the data-only XML helper module. The automation capabilities are the same.

Which Odoo versions does BOTS4.me support?

Odoo 13.0 through 19.0, Community and Enterprise, on Odoo Online, Odoo.sh, and on-premise. The connector is built from a single source tree with per-version compatibility shims, so old and new databases get the same features.

Do I need to install a separate connector for each BOTS4.me app?

No. One connector serves all eleven apps. After the one-time install, you switch individual apps on and off from the BOTS4.me dashboard, and the launchpad menu inside Odoo shows each app’s live status with a deep-link that opens it without a second sign-in.

Can regular Odoo users see the API key or change the connection?

No. The API key, signing secret, and technical-user fields are protected with field-level access limited to the Odoo admin group, and all connect, disconnect, and configure actions are admin-only. Regular internal users can view app statuses and open dashboards, nothing more.

What data does the connector send to BOTS4.me?

During setup it sends metadata to pre-fill your forms: the Odoo URL, database UUID, company billing details, and IMAP mail-server addresses. Mail passwords stay inside your Odoo unless you explicitly choose to share an IMAP account. All traffic is HTTPS with HMAC-SHA256 signing, and the endpoint is hard-coded so it cannot be redirected.

Can I test the connection without letting bots write to Odoo?

Yes — that’s the default. Every app starts in Demo Mode: it reads data, makes its decisions, and emails you a report of what it would have done, writing nothing. You then graduate to read-only access and finally to full automation, feature by feature, on your own schedule.

📚 Related Guides

Connect Your Odoo in Minutes — First Month Free

Create your account, install the free connector, and run your first bot in Demo Mode today. Nothing is written to Odoo until you say so.