Подключение Битрикс24¶

Битрикс24 — это платформа для управления бизнес-процессами, разработанная компанией 1С-Битрикс.

Эта пошаговая инструкция поможет вам подключить чат-бот Wisebot в Битрикс24 и интегрировать его в открытые линии.

Этапы интеграции:

Шаг 1. Регистрация Битрикс24
Шаг 2. Настройка интеграции в Битрикс24
Шаг 3. Настройка интеграции в Wisebot
Шаг 4. Создание и добавление виджета на сайт
Шаг 5. Настройка открытых линий

Шаг 1. Регистрация Битрикс24¶

Зарегистрируйте свой собственный портал Битрикс24.

Подробнее о регистрации читайте на официальном портале Битрикс24.

Если у вас уже есть портал, вы можете пропустить этот шаг.

Шаг 2. Настройка интеграции в Битрикс24¶

Авторизуйтесь в Битрикс24 с правами администратора.
Раскройте раздел Приложения в боковом меню и выберите пункт Разработчикам.
В открывшемся окне на вкладке Готовые сценарии выберите плитку Добавить чат-бот.
В окне Добавить чат-бот выберите плитку Информировать сотрудников в чате.
Откроется форма создания интеграции.
В поле Название бота укажите имя бота.
В поле URL обработчика бота укажите URL-адрес проекта Wisebot в формате https://your-domain.com/dev/123434/webhooks/bitrix/webhook .

Адрес можно скопировать в Wisebot. Перейдите в раздел Настройки → Учетные данные. При необходмости выберите вкладку со средой развертывания Development или Production. Скопируйте значения base_url и socket_path.
- Замените your-domain.com на значение из строки base_url.
- Замените /dev/123434/ на значение из строки socket_path (без /socket.io/).
В поле Тип бота выберите вариант Чат-бот для Открытых линий.
В поле Настройка прав укажите права бота. Например: Создание и управление Чат-ботами (imbot), Пользователи (user), Чат и уведомления (im) и Открытые линии (imopenlines).
Нажмите кнопку Сохранить.

Скопируйте настройки интеграции. Для этого в боковом меню раскройте блок Приложения и выберите пункт Разработчикам. Перейдите на вкладку Интеграции и вызовите меню действий для созданной интеграции. Выберите действие Редактировать. Скопируйте значения полей Вебхук для вызова rest api, BOT_ID и CLIENT_ID.

Шаг 3. Настройка интеграции в Wisebot¶

Откройте Wisebot и убедитесь, что настраиваете нужного бота. В боковом меню должно отображаться его имя.
Перейдите в раздел Настройки → Учетные данные.
Выберите вкладку со средой развертывания Development или Production.
Добавьте конфигурацию для Битрикс24.
```
bitrix:
  webhook: 'https://your-bitrix24.ru/rest/1/6njq9co7oq6fwcnk/' 
  bot_id: 8 
  client_id: 'huga9qedkr004tibo1gsp0m9vymzqyhk'
```
Замените значения webhook, BOT_ID и CLIENT_ID на свои.

При необходимости укажите дополнительные настройки для открытых линий. Например:
```
  score_answer_str: 'Оцените ответ'
  follow_up_message: 'Могу ли я вам еще чем-то помочь?'
  follow_up_timeout: 300
  connecting_to_operator_message: 'Соединяю вас с оператором...'
  operator_status_api: 'timeman.status.json?user_id=1'
  transfer_id: 1
  operator_offline_str: 'Вам ответит первый свободный оператор в рабочее время с 9 до 18, Пн.-Пт'
  forget_dialog_timeout: 1800
```
- score_answer_str - сообщение для оценки ответа,
- follow_up_message - сообщение для автоматической отправки пользователю после заданного таймаута,
- follow_up_timeout - время ожидания в секундах перед отправкой follow_up сообщения,
- connecting_to_operator_message - текст сообщения при соединении с оператором,
- operator_status_api - API-endpoint для проверки статуса оператора,
- transfer_id - идентификатор для перевода чата на оператора,
- operator_offline_str - сообщение, отправляемое когда оператор оффлайн,
- forget_dialog_timeout - время в секундах, после которого диалог считается завершенным,
- transfer_id параметр передаётся в Битрикс24 API-метод imopenlines.operator.transfer и определяет, куда именно должен быть перенаправлен чат пользователя, когда бот передаёт управление диалогом живому оператору.
  
  В зависимости от настроек Битрикс24, transfer_id может представлять:
  - ID конкретной открытой линии (Open Line),
  - ID отдела или группы операторов,
  - ID конкретного оператора.
Нажмите Сохранить и подтвердите перезапуск инстанса для выбранного окружения.

Теперь можно пообщаться с ботом в чате. Для этого перейдите в раздел Чаты и найдите бота по имени в поисковой строке.

Пример диалога c ботом:

Шаг 4. Создание и добавление виджета на сайт¶

Если у вас уже есть виджет на сайте, то этот шаг можно пропустить.

Перейдите в раздел CRM → Интеграции → Мессенджеры.
Нажмите на плитку Виджет на сайт. Если у вас уже есть виджеты, то нажмите на плитку и выберите действие Добавить новый виджет в появившемся меню.
Откроется форма редактирования виджета. Укажите все необходимые настройки.
Нажмите Сохранить.

Скопируйте скрипт для вставки виджета на свой сайт. Для этого перейдите в раздел CRM → Интеграции → Мессенджеры. Нажмите на плитку Виджет на сайт. В появившемся меню выберите созданный виджет. Откроется форма редактирования виджета, в которой скопируйте Код для вставки и поместите этот код на свой сайт перед закрывающим тегом </body>.

Шаг 5. Настройка открытых линий¶

Назначьте бота на первую линию поддержки.

Перейдите в раздел CRM → Интеграции → Мессенджеры.
Нажмите на плитку Онлайн-чат. Если у вас уже создан онлайн-чат, то нажмите на плитку и выберите необходимую открытую линию или выберите действие Добавить новый виджет.
В открывшейся форме редактирования нажмите на кнопку Настроить.
Откроется окно Настройка.
Перейдите на вкладку Чат-боты.
Установите флаг При обращении клиента назначить ответственным чат-бота и выберите бота, добавленного на шаге 2. При необходимости выставите остальные настройки.
Нажмите Сохранить.

Пример сайта с добавленным виджетом: