Як підключити Odoo до BOTS4.me: посібник зі встановлення конектора (Odoo 13–19)

🧭 Спершу оберіть шлях: де працює ваша Odoo?

Існує два способи встановлення, і вибір між ними визначається лише типом хостингу вашого Odoo. Обидва приводять до одного результату: одне підключення обслуговує всі застосунки BOTS4.me, що працюють з Odoo.

Не впевнені, який у вас хостинг, — чи ще обираєте? Див. Odoo Online vs Odoo.sh vs on-premise: що з цього можна автоматизувати?

Примітка про тариф: для доступу до API в Odoo Online потрібен тариф Odoo Custom; Odoo.sh і локальне встановлення працюють на будь-якому тарифі.

🔌 Шлях A: Odoo.sh & On-Premise — конектор в один клік

• Крок 1 — Створіть обліковий запис BOTS4.me. Зареєструйтеся на bots4.me/bots або пропустіть цей крок і створіть обліковий запис усередині Odoo на кроці 3. Кожен застосунок із безкоштовним стартом потім починається з безкоштовного місяця Discovery.
• Крок 2 — Установіть «BOTS4.me Connect». На apps.odoo.com відкрийте BOTS4.me Connect, оберіть свою версію Odoo (від 13.0 до 19.0) і завантажте безкоштовний zip-архів; він містить одну папку, b4m_connect. Власний сервер: помістіть цю папку в каталог із вашого addons path, перезапустіть службу Odoo, увімкніть режим розробника, відкрийте Apps → Update Apps List, знайдіть «BOTS4.me Connect» і натисніть Activate (Install у старіших версіях). Odoo.sh: закомітьте папку у свій репозиторій (спочатку спробуйте staging-гілку) і виконайте push; коли збірка стане зеленою, установіть модуль з Apps у базі даних цієї збірки. Модулі для окремих застосунків у магазині (наприклад, «Mail2ERP by BOTS4.me») встановлюються так само й показують лише свій застосунок. Вихідний код поширюється за ліцензією LGPL-3, тож ви або ваш інтегратор можете прочитати кожен рядок до встановлення.
• Крок 3 — Запустіть майстер підключення. Як адміністратор Odoo відкрийте BOTS4.me Connect → Налаштування і натисніть Підключити. Оберіть «Створити новий обліковий запис на www.bots4.me» (введіть свою електронну адресу; якщо нас порекомендував партнер BOTS4.me, укажіть його код у полі «Партнерський код») або «У мене вже є обліковий запис на www.bots4.me» (електронна адреса й пароль). Потім введіть 6-значний код із листа або із застосунку-автентифікатора, якщо ви ним користуєтеся. Майстер звертається безпосередньо до bots4.me через HTTPS; облікові дані не вводяться на жодному сторонньому екрані.
• Крок 4 — Ключі створюються за вас. Після успішного входу BOTS4.me видає API-ключ і секрет підпису HMAC для цієї конкретної бази даних Odoo, а модуль створює локального технічного користувача «BOTS4.me Connect», щоб боти читали й записували дані Odoo через XML-RPC під власним обліковим записом, а не під вашим особистим логіном адміністратора. Цей користувач отримує лише права Odoo тих застосунків, які ви активуєте. Як і будь-який внутрішній користувач, він враховується в підписці Odoo Enterprise з оплатою за користувача. В Odoo 18 і новіших Odoo обмежує строк дії API-ключів: коли модуль показує «Термін дії ключа API невдовзі спливає», натисніть Відключити, потім Підключити — налаштування застосунків не втрачаються.
• Крок 5 — Форми налаштування заповнюються заздалегідь. Конектор передає метадані вашого Odoo (URL, UUID бази даних, платіжні реквізити компанії, адреси поштових серверів IMAP), щоб заздалегідь заповнити форми налаштування BOTS4.me. Поштові паролі залишаються всередині вашого Odoo, доки ви не передасте поштову скриньку застосунку — кнопкою + Моя пошта IMAP (1 клік) або натиснувши Почати безкоштовний місяць Discovery у застосунку, що читає пошту. Вони шифруються до того, як залишать ваш Odoo.
• Крок 6 — Активуйте перший застосунок. У розділі Застосунки кожен застосунок показує свій статус («Не активовано», «Потребує налаштування», «Активно», «Налаштовано»). Один раз натисніть Спочатку заповніть платіжні дані, заповніть платіжні реквізити на bots4.me, потім натисніть Почати безкоштовний місяць Discovery у потрібному застосунку. Цей єдиний клік активує застосунок, підключає це Odoo як його ERP і — для застосунків, що читають пошту, — передає вашу поштову скриньку IMAP з Odoo. Для всього, що ще не підключено, застосунок має власну кнопку: + Це Odoo як ERP (1 клік), + Моя пошта IMAP (1 клік), + Поштова скринька (Gmail, Microsoft 365) або + Хмарне сховище. Панель керування, Журнали і Налаштування відкривають bots4.me з уже виконаним входом.

☁️ Шлях B: Odoo Online — налаштування без коду за допомогою ключа API

Odoo Online (редакція SaaS на odoo.com) не допускає власних модулів на Python — це правило платформи, а не обмеження BOTS4.me. Тому шлях для Online використовує XML-помічник без коду разом зі стандартним ключем API Odoo, який ви створюєте самі (зовнішній доступ до API входить у тариф Custom від Odoo):

• Крок 1 — створіть обліковий запис BOTS4.me на bots4.me/bots.
• Крок 2 — Створіть API-ключ Odoo. У своїй базі даних Odoo Online перейдіть у Settings → Users & Companies → Users → ваш користувач → Account Security (увімкніть режим розробника, якщо вкладку приховано) і натисніть New API Key. Назвіть його «BOTS4.me», оберіть строк дії (Odoo 18 і новіші про це запитують) і скопіюйте ключ — Odoo показує його лише один раз. До завершення строку дії створіть новий ключ і вставте його в те саме підключення Odoo на bots4.me («Редагувати» → «Оновити обліковий запис ERP»).
• Крок 3 — Запустіть застосунок і вставте ключ на bots4.me. Увійдіть на bots4.me/bots, натисніть Почати безкоштовний місяць Discovery на картці застосунку й один раз прийміть Умови — банківська картка не потрібна. Потім відкрийте Налаштування (шестірня) → застосунок → Access Manager, натисніть Додати призначення або Додати джерело (застосунок показує потрібний варіант), оберіть ERP → Odoo і заповніть URL Odoo (для https://yourcompany.odoo.com Database Name заповнюється автоматично), електронну адресу для входу в полі Ім’я користувача і API-ключ у полі Пароль або API Key. Натисніть Додати обліковий запис ERP.
• Крок 4 — Додайте помічник без коду (необов’язково). Модуль «BOTS4.me for Odoo Online» на apps.odoo.com містить лише записи даних, без Python, тож Odoo Online його приймає. Він додає у ваш Odoo застосунок BOTS4.me з пунктами Підключення / Панель керування, Посібник із налаштування та Як створити ключ API. Боти в будь-якому разі підключаються через стандартний зовнішній API Odoo.
• Крок 5 — Перевірте в режимі DEMO. На вкладці Керування застосунку ввімкніть живлення бота й залиште режим DEMO. Після першого запуску ви отримаєте лист зі звітом DEMO, де перелічено, що бот прочитав і що він записав би, а вкладка Журнали показує кожне рішення; в Odoo нічого не змінюється. Коли звіти DEMO виглядають правильно, встановіть Режим на LIVE на вкладці «Керування» — ця опція стає доступною після першого листа зі звітом DEMO.

🧭 Спробуйте в безкоштовний місяць Discovery

Перший місяць кожного застосунку з безкоштовним стартом — безкоштовний місяць Discovery: обсяг використання тарифу Personal і багато функцій Family та Business, відкритих для спроби, без банківської картки. Ось найкоротший шлях від «підключено» до першого результату в Odoo.

• 1 — Запустіть застосунок. В Odoo (Odoo.sh, власний сервер): BOTS4.me Connect → Налаштування, один раз натисніть Спочатку заповніть платіжні дані, потім Почати безкоштовний місяць Discovery у рядку застосунку. В Odoo Online: увійдіть на bots4.me/bots, натисніть Почати безкоштовний місяць Discovery на картці застосунку й один раз прийміть Умови — банківська картка не потрібна. У будь-якому разі панель потім показує «Безкоштовний місяць Discovery — залишилося днів: N».
• 2 — Підключіть те, що потрібно застосунку. В Odoo запуск застосунку вже підключає це Odoo та, якщо у вашому Odoo є поштовий сервер IMAP, його поштову скриньку. Для всього, що ще не підключено, використайте + Це Odoo як ERP (1 клік) або + Поштова скринька (Gmail, Microsoft 365). В Odoo Online додайте підключення Odoo в Access Manager, як описано в шляху B, а поштову скриньку — кнопкою Додати джерело.
• 3 — Запустіть у режимі DEMO. Відкрийте вкладку Керування застосунку (або Швидке керування в Odoo), увімкніть живлення бота й залиште режим DEMO. Перемикачі з позначкою Discovery на вкладці «Керування» входять у ваш безкоштовний місяць і спочатку вимкнені — увімкніть ті, які хочете спробувати.
• 4 — Перевірте результат. Прочитайте лист зі звітом DEMO після першого запуску та вкладку Журнали: кожен документ, прочитаний ботом, і що він створив би або змінив би в Odoo.
• 5 — Переходьте в LIVE. Коли звіти DEMO виглядають правильно, встановіть Режим на LIVE на вкладці «Керування» — ця опція стає доступною після першого листа зі звітом DEMO. Тепер бот записує дані в Odoo через налаштоване вами підключення з правами свого користувача Odoo.
• 6 — Після завершення місяця. Коли місяць закінчується, застосунок сам продовжує роботу на безкоштовному тарифі з невеликим місячним обсягом: коли його вичерпано, нові завдання чекають наступного місяця або доки ви не оберете тариф, а вже розпочате завдання завжди доводиться до кінця. Оберіть тариф, щоб зберегти всі функції, — див. таблицю тарифів на сторінці продукту застосунку.

🔒 Модель безпеки, пояснена чесно

Ви надаєте зовнішньому сервісу доступ до своєї ERP, тож маєте право вимагати конкретики — а не просто значка «безпека банківського рівня». Ось як саме побудований BOTS4.me Connect:

• Лише HTTPS, жорстко заданий адрес. Кінцеву точку API зафіксовано на https://bots4.me у вихідному коді модуля — це не редаговане поле налаштувань, тож скомпрометований запис конфігурації не зможе перенаправити ваш трафік API на ворожий сервер. Кожен URL, який повертає API, перевіряється, перш ніж його відкриє ваш браузер; відповіді без HTTPS або з чужого хоста відхиляються.
• Підпис запитів HMAC-SHA256. Кожен виклик, який модуль робить до BOTS4.me, підписується секретом, унікальним для бази даних, тож запити неможливо підробити чи змінити під час передавання.
• Облікові дані доступні лише адміністраторам. Поля ключа API, секрету підпису та технічного користувача мають доступ на рівні полів, обмежений групою адміністраторів Odoo (base.group_system). Звичайні внутрішні користувачі бачать лаунчпад і статуси застосунків, але секрети не з’являються в жодному читанні записів, яке вони можуть виконати, — а всі дії з підключення, відключення та налаштування доступні лише адміністраторам.
• Відкритий вихідний код, LGPL-3. Повний вихідний код входить у zip-архів, який ви завантажуєте з apps.odoo.com, тож ваш інтегратор може точно перевірити, що залишає ваш сервер: метадані для попереднього заповнення форм, пароль поштової скриньки — лише коли ви передаєте цю скриньку застосунку (шифрується до надсилання), і ніколи — ваші ділові документи.
• Журнал дій з обох боків. Модуль веде всередині Odoo локальний журнал подій — підключень, змін конфігурації та помилок; панель керування BOTS4.me зберігає повні журнали рішень за кожним запуском.
• Автоматичне оновлення прав. Планове завдання регулярно перевіряє ваші підписки, тож статуси застосунків у лаунчпаді залишаються актуальними, а скасований застосунок оперативно перестає обслуговуватися.

Докладніше про безпеку платформи та поетапне розширення доступу: bots4.me/security і рівні доступу. Платформа розміщена в ЄС, створена з урахуванням GDPR, а 2FA доступна для кожного облікового запису.

✅ Після підключення: одне підключення для всіх застосунків Odoo

Конектор встановлюється рівно один раз; для окремих застосунків нічого додатково встановлювати не потрібно. Одне підключення обслуговує всі застосунки BOTS4.me, що працюють з Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP і AutoCASH, а також AutoSTOCK, AutoPURCHASE і ClientFACTORY. AutoSPAM, Mail2CLOUD і Mail2KNOW потрібна лише поштова скринька, яку конектор може передати з вашого Odoo одним кліком. Кожен застосунок запускається окремо — з його рядка в Odoo або з його картки на bots4.me/bots.

Кожен застосунок запускається в режимі DEMO: він читає, ухвалює рішення й надсилає вам поштою звіт DEMO, але нічого не записує. Коли звіти DEMO виглядають правильно, встановіть Режим на LIVE на вкладці «Керування» — ця опція стає доступною після першого листа зі звітом DEMO. На bots4.me вкладка Керування кожного застосунку містить живлення бота, режим, режим ШІ («Вимк.», «Базовий ШІ», «Преміум ШІ» або Ultra, залежно від застосунку), розклад запуску та робочі години там, де вони є в застосунку, а також перемикачі функцій. Вкладка Журнали показує кожне рішення. В Odoo Швидке керування в рядку застосунку охоплює живлення бота, розклад запуску, демо-режим і режим ШІ. Про те, що автоматизувати насамперед, читайте в оглядовому посібнику: Як повністю автоматизувати Odoo.

📚 Пов’язані посібники

• Почніть звідси: Як автоматизувати Odoo від і до: від замовлення поштою до оплаченого рахунка
• Хостинг: Odoo Online vs Odoo.sh vs on-premise: що з цього можна автоматизувати?
• Перші боти для підключення: Імпорт замовлень із листів в Odoo · Автоматичне зіставлення банківських платежів з рахунками
• Для інтеграторів: Отримуйте регулярний дохід як партнер Odoo

🔗 Джерела та додаткові матеріали

Офіційна документація та стандарти, на які посилається цей посібник. Зовнішні посилання відкриваються в новій вкладці.

• 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