Hoe u Odoo verbindt met BOTS4.me: installatiehandleiding voor de connector (Odoo 13–19)

🧭 Kies eerst uw pad: waar draait uw Odoo?

Er zijn twee installatiepaden, en het enige wat daartussen beslist, is het hostingtype van uw Odoo. Beide eindigen op dezelfde plek: één koppeling bedient elke BOTS4.me-app die met Odoo werkt.

Weet u niet zeker welk hosting u heeft — of bent u nog aan het kiezen? Zie Odoo Online vs Odoo.sh vs on-premise: wat kunt u automatiseren?

Opmerking over het abonnement: Odoo Online heeft het Custom-abonnement van Odoo nodig voor API-toegang; Odoo.sh en on-premise werken met elk abonnement.

🔌 Pad A: Odoo.sh & On-Premise — de connector met één klik

• Stap 1 — Maak uw BOTS4.me-account aan. Registreer u op bots4.me/bots, of sla deze stap over en maak het account in Odoo aan in Stap 3. Elke app die gratis start, begint daarna met een gratis Discovery-maand.
• Stap 2 — Installeer „BOTS4.me Connect”. Open op apps.odoo.com BOTS4.me Connect, kies uw Odoo-versie (13.0 tot 19.0) en download de gratis zip; die bevat één map, b4m_connect. On-premise: zet die map in een directory op uw addons-pad, herstart de Odoo-service, schakel de ontwikkelaarsmodus in, open Apps → Lijst met apps bijwerken, zoek naar „BOTS4.me Connect” en klik op Activeren (Installeren in oudere versies). Odoo.sh: commit de map naar uw repository (probeer eerst een staging-branch) en push; wanneer de build groen is, installeert u hem via Apps in de database van die build. De single-app-modules in de store (bijvoorbeeld „Mail2ERP by BOTS4.me”) installeert u op dezelfde manier en ze tonen alleen hun eigen app. De broncode is LGPL-3, dus u of uw integrator kan elke regel lezen voordat u installeert.
• Stap 3 — Doorloop de koppelwizard. Open als Odoo-beheerder BOTS4.me Connect → Instellingen en klik op Verbinden. Kies „Maak een nieuw account aan op www.bots4.me” (voer uw e-mailadres in; als een BOTS4.me-partner ons heeft aanbevolen, vul dan diens code in bij Partnercode) of „Ik heb al een account op www.bots4.me” (e-mailadres en wachtwoord). Voer daarna de 6-cijferige code in uit uw e-mail, of uit uw authenticator-app als u die gebruikt. De wizard communiceert rechtstreeks met bots4.me via HTTPS; er worden geen inloggegevens in een scherm van derden getypt.
• Stap 4 — Sleutels worden voor u aangemaakt. Na een geslaagde aanmelding geeft BOTS4.me een API-sleutel en een HMAC-ondertekeningsgeheim uit voor deze specifieke Odoo-database, en maakt de module een lokale technische gebruiker aan, „BOTS4.me Connect”, zodat de bots Odoo-records via XML-RPC lezen en schrijven met hun eigen identiteit, nooit met uw persoonlijke beheerderslogin. Die gebruiker krijgt alleen de Odoo-rechten van de apps die u activeert. Zoals elke interne gebruiker telt hij mee voor een Odoo Enterprise-abonnement per gebruiker. Vanaf Odoo 18 beperkt Odoo hoe lang API-sleutels geldig blijven: wanneer de module „API-sleutel verloopt binnenkort” toont, klikt u op Verbinding verbreken en daarna op Verbinden, en gaan er geen app-instellingen verloren.
• Stap 5 — Installatieformulieren zijn vooraf ingevuld. De connector stuurt de metadata van uw Odoo (URL, database-UUID, factuurgegevens van het bedrijf, adressen van IMAP-mailservers) om de installatieformulieren van BOTS4.me vooraf in te vullen. Mailwachtwoorden blijven in uw Odoo totdat u een mailbox aan een app overdraagt, met + Mijn IMAP-mail (1 klik) of door bij een app die e-mail leest op Gratis Discovery-maand starten te klikken. Ze worden versleuteld voordat ze uw Odoo verlaten.
• Stap 6 — Activeer uw eerste app. Onder Apps toont elke app zijn status (Niet geactiveerd, Instelling vereist, Actief, Geconfigureerd). Klik één keer op Voltooi eerst de facturatie, vul uw factuurgegevens in op bots4.me en klik daarna bij de gewenste app op Gratis Discovery-maand starten. Die ene klik activeert de app, koppelt deze Odoo als ERP en draagt, bij apps die e-mail lezen, de IMAP-mailbox van uw Odoo over. Wat nog ontbreekt, krijgt een eigen knop bij de app: + Deze Odoo als ERP (1 klik), + Mijn IMAP-mail (1 klik), + Postvak (Gmail, Microsoft 365) of + Cloudopslag. Dashboard, Logboeken en Instellingen openen bots4.me met u al ingelogd.

☁️ Pad B: Odoo Online — no-code installatie met een API-sleutel

Odoo Online (de SaaS-editie op odoo.com) staat geen eigen Python-modules toe — dat is een platformregel, geen beperking van BOTS4.me. Het Online-pad gebruikt daarom een standaard Odoo-API-sleutel die u zelf aanmaakt (externe API-toegang maakt deel uit van het Custom-abonnement van Odoo), plus een no-code XML-helpermodule:

• Stap 1 — Maak uw BOTS4.me-account aan op bots4.me/bots.
• Stap 2 — Maak een Odoo-API-sleutel aan. Ga in uw Odoo Online-database naar Instellingen → Gebruikers & bedrijven → Gebruikers → uw gebruiker → Accountbeveiliging (schakel de ontwikkelaarsmodus in als het tabblad verborgen is) en klik op Nieuwe API-sleutel. Noem hem „BOTS4.me”, kies hoe lang hij geldig blijft (Odoo 18 en later vragen dat) en kopieer de sleutel; Odoo toont hem maar één keer. Maak vóór het verlopen een nieuwe aan en plak die in dezelfde Odoo-koppeling op bots4.me (Bewerken → ERP-account bijwerken).
• Stap 3 — Start de app en plak de sleutel op bots4.me. Log in op bots4.me/bots, klik op de kaart van de app op Gratis Discovery-maand starten en accepteer eenmalig de Voorwaarden — geen creditcard nodig. Open daarna Instellingen (tandwiel) → de app → Access Manager, klik op Bestemming toevoegen of Bron toevoegen (de app toont wat hij nodig heeft), kies ERP → Odoo en vul de Odoo URL in (voor https://uwbedrijf.odoo.com vult de databasenaam zich vanzelf in), uw login-e-mailadres als Gebruikersnaam en de API-sleutel bij Wachtwoord of API Key. Klik op ERP-account toevoegen.
• Stap 4 — Voeg de helper zonder code toe (optioneel). De module „BOTS4.me for Odoo Online” op apps.odoo.com bevat alleen gegevensrecords, geen Python, dus Odoo Online accepteert hem. Hij voegt een BOTS4.me-app toe aan uw Odoo met Connect / Dashboard, Installatiehandleiding en Een API-sleutel aanmaken. De bots koppelen hoe dan ook via de standaard externe API van Odoo.
• Stap 5 — Controleer in DEMO. Zet op het tabblad Besturing van de app Bot-werking aan en laat de Modus op DEMO staan. Na de eerste run krijgt u een DEMO-rapportmail met wat de bot heeft gelezen en wat hij zou hebben geschreven, en het tabblad Logboeken toont elke beslissing; er verandert niets in Odoo. Zien de DEMO-rapporten er goed uit, zet dan op het tabblad Besturing de Modus op LIVE — dat wordt beschikbaar na de eerste DEMO-rapportmail.

🧭 Probeer het in uw gratis Discovery-maand

De eerste maand van elke app die gratis start, is een gratis Discovery-maand: het gebruikstegoed van het Personal-abonnement, met veel Family- en Business-functies ontgrendeld om uit te proberen, en geen creditcard nodig. Dit is de kortste route van „gekoppeld” naar een eerste resultaat in Odoo.

• 1 — Start de app. In Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Instellingen, klik één keer op Voltooi eerst de facturatie en daarna bij de app op Gratis Discovery-maand starten. Op Odoo Online: log in op bots4.me/bots, klik op de kaart van de app op Gratis Discovery-maand starten en accepteer eenmalig de Voorwaarden — geen creditcard nodig. In beide gevallen toont het Dashboard daarna „Gratis Discovery-maand — nog N dagen”.
• 2 — Koppel wat de app nodig heeft. In Odoo koppelt het starten van de app al deze Odoo en, als uw Odoo een IMAP-mailserver heeft, de mailbox ervan. Gebruik + Deze Odoo als ERP (1 klik) of + Postvak (Gmail, Microsoft 365) voor wat nog ontbreekt. Voeg op Odoo Online de Odoo-koppeling toe in de Access Manager zoals beschreven in Pad B, en de mailbox met Bron toevoegen.
• 3 — Draai hem in DEMO. Open het tabblad Besturing van de app (of Snelle bediening in Odoo), zet Bot-werking aan en laat de Modus op DEMO staan. Schakelaars met een Discovery-label op het tabblad Besturing zijn inbegrepen in uw gratis maand en staan in het begin uit — zet de schakelaars aan die u wilt uitproberen.
• 4 — Controleer het resultaat. Lees na de eerste run de DEMO-rapportmail en het tabblad Logboeken: elk document dat de bot heeft gelezen, en wat hij in Odoo zou hebben aangemaakt of gewijzigd.
• 5 — Ga LIVE. Zien de DEMO-rapporten er goed uit, zet dan op het tabblad Besturing de Modus op LIVE — dat wordt beschikbaar na de eerste DEMO-rapportmail. De bot schrijft nu naar Odoo via de koppeling die u hebt ingericht, met de rechten van zijn Odoo-gebruiker.
• 6 — Na de maand. Wanneer de maand afloopt, gaat de app vanzelf verder op het gratis abonnement met een klein maandelijks tegoed: als dat op is, wachten nieuwe items tot de volgende maand of tot u een abonnement kiest, en een item dat al is gestart, wordt altijd afgerond. Kies een abonnement om alle functies te behouden — zie de abonnementstabel op de productpagina van de app.

🔒 Het beveiligingsmodel, eerlijk uitgelegd

U geeft een externe dienst toegang tot uw ERP, dus u zou concrete details moeten eisen — niet alleen een badge met “bank-grade security”. Zo is BOTS4.me Connect precies gebouwd:

• Alleen HTTPS, hard-coded. Het API-endpoint staat vast op https://bots4.me in de broncode van de module — het is geen bewerkbaar instellingenveld, zodat een gecompromitteerd configuratierecord uw API-verkeer niet naar een vijandige server kan omleiden. Elke URL die door de API wordt teruggegeven, wordt gecontroleerd voordat uw browser deze opent; reacties zonder HTTPS of van een andere host worden geweigerd.
• Ondertekening van verzoeken met HMAC-SHA256. Elke aanroep die de module naar BOTS4.me doet, wordt ondertekend met het per-database-geheim, zodat verzoeken tijdens de overdracht niet vervalst of gemanipuleerd kunnen worden.
• Inloggegevens beperkt tot beheerders. De velden voor API-sleutel, ondertekeningsgeheim en technische gebruiker hebben toegang op veldniveau die beperkt is tot de beheerdersgroep van Odoo (base.group_system). Gewone interne gebruikers kunnen het launchpad en de app-statussen zien, maar de geheimen verschijnen nooit in een recordweergave die zij kunnen uitvoeren — en alle acties om te verbinden/ontkoppelen/configureren zijn uitsluitend voor beheerders.
• Open source, LGPL-3. De volledige broncode zit in de zip die u van apps.odoo.com downloadt, zodat uw integrator precies kan controleren wat uw server verlaat: metadata om formulieren vooraf in te vullen, een mailboxwachtwoord alleen wanneer u die mailbox aan een app overdraagt (versleuteld voordat het vertrekt), en nooit uw zakelijke documenten.
• Audit trail aan beide kanten. De module houdt in Odoo een lokaal gebeurtenislogboek bij van verbindingen, configuratiewijzigingen en fouten; het BOTS4.me-dashboard houdt volledige beslissingslogboeken per run bij.
• Automatische vernieuwing van rechten. Een geplande cronjob controleert uw abonnementen regelmatig opnieuw, zodat de app-statussen in het launchpad actueel blijven — en een opgezegde app wordt direct niet meer bediend.

Meer over platformbeveiliging en gefaseerde toegang: bots4.me/security en toegangsniveaus. Het platform wordt in de EU gehost, is ontworpen voor de AVG, en 2FA is beschikbaar op elk account.

✅ Na het koppelen: één koppeling voor elke Odoo-app

U installeert de connector precies één keer; er hoeft per app niets extra te worden geïnstalleerd. Eén koppeling bedient elke BOTS4.me-app die met Odoo werkt: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP en AutoCASH, plus AutoSTOCK, AutoPURCHASE en ClientFACTORY. AutoSPAM, Mail2CLOUD en Mail2KNOW hebben alleen een mailbox nodig, die de connector met één klik vanuit uw Odoo kan doorgeven. U start elke app afzonderlijk, vanuit de rij in Odoo of de kaart op bots4.me/bots.

Elke app start in DEMO: hij leest, beslist en mailt u een DEMO-rapport, maar schrijft niets. Zien de DEMO-rapporten er goed uit, zet dan op het tabblad Besturing de Modus op LIVE — dat wordt beschikbaar na de eerste DEMO-rapportmail. Op bots4.me bevat het tabblad Besturing van elke app Bot-werking, de Modus, de AI-modus (Uit, Essentiële AI, Premium AI of Ultra, afhankelijk van de app), het Uitvoeringsschema en de Bedrijfsuren waar de app die heeft, en de schakelaars voor de functies. Het tabblad Logboeken toont elke beslissing. In Odoo dekt Snelle bediening in de rij van de app Bot-werking, Uitvoeringsschema, Demomodus en AI-modus. Wat u het eerst automatiseert, leest u in de overzichtshandleiding: Hoe u Odoo end-to-end automatiseert.

📚 Gerelateerde handleidingen

• Begin hier: Odoo end-to-end automatiseren: van e-mailbestelling tot betaalde factuur
• Hosting: Odoo Online vs Odoo.sh vs on-premise: wat kunt u automatiseren?
• Eerste bots om te verbinden: E-mailbestellingen in Odoo importeren · Bankbetalingen automatisch aan facturen koppelen
• Voor integratoren: Terugkerende inkomsten verdienen als Odoo-partner

🔗 Bronnen en verder lezen

Officiële documentatie en standaarden waarnaar in deze handleiding wordt verwezen. Externe links openen in een nieuw tabblad.

• 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