Jak połączyć Odoo z BOTS4.me: przewodnik instalacji konektora (Odoo 13–19)

🧭 Najpierw wybierz ścieżkę: gdzie działa Państwa Odoo?

Istnieją dwie ścieżki instalacji, a wybór między nimi zależy wyłącznie od rodzaju hostingu Odoo. Obie prowadzą do tego samego miejsca: jedno połączenie obsługuje każdą aplikację BOTS4.me, która współpracuje z Odoo.

Nie są Państwo pewni, jaki mają hosting — albo wciąż wybierają? Proszę zobaczyć Odoo Online vs Odoo.sh vs on-premise: co można zautomatyzować?

Uwaga dotycząca planu: Odoo Online wymaga planu Custom od Odoo do dostępu do API; Odoo.sh i instalacje on-premise działają w każdym planie.

🔌 Ścieżka A: Odoo.sh & On-Premise — konektor jednym kliknięciem

• Krok 1 — Proszę założyć konto BOTS4.me. Proszę zarejestrować się na bots4.me/bots albo pominąć ten krok i założyć konto w Odoo w Kroku 3. Każda aplikacja z bezpłatnym startem zaczyna się wtedy od bezpłatnego miesiąca Discovery.
• Krok 2 — Proszę zainstalować „BOTS4.me Connect”. Na apps.odoo.com proszę otworzyć BOTS4.me Connect, wybrać swoją wersję Odoo (od 13.0 do 19.0) i pobrać bezpłatny plik zip; zawiera on jeden folder, b4m_connect. On-premise: proszę umieścić ten folder w katalogu ze ścieżki addons, zrestartować usługę Odoo, włączyć tryb deweloperski, otworzyć Aplikacje → Aktualizuj listę aplikacji, wyszukać „BOTS4.me Connect” i kliknąć Aktywuj (Instaluj w starszych wersjach). Odoo.sh: proszę dodać folder do repozytorium (najpierw na gałęzi staging) i wykonać push; gdy build jest zielony, proszę zainstalować moduł z Aplikacji w bazie danych tego buildu. Moduły pojedynczych aplikacji w sklepie (na przykład „Mail2ERP by BOTS4.me”) instaluje się tak samo i pokazują tylko swoją aplikację. Kod źródłowy jest na licencji LGPL-3, więc Państwo lub Państwa integrator mogą przeczytać każdą linię przed instalacją.
• Krok 3 — Proszę uruchomić kreator połączenia. Jako administrator Odoo proszę otworzyć BOTS4.me Connect → Ustawienia i kliknąć Połącz. Proszę wybrać „Załóż nowe konto na www.bots4.me” (wpisać e-mail; jeśli polecił nas partner BOTS4.me, proszę wpisać jego kod w polu Kod partnera) lub „Mam już konto na www.bots4.me” (e-mail i hasło). Następnie proszę wpisać 6-cyfrowy kod z e-maila lub z aplikacji uwierzytelniającej, jeśli Państwo z niej korzystają. Kreator komunikuje się bezpośrednio z bots4.me przez HTTPS; żadne dane logowania nie są wpisywane na ekranie podmiotu trzeciego.
• Krok 4 — Klucze są generowane za Państwa. Po pomyślnym zalogowaniu BOTS4.me wystawia klucz API i sekret podpisu HMAC dla tej konkretnej bazy danych Odoo, a moduł tworzy lokalnego użytkownika technicznego „BOTS4.me Connect”, dzięki czemu boty odczytują i zapisują rekordy Odoo przez XML-RPC pod własną tożsamością, nigdy z Państwa osobistego loginu administratora. Ten użytkownik otrzymuje tylko uprawnienia Odoo aplikacji, które Państwo aktywują. Jak każdy użytkownik wewnętrzny liczy się do subskrypcji Odoo Enterprise rozliczanej za użytkownika. W Odoo 18 i nowszych Odoo ogranicza czas ważności kluczy API: gdy moduł pokaże „API key expires soon”, proszę kliknąć Rozłącz, a potem Połącz — żadne ustawienia aplikacji nie zostaną utracone.
• Krok 5 — Formularze konfiguracji są wstępnie wypełnione. Konektor wysyła metadane Państwa Odoo (URL, UUID bazy danych, dane rozliczeniowe firmy, adresy serwerów poczty IMAP), aby wstępnie wypełnić formularze konfiguracji BOTS4.me. Hasła do poczty pozostają w Państwa Odoo, dopóki nie przekażą Państwo skrzynki aplikacji — przyciskiem + Moja poczta IMAP (1 kliknięcie) albo klikając Rozpocznij bezpłatny miesiąc Discovery przy aplikacji, która czyta e-maile. Przed opuszczeniem Odoo są szyfrowane.
• Krok 6 — Proszę aktywować pierwszą aplikację. W sekcji Aplikacje każda aplikacja pokazuje swój status (Nie aktywowano, Wymaga konfiguracji, Aktywny, Skonfigurowany). Proszę raz kliknąć Najpierw uzupełnij dane rozliczeniowe, wypełnić dane rozliczeniowe na bots4.me, a następnie kliknąć Rozpocznij bezpłatny miesiąc Discovery przy wybranej aplikacji. To jedno kliknięcie aktywuje aplikację, podłącza to Odoo jako jej ERP, a w przypadku aplikacji czytających e-maile przekazuje skrzynkę IMAP z Odoo. Wszystko, czego jeszcze brakuje, ma własny przycisk przy aplikacji: + To Odoo jako ERP (1 kliknięcie), + Moja poczta IMAP (1 kliknięcie), + Skrzynka pocztowa (Gmail, Microsoft 365) lub + Magazyn w chmurze. Panel, Dzienniki i Ustawienia otwierają bots4.me z automatycznym zalogowaniem.

☁️ Ścieżka B: Odoo Online — konfiguracja bez kodu z kluczem API

Odoo Online (edycja SaaS na odoo.com) nie zezwala na własne moduły w Pythonie — to reguła platformy, nie ograniczenie BOTS4.me. Dlatego ścieżka Online korzysta ze standardowego klucza API Odoo, który tworzą Państwo samodzielnie, oraz opcjonalnie z modułu pomocnika w XML bez kodu (dostęp do zewnętrznego API jest częścią planu Custom Odoo):

• Krok 1 — Utwórz konto BOTS4.me na bots4.me/bots.
• Krok 2 — Proszę utworzyć klucz API Odoo. W bazie danych Odoo Online proszę przejść do Ustawienia → Użytkownicy i firmy → Użytkownicy → Państwa użytkownik → Bezpieczeństwo konta (jeśli zakładka jest ukryta, proszę włączyć tryb deweloperski) i kliknąć Nowy klucz API. Proszę nadać mu nazwę „BOTS4.me”, wybrać okres ważności (Odoo 18 i nowsze o to pytają) i skopiować klucz; Odoo pokazuje go tylko raz. Przed jego wygaśnięciem proszę utworzyć nowy i wkleić go do tego samego połączenia Odoo na bots4.me (Edytuj → Zaktualizuj konto ERP).
• Krok 3 — Proszę uruchomić aplikację i wkleić klucz na bots4.me. Proszę zalogować się na bots4.me/bots, kliknąć Rozpocznij bezpłatny miesiąc Discovery na karcie aplikacji i jednorazowo zaakceptować Regulamin — karta kredytowa nie jest potrzebna. Następnie proszę otworzyć Ustawienia (koło zębate) → aplikacja → Access Manager, kliknąć Dodaj miejsce docelowe lub Dodaj źródło (aplikacja pokazuje ten, którego potrzebuje), wybrać ERP → Odoo i wypełnić Odoo URL (dla https://yourcompany.odoo.com Nazwa bazy danych uzupełnia się sama), e-mail logowania jako Nazwa użytkownika i klucz API w polu Hasło lub API Key. Proszę kliknąć Dodaj konto ERP.
• Krok 4 — Opcjonalny pomocnik bez kodowania. Moduł „BOTS4.me for Odoo Online” na apps.odoo.com zawiera wyłącznie rekordy danych, bez kodu Python, więc Odoo Online go akceptuje. Dodaje do Odoo aplikację BOTS4.me z pozycjami Połącz / Panel, Przewodnik konfiguracji i Jak utworzyć klucz API. Boty i tak łączą się przez standardowe zewnętrzne API Odoo.
• Krok 5 — Weryfikacja w trybie DEMO. W zakładce Sterowanie aplikacji proszę włączyć Zasilanie bota i pozostawić Tryb na DEMO. Po pierwszym uruchomieniu otrzymują Państwo e-mail z raportem DEMO, wymieniający, co bot przeczytał i co by zapisał, a zakładka Logi pokazuje każdą decyzję; w Odoo nic się nie zmienia. Gdy raporty DEMO wyglądają dobrze, proszę ustawić Tryb na LIVE w zakładce Sterowanie — opcja odblokowuje się po pierwszym e-mailu z raportem DEMO.

🧭 Proszę wypróbować w bezpłatnym miesiącu Discovery

Pierwszy miesiąc każdej aplikacji z bezpłatnym startem to bezpłatny miesiąc Discovery: limit użycia planu Personal z wieloma funkcjami Family i Business odblokowanymi do wypróbowania, bez karty kredytowej. Oto najkrótsza droga od „połączono” do pierwszego wyniku w Odoo.

• 1 — Uruchomienie aplikacji. W Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Ustawienia, raz kliknąć Najpierw uzupełnij dane rozliczeniowe, a następnie Rozpocznij bezpłatny miesiąc Discovery przy aplikacji. W Odoo Online: proszę zalogować się na bots4.me/bots, kliknąć Rozpocznij bezpłatny miesiąc Discovery na karcie aplikacji i jednorazowo zaakceptować Regulamin — karta kredytowa nie jest potrzebna. W obu przypadkach panel pokazuje następnie „Bezpłatny miesiąc Discovery — pozostało dni: N”.
• 2 — Podłączenie tego, czego potrzebuje aplikacja. W Odoo uruchomienie aplikacji od razu podłącza to Odoo oraz, jeśli Odoo ma serwer poczty IMAP, jego skrzynkę. Dla wszystkiego, czego jeszcze brakuje, proszę użyć + To Odoo jako ERP (1 kliknięcie) lub + Skrzynka pocztowa (Gmail, Microsoft 365). W Odoo Online proszę dodać połączenie Odoo w Access Manager zgodnie z opisem w Ścieżce B, a skrzynkę przyciskiem Dodaj źródło.
• 3 — Uruchomienie w trybie DEMO. Proszę otworzyć zakładkę Sterowanie aplikacji (lub Szybkie sterowanie w Odoo), włączyć Zasilanie bota i pozostawić Tryb na DEMO. Przełączniki z oznaczeniem Discovery w zakładce Sterowanie są zawarte w bezpłatnym miesiącu i na starcie są wyłączone — proszę włączyć te, które chcą Państwo wypróbować.
• 4 — Sprawdzenie wyniku. Proszę przeczytać e-mail z raportem DEMO po pierwszym uruchomieniu oraz zakładkę Logi: każdy dokument przeczytany przez bota i to, co utworzyłby lub zmienił w Odoo.
• 5 — Przejście na LIVE. Gdy raporty DEMO wyglądają dobrze, proszę ustawić Tryb na LIVE w zakładce Sterowanie — opcja odblokowuje się po pierwszym e-mailu z raportem DEMO. Bot zapisuje teraz dane w Odoo przez skonfigurowane połączenie, z uprawnieniami swojego użytkownika Odoo.
• 6 — Po miesiącu. Gdy miesiąc się kończy, aplikacja sama przechodzi na plan bezpłatny z małym miesięcznym limitem: gdy się wyczerpie, nowe pozycje czekają do następnego miesiąca albo do wyboru planu, a rozpoczęta już pozycja jest zawsze kończona. Aby zachować wszystkie funkcje, proszę wybrać plan — tabela planów znajduje się na stronie produktu aplikacji.

🔒 Model bezpieczeństwa, uczciwie wyjaśniony

Dają Państwo zewnętrznej usłudze dostęp do swojego ERP, więc powinni Państwo wymagać konkretów — nie tylko odznaki “zabezpieczenia klasy bankowej”. Oto dokładnie, jak zbudowany jest BOTS4.me Connect:

• Tylko HTTPS, zakodowane na stałe. Punkt końcowy API jest w kodzie źródłowym modułu na stałe ustawiony na https://bots4.me — nie jest to edytowalne pole ustawień, więc naruszony rekord konfiguracji nie może przekierować ruchu API na wrogi serwer. Każdy adres URL zwrócony przez API jest weryfikowany, zanim przeglądarka go otworzy; odpowiedzi spoza HTTPS lub spoza hosta są odrzucane.
• Podpisywanie żądań za pomocą HMAC-SHA256. Każde wywołanie, które moduł kieruje do BOTS4.me, jest podpisane tajnym kluczem dla danej bazy danych, więc żądań nie można sfałszować ani zmienić podczas przesyłania.
• Dane uwierzytelniające dostępne tylko dla administratorów. Pola klucza API, tajnego klucza podpisującego i użytkownika technicznego mają dostęp na poziomie pól ograniczony do grupy administratorów Odoo (base.group_system). Zwykli użytkownicy wewnętrzni widzą launchpad i statusy aplikacji, ale tajne klucze nigdy nie pojawiają się w żadnym odczycie rekordów, który mogliby wykonać — a wszystkie działania połączenia/rozłączenia/konfiguracji są dostępne tylko dla administratorów.
• Otwarte źródło, LGPL-3. Pełny kod źródłowy znajduje się w pliku zip pobieranym z apps.odoo.com, więc Państwa integrator może dokładnie sprawdzić, co opuszcza serwer: metadane do wstępnego wypełnienia formularzy, hasło do skrzynki tylko wtedy, gdy przekażą Państwo tę skrzynkę aplikacji (szyfrowane przed wysłaniem), i nigdy Państwa dokumenty biznesowe.
• Ścieżka audytu po obu stronach. Moduł prowadzi w Odoo lokalny dziennik zdarzeń dotyczących połączeń, zmian konfiguracji i błędów; panel BOTS4.me prowadzi pełne dzienniki decyzji dla każdego uruchomienia.
• Automatyczne odświeżanie uprawnień. Zaplanowany cron regularnie ponownie sprawdza Państwa subskrypcje, dzięki czemu statusy aplikacji w launchpadzie pozostają aktualne — a anulowana aplikacja przestaje być obsługiwana bezzwłocznie.

Więcej o bezpieczeństwie platformy i stopniowanym dostępie: bots4.me/security oraz poziomy dostępu. Platforma jest hostowana w UE, zaprojektowana z myślą o RODO, a 2FA jest dostępne na każdym koncie.

✅ Po połączeniu: jedno połączenie dla każdej aplikacji Odoo

Konektor instaluje się dokładnie raz; dla poszczególnych aplikacji nie trzeba niczego dodatkowo instalować. Jedno połączenie obsługuje każdą aplikację BOTS4.me, która współpracuje z Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP i AutoCASH, a także AutoSTOCK, AutoPURCHASE i ClientFACTORY. AutoSPAM, Mail2CLOUD i Mail2KNOW potrzebują jedynie skrzynki pocztowej, którą konektor może przekazać z Państwa Odoo jednym kliknięciem. Każdą aplikację uruchamia się osobno, z jej wiersza w Odoo lub z jej karty na bots4.me/bots.

Każda aplikacja startuje w trybie DEMO: czyta, podejmuje decyzje i wysyła Państwu raport DEMO, ale niczego nie zapisuje. Gdy raporty DEMO wyglądają dobrze, proszę ustawić Tryb na LIVE w zakładce Sterowanie — opcja odblokowuje się po pierwszym e-mailu z raportem DEMO. Na bots4.me zakładka Sterowanie każdej aplikacji zawiera Zasilanie bota, Tryb, Tryb AI (Wyłączony, Essential AI, Premium AI lub Ultra, zależnie od aplikacji), Harmonogram uruchamiania i Godziny pracy tam, gdzie aplikacja je ma, oraz przełączniki funkcji. Zakładka Logi pokazuje każdą decyzję. W Odoo Szybkie sterowanie w wierszu aplikacji obejmuje Zasilanie bota, Harmonogram uruchamiania, Tryb demo i Tryb AI. Od czego zacząć automatyzację — patrz przewodnik główny: Jak w pełni zautomatyzować Odoo.

📚 Powiązane przewodniki

• Zacznij tutaj: Jak zautomatyzować Odoo od początku do końca: od zamówienia e-mail po opłaconą fakturę
• Hosting: Odoo Online vs Odoo.sh vs on-premise: co można zautomatyzować?
• Pierwsze boty do połączenia: Importuj zamówienia e-mail do Odoo · Automatycznie dopasuj płatności bankowe do faktur
• Dla integratorów: Zarabiaj cykliczny przychód jako partner Odoo

🔗 Źródła i dalsza lektura

Oficjalna dokumentacja i standardy, do których odwołuje się ten przewodnik. Linki zewnętrzne otwierają się w nowej karcie.

• 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