eBot: Мобильное приложение для интернет-магазина

6. Описание установки и настройки решения

Требования перед установкой

Для работы модуля ebot.b24 («eBot: Мобильное приложение для 1С-Битрикс и Битрикс24») необходимо:

1С-Битрикс: Управление сайтом (редакция с поддержкой модулей) или коробочная версия Битрикс24 с доступом к файлам и админке

Установленные и активные модули: CRM, Интернет-магазин (sale), Информационные блоки (iblock), Торговый каталог (catalog)

Аккаунт на платформе ebot.biz с подключённой интеграцией Битрикс24

API-ключ интеграции, выданный в личном кабинете ebot.biz

Настроенный каталог товаров в 1С-Битрикс (инфоблок товаров, при необходимости — инфоблок торговых предложений)

Установка модуля через Marketplace / админку

В админке перейдите: Настройки → Настройки продукта → Модули (или Marketplace → Установленные решения).

Найдите модуль «eBot: Мобильное приложение для 1С-Битрикс и Битрикс24» (код: ebot.b24).

Нажмите Установить.

На шаге подтверждения нажмите Установить ещё раз — модуль скопирует служебные файлы и зарегистрирует обработчики событий.

После установки откроется экран успеха со ссылкой «Открыть настройки».

Где искать модуль после установки

Настройки модуля находятся в админке:

Контент → eBot: Мобильное приложение → eBot: Мобильное приложение

Прямой URL страницы настроек:

/bitrix/admin/ebot_integration.php

Первичная настройка (пошагово)

Шаг 1. Подключение к ebot.biz (вкладка «Подключение»)

Откройте страницу настроек модуля.

В поле API ключ вставьте ключ из личного кабинета ebot.biz (раздел интеграции с Битрикс24).

Сохраните настройки.

После сохранения модуль автоматически проверит ключ и отобразит данные аккаунта Ebot (имя, компания, тариф).

Если ключ недействителен, поле очистится — проверьте ключ в ebot.biz и повторите ввод.

Шаг 2. Настройка каталога (вкладка «Каталог»)

Инфоблок товаров — выберите инфоблок каталога, из которого будут выгружаться товары.

Инфоблок торговых предложений (SKU) — определяется автоматически, если каталог типовой; при необходимости выберите вручную.

Разделы каталога — отметьте разделы для выгрузки. Можно выбрать раздел верхнего уровня (включая подразделы) или конкретный вложенный раздел.

Соответствие полей товаров — для каждого поля Ebot укажите поле или свойство Битрикс (название, цена, описание, остатки, артикул, изображения и т.д.). Для цен можно выбрать один или несколько типов цен.

Новые характеристики Ebot — при необходимости нажмите «Добавить характеристику», укажите название в Ebot и свойство Битрикс. При сохранении характеристика будет создана в ebot.biz автоматически.

Соответствие полей торговых предложений — настройте название, цену, остаток и свойство-разделитель варианта (если используются SKU).

Нажмите «Сохранить настройки».

Шаг 3. Импорт товаров (вкладка «Импорт товаров»)

Убедитесь, что настройки каталога сохранены.

Нажмите «Импортировать товары».

Модуль сформирует CSV по выбранным разделам и полям и отправит его в ebot.biz. Прогресс отображается на странице.

Дождитесь завершения импорта. Количество обработанных и пропущенных товаров будет показано в статусе.

Импорт можно запускать повторно при изменении каталога или маппинга полей.

Шаг 4. Настройка заказов (вкладка «Заказы»)

Режим создания заказов:

CRM-заказ — заказы из Ebot создаются в модуле «Заказы» CRM Битрикс24

Сделка — заказы создаются как сделки CRM

Соответствие статусов — сопоставьте статусы Ebot со статусами заказов/сделок Битрикс24. Без маппинга обратная синхронизация статусов работать не будет.

Доставка и оплата — сопоставьте способы доставки и платёжные системы Ebot с аналогами в Битрикс24.

Сохраните настройки.

После настройки заказы из Ebot будут автоматически создаваться в Битрикс24, а смена статусов в Б24 (при корректном маппинге) будет передаваться обратно в Ebot.

Нюансы и рекомендации

API-ключ хранится в настройках модуля и используется для всех запросов к ebot.biz. При смене ключа в личном кабинете Ebot обновите его в модуле.

Связь заказов между системами устанавливается через XML_ID заказа (ebot:{id}) и служебные поля. Для корректной обратной синхронизации статусов заказы должны создаваться через модуль, а не вручную.

Товары без привязки к каталогу Bitrix добавляются в заказ как произвольные позиции. Такие строки корректно создаются при импорте из Ebot; при ручном редактировании заказа в админке Б24 соблюдайте осторожность с позициями без каталожного ID.

Логи модуля пишутся в /upload/ebot_b24.log — файл полезен при диагностике импорта, создания заказов и синхронизации статусов.

Обновление модуля с FTP/архива: замените папку ebot.b24, затем откройте страницу настроек модуля в админке — обработчики событий зарегистрируются автоматически.

Для работы интеграции на стороне ebot.biz должен быть активен магазин (store), привязанный к API-ключу.