Jak připojit Odoo k BOTS4.me: příručka instalace konektoru (Odoo 13–19)

🧭 Nejprve si vyberte cestu: kde běží Vaše Odoo?

Existují dvě cesty instalace a jediné, co mezi nimi rozhoduje, je typ hostingu Vašeho Odoo. Obě končí na stejném místě: jedno připojení slouží všem aplikacím BOTS4.me, které pracují s Odoo.

Nejste si jistí, jaký hosting máte — nebo se ještě rozhodujete? Podívejte se na Odoo Online vs Odoo.sh vs on-premise: co můžete automatizovat?

Poznámka k plánu: Odoo Online vyžaduje pro přístup k API plán Custom od Odoo; Odoo.sh a on-premise fungují s jakýmkoli plánem.

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

• Krok 1 — Vytvořte si účet BOTS4.me. Zaregistrujte se na bots4.me/bots nebo tento krok přeskočte a účet si vytvořte přímo v Odoo v kroku 3. Každá aplikace se startem zdarma pak začíná bezplatným měsícem Discovery.
• Krok 2 — Nainstalujte “BOTS4.me Connect”. Na apps.odoo.com otevřete BOTS4.me Connect, vyberte svou verzi Odoo (13.0 až 19.0) a stáhněte si bezplatný zip; obsahuje jednu složku, b4m_connect. On-premise: vložte tuto složku do adresáře na Vaší cestě addons, restartujte službu Odoo, zapněte režim vývojáře, otevřete Apps → Update Apps List, vyhledejte “BOTS4.me Connect” a klikněte na Activate (ve starších verzích Install). Odoo.sh: commitněte složku do svého repozitáře (nejprve vyzkoušejte staging větev) a pushněte; když je build zelený, nainstalujte ho z Apps v databázi daného buildu. Moduly pro jednu aplikaci v obchodě (například “Mail2ERP by BOTS4.me”) se instalují stejně a zobrazují pouze svou aplikaci. Zdrojový kód je pod licencí LGPL-3, takže Vy nebo Váš integrátor si můžete před instalací přečíst každý řádek.
• Krok 3 — Spusťte průvodce připojením. Jako administrátor Odoo otevřete BOTS4.me Connect → Nastavení a klikněte na Připojit. Zvolte “Vytvořit nový účet na www.bots4.me” (zadejte svůj e-mail; pokud nás doporučil partner BOTS4.me, zadejte jeho kód do pole Kód partnera) nebo “Již mám účet na www.bots4.me” (e-mail a heslo). Poté zadejte 6místný kód z e-mailu nebo z autentizační aplikace, pokud ji používáte. Průvodce komunikuje přímo s bots4.me přes HTTPS; žádné přihlašovací údaje se nezadávají do obrazovky třetí strany.
• Krok 4 — Klíče se vygenerují za Vás. Po úspěšném přihlášení BOTS4.me vydá pro tuto konkrétní databázi Odoo API klíč a podpisový tajný klíč HMAC a modul vytvoří lokálního technického uživatele “BOTS4.me Connect”, takže boti čtou a zapisují záznamy Odoo přes XML-RPC pod vlastní identitou, nikdy ne pod Vaším osobním administrátorským přihlášením. Tento uživatel dostane pouze práva Odoo pro aplikace, které aktivujete. Jako každý interní uživatel se započítává do předplatného Odoo Enterprise účtovaného podle uživatelů. V Odoo 18 a novějších Odoo omezuje, jak dlouho zůstávají API klíče platné: když modul zobrazí “Platnost API klíče brzy vyprší”, klikněte na Odpojit, poté na Připojit a žádná nastavení aplikací se neztratí.
• Krok 5 — Formuláře nastavení jsou předvyplněné. Konektor posílá metadata Vašeho Odoo (URL, UUID databáze, fakturační údaje firmy, adresy poštovních serverů IMAP), aby předvyplnil formuláře nastavení BOTS4.me. Hesla k poště zůstávají ve Vašem Odoo, dokud schránku nepředáte aplikaci, buď přes + Moje pošta IMAP (1 klik), nebo kliknutím na Spustit bezplatný měsíc Discovery u aplikace, která čte e-maily. Před opuštěním Vašeho Odoo jsou zašifrovaná.
• Krok 6 — Aktivujte svou první aplikaci. V části Aplikace každá aplikace zobrazuje svůj stav (Neaktivováno, Vyžaduje nastavení, Aktivní, Nakonfigurováno). Jednou klikněte na Nejprve dokončete fakturaci, vyplňte fakturační údaje na bots4.me a poté u požadované aplikace klikněte na Spustit bezplatný měsíc Discovery. Toto jediné kliknutí aplikaci aktivuje, připojí toto Odoo jako její ERP a aplikacím, které čtou e-maily, předá schránku IMAP Vašeho Odoo. Vše, co ještě chybí, má u aplikace vlastní tlačítko: + Toto Odoo jako ERP (1 klik), + Moje pošta IMAP (1 klik), + Schránka (Gmail, Microsoft 365) nebo + Cloudové úložiště. Dashboard, Protokoly a Nastavení otevřou bots4.me již přihlášené.

☁️ Cesta B: Odoo Online — nastavení bez kódu pomocí API klíče

Odoo Online (edice SaaS na odoo.com) neumožňuje vlastní moduly v Pythonu — je to pravidlo platformy, nikoli omezení BOTS4.me. Cesta pro Online proto používá modul pomocníka v XML bez kódu a k tomu standardní API klíč Odoo, který si sami vytvoříte (externí přístup k API je součástí plánu Custom od Odoo):

• Krok 1 — Vytvořte si účet BOTS4.me na bots4.me/bots.
• Krok 2 — Vytvořte API klíč Odoo. Ve Vaší databázi Odoo Online přejděte do Settings → Users & Companies → Users → Váš uživatel → Account Security (pokud je karta skrytá, zapněte režim vývojáře) a klikněte na New API Key. Pojmenujte ho “BOTS4.me”, zvolte, jak dlouho zůstane platný (Odoo 18 a novější se ptají), a zkopírujte klíč; Odoo ho zobrazí pouze jednou. Před vypršením platnosti vytvořte nový a vložte ho do stejného připojení Odoo na bots4.me (Upravit → Aktualizovat ERP účet).
• Krok 3 — Spusťte aplikaci a vložte klíč na bots4.me. Přihlaste se na bots4.me/bots, na kartě aplikace klikněte na Začít bezplatný měsíc Discovery a jednou přijměte Podmínky — bez platební karty. Poté otevřete Nastavení (ozubené kolečko) → aplikace → Access Manager, klikněte na Přidat cílové umístění nebo Přidat zdroj (aplikace zobrazí to, které potřebuje), zvolte ERP → Odoo a vyplňte Odoo URL (pro https://yourcompany.odoo.com se Název databáze vyplní sám), svůj přihlašovací e-mail jako Uživatelské jméno a API klíč do pole Heslo nebo API klíč. Klikněte na Přidat ERP účet.
• Krok 4 — Přidejte pomocníka bez kódu (volitelné). Modul “BOTS4.me for Odoo Online” na apps.odoo.com obsahuje pouze datové záznamy, žádný Python, takže ho Odoo Online přijme. Přidá do Vašeho Odoo aplikaci BOTS4.me s položkami Připojení / Dashboard, Návod k nastavení a Jak vytvořit API klíč. Boti se v každém případě připojují přes standardní externí API Odoo.
• Krok 5 — Ověřte v režimu DEMO. Na kartě Ovládání aplikace zapněte Napájení bota a Režim nechte na DEMO. Po prvním běhu dostanete e-mail s DEMO reportem, který uvádí, co bot přečetl a co by zapsal, a karta Záznamy ukazuje každé rozhodnutí; v Odoo se nic nezmění. Když DEMO reporty vypadají správně, nastavte na kartě Ovládání Režim na LIVE — odemkne se po prvním e-mailu s DEMO reportem.

🧭 Vyzkoušejte to v bezplatném měsíci Discovery

První měsíc každé aplikace se startem zdarma je bezplatný měsíc Discovery: objem využití plánu Personal s mnoha funkcemi plánů Family a Business odemčenými k vyzkoušení, bez platební karty. Toto je nejkratší cesta od “připojeno” k prvnímu výsledku v Odoo.

• 1 — Spusťte aplikaci. V Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Nastavení, jednou klikněte na Nejprve dokončete fakturaci a poté u aplikace na Spustit bezplatný měsíc Discovery. V Odoo Online: přihlaste se na bots4.me/bots, na kartě aplikace klikněte na Začít bezplatný měsíc Discovery a jednou přijměte Podmínky — bez platební karty. V obou případech pak dashboard zobrazí “Bezplatný měsíc Discovery — zbývá dní: N”.
• 2 — Připojte, co aplikace potřebuje. V Odoo už spuštění aplikace připojí toto Odoo a pokud má Vaše Odoo poštovní server IMAP, i jeho schránku. Na vše, co ještě chybí, použijte + Toto Odoo jako ERP (1 klik) nebo + Schránka (Gmail, Microsoft 365). V Odoo Online přidejte připojení Odoo v Access Manageru, jak je popsáno v cestě B, a schránku přes Přidat zdroj.
• 3 — Spusťte ji v režimu DEMO. Otevřete kartu Ovládání aplikace (nebo Rychlé ovládání v Odoo), zapněte Napájení bota a Režim nechte na DEMO. Přepínače se štítkem Discovery na kartě Ovládání jsou součástí bezplatného měsíce a na začátku jsou vypnuté — zapněte ty, které chcete vyzkoušet.
• 4 — Zkontrolujte výsledek. Po prvním běhu si přečtěte e-mail s DEMO reportem a kartu Záznamy: každý dokument, který bot přečetl, a co by v Odoo vytvořil nebo změnil.
• 5 — Přejděte na LIVE. Když DEMO reporty vypadají správně, nastavte na kartě Ovládání Režim na LIVE — odemkne se po prvním e-mailu s DEMO reportem. Bot nyní zapisuje do Odoo přes připojení, které jste nastavili, s právy svého uživatele Odoo.
• 6 — Po skončení měsíce. Když měsíc skončí, aplikace sama pokračuje v bezplatném plánu s malým měsíčním objemem: když se vyčerpá, nové položky čekají do dalšího měsíce nebo dokud si nevyberete plán, a položka, jejíž zpracování již začalo, se vždy dokončí. Chcete-li zachovat všechny funkce, vyberte si plán — podívejte se na tabulku plánů na produktové stránce aplikace.

🔒 Bezpečnostní model, poctivě vysvětlený

Externí službě dáváte přístup ke svému ERP, takže byste měli vyžadovat konkrétní detaily — nejen odznak “zabezpečení na bankovní úrovni”. Přesně takto je BOTS4.me Connect postaven:

• Pouze HTTPS, napevno zakódováno. Koncový bod API je ve zdrojovém kódu modulu napevno nastaven na https://bots4.me — není to upravitelné pole nastavení, takže napadený konfigurační záznam nemůže přesměrovat Vaši API komunikaci na nepřátelský server. Každá URL vrácená z API se před otevřením ve Vašem prohlížeči ověří; odpovědi mimo HTTPS nebo mimo hostitele se odmítnou.
• Podepisování požadavků pomocí HMAC-SHA256. Každé volání, které modul odešle do BOTS4.me, je podepsáno tajným klíčem pro danou databázi, takže požadavky nelze během přenosu zfalšovat ani změnit.
• Přihlašovací údaje vyhrazené pro administrátory. Pole API klíče, podpisového tajného klíče a technického uživatele mají přístup na úrovni polí omezený na administrátorskou skupinu Odoo (base.group_system). Běžní interní uživatelé vidí launchpad a stavy aplikací, ale tajné klíče se nikdy neobjeví v žádném čtení záznamů, které by mohli spustit — a všechny akce připojení/odpojení/konfigurace jsou pouze pro administrátory.
• Otevřený zdrojový kód, LGPL-3. Celý zdrojový kód je součástí zipu, který si stáhnete z apps.odoo.com, takže Váš integrátor může přesně ověřit, co opouští Váš server: metadata k předvyplnění formulářů, heslo ke schránce pouze tehdy, když danou schránku předáte aplikaci (zašifrované před odesláním), a nikdy ne Vaše obchodní dokumenty.
• Auditní záznam na obou stranách. Modul si v Odoo vede lokální protokol událostí o připojeních, změnách konfigurace a chybách; dashboard BOTS4.me vede kompletní protokoly rozhodnutí pro každý běh.
• Automatické obnovení oprávnění. Naplánovaný cron pravidelně znovu kontroluje Vaše předplatné, takže stavy aplikací v launchpadu zůstávají aktuální — a zrušená aplikace se přestane obsluhovat neprodleně.

Více o zabezpečení platformy a odstupňovaném přístupu: bots4.me/security a úrovně přístupu. Platforma je hostována v EU, navržena s ohledem na GDPR a 2FA je k dispozici u každého účtu.

✅ Po připojení: jedno připojení pro všechny aplikace pro Odoo

Konektor instalujete jen jednou; pro jednotlivé aplikace se nic dalšího neinstaluje. Jedno připojení slouží všem aplikacím BOTS4.me, které pracují s Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP a AutoCASH, plus AutoSTOCK, AutoPURCHASE a ClientFACTORY. AutoSPAM, Mail2CLOUD a Mail2KNOW potřebují jen schránku, kterou jim konektor může z Vašeho Odoo předat jedním kliknutím. Každou aplikaci spouštíte zvlášť, z jejího řádku v Odoo nebo z její karty na bots4.me/bots.

Každá aplikace začíná v režimu DEMO: čte, rozhoduje a pošle Vám e-mailem DEMO report, ale nic nezapíše. Když DEMO reporty vypadají správně, nastavte na kartě Ovládání Režim na LIVE — odemkne se po prvním e-mailu s DEMO reportem. Na bots4.me obsahuje karta Ovládání každé aplikace Napájení bota, Režim, Režim AI (Vypnuto, Essential AI, Premium AI nebo Ultra, podle aplikace), Plán spouštění a Provozní hodiny, pokud je aplikace má, a přepínače jejích funkcí. Karta Záznamy ukazuje každé rozhodnutí. V Odoo pokrývá Rychlé ovládání v řádku aplikace Napájení bota, Plán spouštění, Demo režim a Režim AI. Co automatizovat jako první, najdete v hlavním návodu: Jak automatizovat Odoo od začátku do konce.

📚 Související průvodci

• Začněte zde: Jak automatizovat Odoo od začátku do konce: od e-mailové objednávky po uhrazenou fakturu
• Hosting: Odoo Online vs Odoo.sh vs on-premise: co můžete automatizovat?
• První boti k připojení: Importujte e-mailové objednávky do Odoo · Automaticky spárujte bankovní platby s fakturami
• Pro integrátory: Získejte opakovaný příjem jako partner Odoo

🔗 Zdroje a další čtení

Oficiální dokumentace a standardy, na které tento průvodce odkazuje. Externí odkazy se otevírají v nové záložce.

• 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