Ako pripojiť Odoo k BOTS4.me: Príručka inštalácie konektora (Odoo 13–19)

🧭 Najprv si vyberte cestu: kde beží vaše Odoo?

Existujú dve cesty inštalácie a jediné, čo medzi nimi rozhoduje, je typ hostingu vášho Odoo. Obe končia na rovnakom mieste: jedno pripojenie slúži všetkým aplikáciám BOTS4.me, ktoré pracujú s Odoo.

Nie ste si istí, aký hosting máte — alebo sa ešte rozhodujete? Pozrite si Odoo Online vs Odoo.sh vs on-premise: čo môžete automatizovať?

Poznámka k plánu: Odoo Online vyžaduje na prístup k API plán Custom od Odoo; Odoo.sh a on-premise fungujú s akýmkoľvek plánom.

🔌 Cesta A: Odoo.sh & On-Premise — konektor na jedno kliknutie

• Krok 1 — Vytvorte si účet BOTS4.me. Zaregistrujte sa na bots4.me/bots alebo tento krok preskočte a účet si vytvorte priamo v Odoo v kroku 3. Každá aplikácia so štartom zadarmo potom začína bezplatným mesiacom Discovery.
• Krok 2 — Nainštalujte “BOTS4.me Connect”. Na apps.odoo.com otvorte BOTS4.me Connect, vyberte svoju verziu Odoo (13.0 až 19.0) a stiahnite si bezplatný zip; obsahuje jeden priečinok, b4m_connect. On-premise: vložte tento priečinok do adresára na vašej ceste addons, reštartujte službu Odoo, zapnite režim vývojára, otvorte Apps → Update Apps List, vyhľadajte “BOTS4.me Connect” a kliknite na Activate (v starších verziách Install). Odoo.sh: commitnite priečinok do svojho repozitára (najprv vyskúšajte staging vetvu) a pushnite; keď je build zelený, nainštalujte ho z Apps v databáze daného buildu. Moduly pre jednu aplikáciu v obchode (napríklad “Mail2ERP by BOTS4.me”) sa inštalujú rovnako a zobrazujú iba svoju aplikáciu. Zdrojový kód je pod licenciou LGPL-3, takže vy alebo váš integrátor si môžete pred inštaláciou prečítať každý riadok.
• Krok 3 — Spustite sprievodcu pripojením. Ako administrátor Odoo otvorte BOTS4.me Connect → Nastavenia a kliknite na Pripojiť. Zvoľte “Vytvoriť nový účet na www.bots4.me” (zadajte svoj e-mail; ak nás odporučil partner BOTS4.me, zadajte jeho kód do poľa Partnerský kód) alebo “Už mám účet na www.bots4.me” (e-mail a heslo). Potom zadajte 6-miestny kód z e-mailu alebo z autentifikačnej aplikácie, ak ju používate. Sprievodca komunikuje priamo s bots4.me cez HTTPS; žiadne prihlasovacie údaje sa nezadávajú do obrazovky tretej strany.
• Krok 4 — Kľúče sa vygenerujú za vás. Po úspešnom prihlásení BOTS4.me vydá pre túto konkrétnu databázu Odoo API kľúč a podpisový tajný kľúč HMAC a modul vytvorí lokálneho technického používateľa “BOTS4.me Connect”, takže boty čítajú a zapisujú záznamy Odoo cez XML-RPC pod vlastnou identitou, nikdy nie pod vaším osobným administrátorským prihlásením. Tento používateľ dostane iba práva Odoo pre aplikácie, ktoré aktivujete. Ako každý interný používateľ sa započítava do predplatného Odoo Enterprise účtovaného podľa používateľov. V Odoo 18 a novších Odoo obmedzuje, ako dlho zostávajú API kľúče platné: keď modul zobrazí “Platnosť API kľúča čoskoro vyprší”, kliknite na Odpojiť, potom na Pripojiť a žiadne nastavenia aplikácií sa nestratia.
• Krok 5 — Formuláre nastavenia sú predvyplnené. Konektor posiela metadáta vášho Odoo (URL, UUID databázy, fakturačné údaje firmy, adresy IMAP poštových serverov), aby predvyplnil formuláre nastavenia BOTS4.me. Heslá k pošte zostávajú vo vašom Odoo, kým schránku neodovzdáte aplikácii, buď cez + Moja IMAP schránka (1 klik), alebo kliknutím na Začať bezplatný mesiac Discovery pri aplikácii, ktorá číta e-maily. Pred opustením vášho Odoo sú zašifrované.
• Krok 6 — Aktivujte svoju prvú aplikáciu. V časti Aplikácie každá aplikácia zobrazuje svoj stav (Neaktivované, Vyžaduje nastavenie, Aktívny, Nastavené). Raz kliknite na Najprv dokončite fakturáciu, vyplňte fakturačné údaje na bots4.me a potom pri požadovanej aplikácii kliknite na Začať bezplatný mesiac Discovery. Toto jediné kliknutie aplikáciu aktivuje, pripojí toto Odoo ako jej ERP a aplikáciám, ktoré čítajú e-maily, odovzdá IMAP schránku vášho Odoo. Všetko, čo ešte chýba, má pri aplikácii vlastné tlačidlo: + Toto Odoo ako ERP (1 klik), + Moja IMAP schránka (1 klik), + Schránka (Gmail, Microsoft 365) alebo + Cloudové úložisko. Panel, Denníky a Nastavenia otvoria bots4.me už prihlásené.

☁️ Cesta B: Odoo Online — nastavenie bez kódu pomocou API kľúča

Odoo Online (edícia SaaS na odoo.com) neumožňuje vlastné moduly v Pythone — je to pravidlo platformy, nie obmedzenie BOTS4.me. Cesta pre Online preto používa modul pomocníka v XML bez kódu a k tomu štandardný API kľúč Odoo, ktorý si sami vytvoríte (prístup k externému API je súčasťou plánu Custom v Odoo):

• Krok 1 — Vytvorte si účet BOTS4.me na bots4.me/bots.
• Krok 2 — Vytvorte API kľúč Odoo. Vo vašej databáze Odoo Online prejdite do Settings → Users & Companies → Users → váš používateľ → Account Security (ak je karta skrytá, zapnite režim vývojára) a kliknite na New API Key. Pomenujte ho “BOTS4.me”, zvoľte, ako dlho zostane platný (Odoo 18 a novšie sa pýtajú), a skopírujte kľúč; Odoo ho zobrazí iba raz. Pred vypršaním platnosti vytvorte nový a vložte ho do toho istého pripojenia Odoo na bots4.me (Upraviť → Aktualizovať ERP účet).
• Krok 3 — Spustite aplikáciu a vložte kľúč na bots4.me. Prihláste sa na bots4.me/bots, na karte aplikácie kliknite na Začať bezplatný mesiac Discovery a raz prijmite Podmienky — bez platobnej karty. Potom otvorte Nastavenia (ozubené koliesko) → aplikácia → Access Manager, kliknite na Pridať cieľové umiestnenie alebo Pridať zdroj (aplikácia zobrazí to, ktoré potrebuje), zvoľte ERP → Odoo a vyplňte Odoo URL (pre https://yourcompany.odoo.com sa Názov databázy vyplní sám), svoj prihlasovací e-mail ako Používateľské meno a API kľúč do poľa Heslo alebo API kľúč. Kliknite na Pridať ERP účet.
• Krok 4 — Pridajte pomocníka bez kódu (voliteľné). Modul “BOTS4.me for Odoo Online” na apps.odoo.com obsahuje iba dátové záznamy, žiadny Python, takže ho Odoo Online prijme. Pridá do vášho Odoo aplikáciu BOTS4.me s položkami Pripojenie / Panel, Sprievodca nastavením a Ako vytvoriť API kľúč. Boty sa v každom prípade pripájajú cez štandardné externé API Odoo.
• Krok 5 — Overte v režime DEMO. Na karte Ovládanie aplikácie zapnite Napájanie bota a Režim nechajte na DEMO. Po prvom behu dostanete e-mail s DEMO reportom, ktorý uvádza, čo bot prečítal a čo by zapísal, a karta Záznamy ukazuje každé rozhodnutie; v Odoo sa nič nezmení. Keď DEMO reporty vyzerajú správne, nastavte na karte Ovládanie Režim na LIVE — odomkne sa po prvom e-maile s DEMO reportom.

🧭 Vyskúšajte to v bezplatnom mesiaci Discovery

Prvý mesiac každej aplikácie so štartom zadarmo je bezplatný mesiac Discovery: objem využitia plánu Personal s mnohými funkciami plánov Family a Business odomknutými na vyskúšanie, bez platobnej karty. Toto je najkratšia cesta od “pripojené” k prvému výsledku v Odoo.

• 1 — Spustite aplikáciu. V Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Nastavenia, raz kliknite na Najprv dokončite fakturáciu a potom pri aplikácii na Začať bezplatný mesiac Discovery. V Odoo Online: prihláste sa na bots4.me/bots, na karte aplikácie kliknite na Začať bezplatný mesiac Discovery a raz prijmite Podmienky — bez platobnej karty. V oboch prípadoch potom dashboard zobrazí “Bezplatný mesiac Discovery — zostáva dní: N”.
• 2 — Pripojte, čo aplikácia potrebuje. V Odoo už spustenie aplikácie pripojí toto Odoo a ak má vaše Odoo IMAP poštový server, aj jeho schránku. Na všetko, čo ešte chýba, použite + Toto Odoo ako ERP (1 klik) alebo + Schránka (Gmail, Microsoft 365). V Odoo Online pridajte pripojenie Odoo v Access Manager, ako je popísané v ceste B, a schránku cez Pridať zdroj.
• 3 — Spustite ju v režime DEMO. Otvorte kartu Ovládanie aplikácie (alebo Rýchle ovládanie v Odoo), zapnite Napájanie bota a Režim nechajte na DEMO. Prepínače so štítkom Discovery na karte Ovládanie sú súčasťou bezplatného mesiaca a na začiatku sú vypnuté — zapnite tie, ktoré chcete vyskúšať.
• 4 — Skontrolujte výsledok. Po prvom behu si prečítajte e-mail s DEMO reportom a kartu Záznamy: každý dokument, ktorý bot prečítal, a čo by v Odoo vytvoril alebo zmenil.
• 5 — Prejdite na LIVE. Keď DEMO reporty vyzerajú správne, nastavte na karte Ovládanie Režim na LIVE — odomkne sa po prvom e-maile s DEMO reportom. Bot teraz zapisuje do Odoo cez pripojenie, ktoré ste nastavili, s právami svojho používateľa Odoo.
• 6 — Po skončení mesiaca. Keď mesiac skončí, aplikácia sama pokračuje v bezplatnom pláne s malým mesačným objemom: keď sa vyčerpá, nové položky čakajú do ďalšieho mesiaca alebo kým si nevyberiete plán, a položka, ktorej spracovanie už začalo, sa vždy dokončí. Ak chcete zachovať všetky funkcie, vyberte si plán — pozrite si tabuľku plánov na produktovej stránke aplikácie.

🔒 Bezpečnostný model, poctivo vysvetlený

Externej službe dávate prístup k svojmu ERP, takže by ste mali vyžadovať konkrétne detaily — nielen odznak “zabezpečenie na bankovej úrovni”. Presne takto je BOTS4.me Connect postavený:

• Iba HTTPS, pevne zakódované. Koncový bod API je v zdrojovom kóde modulu pevne nastavený na https://bots4.me — nie je to upraviteľné pole nastavení, takže napadnutý konfiguračný záznam nemôže presmerovať vašu API prevádzku na nepriateľský server. Každá URL vrátená z API sa pred otvorením vo vašom prehliadači overí; odpovede mimo HTTPS alebo mimo hostiteľa sa odmietnu.
• Podpisovanie požiadaviek pomocou HMAC-SHA256. Každé volanie, ktoré modul posiela do BOTS4.me, je podpísané tajným kľúčom pre danú databázu, takže požiadavky nemožno počas prenosu sfalšovať ani zmeniť.
• Prihlasovacie údaje vyhradené pre administrátorov. Polia API kľúča, podpisového tajného kľúča a technického používateľa majú prístup na úrovni polí obmedzený na administrátorskú skupinu Odoo (base.group_system). Bežní interní používatelia vidia launchpad a stavy aplikácií, ale tajné kľúče sa nikdy neobjavia v žiadnom čítaní záznamov, ktoré by mohli spustiť — a všetky akcie pripojenia/odpojenia/konfigurácie sú len pre administrátorov.
• Otvorený zdrojový kód, LGPL-3. Celý zdrojový kód je súčasťou zipu, ktorý si stiahnete z apps.odoo.com, takže váš integrátor môže presne overiť, čo opúšťa váš server: metadáta na predvyplnenie formulárov, heslo k schránke iba vtedy, keď danú schránku odovzdáte aplikácii (zašifrované pred odoslaním), a nikdy nie vaše obchodné dokumenty.
• Audítny záznam na oboch stranách. Modul si v Odoo vedie lokálny protokol udalostí o pripojeniach, zmenách konfigurácie a chybách; dashboard BOTS4.me vedie kompletné protokoly rozhodnutí pre každý beh.
• Automatické obnovenie oprávnení. Naplánovaný cron pravidelne znovu kontroluje vaše predplatné, takže stavy aplikácií v launchpade zostávajú aktuálne — a zrušená aplikácia sa prestane obsluhovať bezodkladne.

Viac o zabezpečení platformy a stupňovanom prístupe: bots4.me/security a úrovne prístupu. Platforma je hostovaná v EÚ, navrhnutá s ohľadom na GDPR a 2FA je dostupné na každom účte.

✅ Po pripojení: jedno pripojenie pre všetky aplikácie pre Odoo

Konektor inštalujete iba raz; pre jednotlivé aplikácie sa nič ďalšie neinštaluje. Jedno pripojenie slúži všetkým aplikáciám BOTS4.me, ktoré pracujú s Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP a AutoCASH, plus AutoSTOCK, AutoPURCHASE a ClientFACTORY. AutoSPAM, Mail2CLOUD a Mail2KNOW potrebujú iba schránku, ktorú im konektor môže z vášho Odoo odovzdať jedným kliknutím. Každú aplikáciu spúšťate samostatne, z jej riadku v Odoo alebo z jej karty na bots4.me/bots.

Každá aplikácia začína v režime DEMO: číta, rozhoduje a pošle vám e-mailom DEMO report, ale nič nezapíše. Keď DEMO reporty vyzerajú správne, nastavte na karte Ovládanie Režim na LIVE — odomkne sa po prvom e-maile s DEMO reportom. Na bots4.me obsahuje karta Ovládanie každej aplikácie Napájanie bota, Režim, Režim AI (Vypnuté, Essential AI, Premium AI alebo Ultra, podľa aplikácie), Plán spúšťania a Prevádzkové hodiny, ak ich aplikácia má, a prepínače jej funkcií. Karta Záznamy ukazuje každé rozhodnutie. V Odoo pokrýva Rýchle ovládanie v riadku aplikácie Napájanie bota, Plán spúšťania, Demo režim a Režim AI. Čo automatizovať ako prvé, nájdete v hlavnom návode: Ako automatizovať Odoo od začiatku do konca.

📚 Súvisiace príručky

• Začnite tu: Ako automatizovať Odoo od začiatku do konca: od e-mailovej objednávky po uhradenú faktúru
• Hosting: Odoo Online vs Odoo.sh vs on-premise: čo môžete automatizovať?
• Prví boti na pripojenie: Importujte e-mailové objednávky do Odoo · Automaticky spárujte bankové platby s faktúrami
• Pre integrátorov: Získajte opakovaný príjem ako partner Odoo

🔗 Zdroje a ďalšie čítanie

Oficiálna dokumentácia a štandardy, na ktoré sa tento návod odvoláva. Externé odkazy sa otvárajú na novej karte.

• 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