Как подключить 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» (введите свой e-mail; если нас порекомендовал партнёр BOTS4.me, укажите его код в поле «Партнёрский код») или «У меня уже есть учётная запись на www.bots4.me» (e-mail и пароль). Затем введите 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 заполняется автоматически), e-mail для входа в поле Имя пользователя и 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