Подключение LEVBOT Green к Bitrix24

Эта инструкция ведёт от пустого портала Bitrix24 до работающего чата на сайте, где первым отвечает Green, а при необходимости разговор передаётся живому сотруднику.

Весь путь выполняется через интерфейсы Bitrix24 и LEVBOT DEPLOY. PowerShell, SSH-команды и ручные запросы к API не нужны.

Скриншоты сделаны на тестовом портале. Названия отдельных пунктов могут немного отличаться после обновления Bitrix24, но логика и порядок действий остаются теми же.

---

Что получится в конце

После настройки схема будет такой:

1. Посетитель открывает чат на сайте.
2. Bitrix24 создаёт новый разговор в Открытой линии.
3. Первым ответственным назначается чат-бот Green.
4. Green получает сообщение и отвечает.
5. Если нужен человек, разговор переводится в очередь живых операторов.

Для этого в Bitrix24 создаются три разные сущности. Их нельзя путать:

Integration Levbot — не бот и не оператор. Его не надо добавлять в очередь. Green регистрируется отдельно и подключается в разделе «Чат-боты».

---

Что подготовить заранее

Понадобятся:

• работающий портал Bitrix24;
• основной аккаунт администратора;
• второй e-mail для технического сотрудника Integration Levbot;
• установленный или подготовленный Green;
• домен, по которому Green доступен через HTTPS;
• REST webhook, созданный под техническим сотрудником;
• доступ к серверу по SSH для кнопки «Перенастроить Льва».

Если Bitrix24 при создании вебхука просит подключить Маркетплейс или активировать пробный период, следуйте подсказке самого портала. Без доступного раздела интеграций входящий вебхук создать не получится.

---

# Часть 1. Создаём портал и технического сотрудника

Шаг 1. Создайте или откройте портал Bitrix24

При первом запуске Bitrix24 укажите e-mail владельца и создайте портал.

Этот первый аккаунт будет администратором. Под ним выполняются все действия с Открытой линией, очередью и подключением Green.

Шаг 2. Пригласите технического сотрудника

В правом верхнем углу нажмите «Пригласить», затем ещё раз «Пригласить» в открывшемся меню.

Выберите приглашение по почте или СМС. Укажите отдельный e-mail и создайте сотрудника, например:

• имя: Integration;
• фамилия: Levbot.

После приглашения войдите по этому e-mail и завершите регистрацию второго аккаунта.

Важно: это отдельный технический пользователь. Не используйте для вебхука личный аккаунт директора или администратора, если хотите, чтобы интеграция не зависела от конкретного человека.

---

# Часть 2. Создаём Открытую линию

Шаг 3. Откройте Контакт-центр

Вернитесь в аккаунт администратора. Через поиск Bitrix24 найдите «Контакт-центр».

Шаг 4. Подключите Онлайн-чат

В Контакт-центре нажмите плитку «Онлайн-чат». Если линия ещё не создана, выберите «Создать Открытую линию».

Bitrix24 создаст линию и подключит к ней онлайн-чат. Позже к этой же линии будет подключён Green.

Шаг 5. Оставьте в очереди живого сотрудника

В очереди должен находиться администратор или реальные менеджеры, которые смогут принять разговор после передачи от бота.

Не добавляйте Integration Levbot в очередь.

Технический сотрудник нужен для вебхука и API, а не для ответов клиентам.

---

# Часть 3. Даём техническому сотруднику минимальные права

Шаг 6. Откройте настройку прав Открытой линии

В карточке Онлайн-чата найдите блок «Права доступа» и нажмите «настроить».

Шаг 7. Создайте роль BOT Service

В правой части экрана, в блоке «Список ролей», нажмите «Добавить».

Назовите роль:

BOT Service

Выставьте права точно так:

Сохраните роль. Затем вернитесь на экран прав доступа и назначьте роль BOT Service сотруднику Integration Levbot.

Смысл такой: технический пользователь может видеть линии и историю, а также подключаться к разговору через API, но не может менять каналы и общие настройки портала.

---

# Часть 4. Создаём входящий REST webhook

Шаг 8. Переключитесь на Integration Levbot

Дальнейшие действия выполняются из второго аккаунта — Integration Levbot.

В строке поиска Bitrix24 введите:

разработчикам

Откройте найденный пункт «Разработчикам».

Шаг 9. Откройте раздел «Другое»

На странице «Разработчикам» нажмите плитку «Другое».

Затем выберите «Входящий вебхук».

Шаг 10. Выдайте вебхуку шесть прав

В настройке прав добавьте ровно эти шесть разрешений:

1. Создание и управление чат-ботами — imbot
2. Открытые линии — imopenlines
3. Чат и уведомления — im
4. Коннекторы для внешних мессенджеров — imconnector
5. Диск — disk
6. CRM — crm

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

В верхней части страницы появится адрес вида:

https://ваш-портал.bitrix24.ru/rest/123/секретный_токен/

Скопируйте именно базовый REST webhook, заканчивающийся символом /.

Не копируйте тестовый URL метода profile.json из генератора запросов. DEPLOY нужен базовый адрес вебхука.

REST webhook — секрет. Не публикуйте его, не отправляйте в общие чаты и не вставляйте в документацию. Если ссылка утекла, нажмите «Перегенерировать» и используйте новую.

---

# Часть 5. Регистрируем Green через LEVBOT DEPLOY

Шаг 11. Заполните блок Bitrix24

Откройте LEVBOT DEPLOY и выполните следующее:

1. Убедитесь, что в поле «Домен» указан домен установленного Green.
2. Поставьте галочку «Подключить Bitrix24».
3. Вставьте REST webhook в соответствующее поле.
4. Нажмите кнопку справа от webhook — «Заполнить остальное».

В ранних тестовых сборках эта кнопка могла называться «Получить ID». Это одна и та же операция.

DEPLOY сам:

• проверит REST webhook;
• проверит необходимые права;
• зарегистрирует Green в Bitrix24;
• создаст стабильный CLIENT_ID;
• получит BOT_ID;
• подготовит автоматическое получение Application token.

Пользователь вручную вводит только REST webhook. Поля BOT_ID, CLIENT_ID и Application token предназначены для контроля и заполняются автоматически.

Успешное состояние выглядит примерно так:

✓ REST
✓ права
✓ Green
✓ BOT_ID
✓ CLIENT_ID
○ token ждёт

Статус token ждёт на этом этапе нормален. Application token приходит только вместе с первым настоящим событием от Bitrix24.

Шаг 12. Примените настройки к серверу

Если Green ещё не установлен

Заполните обычные данные сервера и модели, затем выполните стандартную установку:

1. Подготовить сервер
2. Запустить Льва

Если Green уже работает на сервере

Повторно устанавливать сервер не надо.

Заполните только доступ по SSH:

• IP или домен сервера;
• SSH-порт;
• пользователя;
• пароль или ключ.

Затем нажмите «Перенастроить Льва».

Для перенастройки существующего Green повторно вводить Yandex API Key и Yandex Folder ID не требуется. DEPLOY должен сохранить уже работающие параметры модели и изменить только конфигурацию Bitrix24.

---

# Часть 6. Подключаем Green к Открытой линии

Шаг 13. Вернитесь в аккаунт администратора

Откройте:

Контакт-центр → Онлайн-чат

В карточке подключённого Онлайн-чата рядом с названием Открытой линии нажмите «Настроить».

Шаг 14. Назначьте Green первым отвечающим

В левом меню откройте раздел «Чат-боты».

Выставьте:

• При обращении клиента назначить ответственным чат-бота — включено;
• Выберите чат-бота — Green;
• Когда подключать чат-бота — В начале каждого нового разговора;
• Через какое время переводить разговор от чат-бота в очередь — Никогда;
• Когда отключать чат-бота — После перевода на оператора.

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

Почему ставим «Никогда»: Green должен отвечать столько, сколько требуется. Передача живому менеджеру происходит осознанно по сценарию, а не автоматически через 10 минут молчания.

---

# Часть 7. Добавляем чат Bitrix24 на сайт

Шаг 15. Создайте виджет на сайт

В Контакт-центре откройте «Виджет на сайт» и создайте новый виджет, например LEVBOT.

В виджете:

1. включите Открытую линию;
2. оставьте подключённым Онлайн-чат;
3. выберите линию, к которой подключён Green;
4. задайте положение кнопки и время показа;
5. сохраните виджет;
6. скопируйте предложенный Bitrix24 код для сайта.

Код виджета вставляется в общий публичный шаблон сайта перед закрывающим тегом </body> или в штатное место загрузки внешних скриптов вашего фреймворка.

Для сайта LEVBOT разумная схема такая:

• показывать чат на главной и других публичных продающих страницах;
• не показывать внутри /red;
• не показывать в документации /help;
• не показывать на административных и технических маршрутах.

Сам код публичного виджета не содержит REST webhook, BOT_ID, CLIENT_ID или Application token. Эти секреты на сайт добавлять нельзя.

---

# Часть 8. Первый запуск и проверка

Шаг 16. Отправьте первое сообщение как новый посетитель

Проверяйте через новое окно браузера в режиме инкогнито:

1. откройте страницу сайта с виджетом;
2. нажмите кнопку чата;
3. отправьте новое сообщение;
4. откройте Bitrix24 и убедитесь, что появился новый разговор;
5. проверьте, что ответственным назначен Green;
6. дождитесь ответа бота.

Первое настоящее событие должно принести Application token. Green сохранит его и переведёт проверку событий из режима ожидания в строгий режим.

Application token не надо искать и копировать вручную.

---

# Быстрая итоговая проверка

Перед завершением пройдите чек-лист:

• [ ] В Bitrix24 есть отдельный сотрудник Integration Levbot.
• [ ] У него назначена роль BOT Service.
• [ ] Integration Levbot не добавлен в очередь операторов.
• [ ] В очереди есть хотя бы один живой сотрудник.
• [ ] Входящий webhook создан из аккаунта Integration Levbot.
• [ ] У webhook выбраны шесть прав: imbot, imopenlines, im, imconnector, disk, crm.
• [ ] В DEPLOY успешно заполнены BOT_ID и CLIENT_ID.
• [ ] После регистрации выполнена установка или «Перенастроить Льва».
• [ ] Green выбран в разделе «Чат-боты» Открытой линии.
• [ ] Green подключается в начале каждого нового разговора.
• [ ] Автоматический перевод в очередь установлен на «Никогда».
• [ ] Код виджета установлен на публичные страницы сайта.
• [ ] Тест проводится новым посетителем в режиме инкогнито.
• [ ] Green получает сообщение и отвечает.

---

# Частые ошибки

Green не появляется в списке чат-ботов

Причины:

• в DEPLOY не нажата кнопка «Заполнить остальное»;
• регистрация завершилась ошибкой;
• не получен BOT_ID;
• webhook не имеет права imbot;
• настройки были заполнены, но не применены к серверу.

Что делать: повторно откройте DEPLOY, проверьте зелёные статусы и убедитесь, что BOT_ID заполнен. Повторное нажатие кнопки не должно создавать второго Green.

DEPLOY пишет, что не хватает прав

Откройте входящий webhook и проверьте все шесть разрешений:

imbot
imopenlines
im
imconnector
disk
crm

После изменения прав сохраните webhook и снова нажмите «Заполнить остальное».

Вебхук работает, но создан под администратором

Технически такой webhook может отвечать на запросы, но это неправильная эксплуатационная схема. Создайте отдельного сотрудника Integration Levbot, выдайте ему роль BOT Service и создайте новый webhook уже из его аккаунта.

Integration Levbot оказался в очереди

Удалите его из очереди. В очереди должны быть только реальные сотрудники. Технический пользователь не должен получать клиентские диалоги как оператор.

Разговор уходит менеджеру через 10 минут

В настройках Открытой линии откройте «Чат-боты» и поменяйте:

Через какое время переводить разговор от чат-бота в очередь → Никогда

Application token всё ещё ожидается

Это нормально до первого настоящего сообщения. Создайте новый разговор через сайт в режиме инкогнито. Старый уже открытый диалог может не создать нужное стартовое событие.

Сообщение появилось в Bitrix24, но Green не ответил

Проверьте по порядку:

1. Green назначен ответственным в разделе «Чат-боты».
2. Выбрано «В начале каждого нового разговора».
3. После получения BOT_ID выполнено «Перенастроить Льва».
4. Домен Green работает по HTTPS.
5. Обработчик Bitrix24 доступен извне.
6. Служба Green запущена.
7. REST webhook не был перегенерирован после настройки.

Не создавайте второго бота наугад. Сначала найдите этап, на котором оборвалась цепочка.

На сайте нет кнопки чата

Проверьте:

• виджет сохранён и включён;
• код Bitrix24 действительно добавлен в публичный layout сайта;
• скрипт не исключён настройками отображения;
• расширение-блокировщик рекламы не режет виджет;
• Content Security Policy сайта разрешает официальные домены Bitrix24;
• на странице не возникла ошибка JavaScript.

На странице появилось две кнопки чата

Код виджета подключён дважды: например, одновременно в общем layout и в отдельной странице. Оставьте одно подключение в общем публичном шаблоне.

---

# Самое важное в одной минуте

1. Администратор создаёт Открытую линию.
2. Отдельному сотруднику Integration Levbot назначается минимальная роль BOT Service.
3. Из его аккаунта создаётся входящий webhook с шестью правами.
4. В DEPLOY вставляется webhook и нажимается «Заполнить остальное».
5. Для работающего сервера нажимается «Перенастроить Льва».
6. Администратор выбирает Green в разделе «Чат-боты».
7. Green подключается в начале каждого разговора, перевод в очередь — «Никогда».
8. Код виджета устанавливается на публичные страницы сайта.
9. Первое сообщение отправляется из режима инкогнито.

Готово: клиент пишет в виджет Bitrix24, а отвечает Green.