Bitrix24
Подключите бота к Открытой линии Битрикс24
Бота можно подключить к Битрикс24 двумя способами:
- через приложение Wikibot из Маркета Битрикс24 — без вебхуков и ключей, рекомендуем;
- через вебхук — вручную, в разделе Разработчикам Битрикс24.
После подключения любым способом бота нужно назначить открытой линии.
Подключение через приложение из Маркета
Приложения из Маркета Битрикс24 устанавливаются на порталы с подпиской Битрикс24.Маркетплейс или с её пробным периодом.
Откройте страницу приложения Wikibot в Маркете Битрикс24 и нажмите Установить. Установить приложение может администратор портала.
Откройте приложение: Приложения --> Wikibot. Нажмите Войти в Wikibot — вход откроется в отдельном окне. Войдите в аккаунт Wikibot или зарегистрируйтесь и подтвердите подключение.
Вход нужен один раз: дальше приложение будет открываться сразу под вашим аккаунтом. Каждый сотрудник портала входит под своим аккаунтом Wikibot и видит только тех ботов, которых может редактировать в личном кабинете.
Если браузер заблокировал всплывающее окно, разрешите всплывающие окна для портала и нажмите Войти в Wikibot ещё раз.
В списке ботов включите переключатель у нужного бота. Бот появится среди чат-ботов открытых линий портала.
Если ботов ещё нет, создайте нового кнопкой Новый бот прямо в окне приложения. Затем наполните его базу знаний в личном кабинете, чтобы бот отвечал по делу.
Перейдите к разделу Подключение к Открытой Линии.
Имя бота в Битрикс24
Бот появляется на портале под тем же именем, что и в Wikibot. Чтобы клиенты и операторы видели другое имя, нажмите на карандаш рядом с подключённым ботом в окне приложения, введите новое имя и нажмите Сохранить. Имя бота в Wikibot при этом не изменится.
Отключение
- Чтобы отключить бота, выключите его переключатель в окне приложения. Бот пропадёт из чат-ботов открытых линий портала.
- Сменить аккаунт в окне приложения меняет только аккаунт, под которым открывается приложение. Подключённые боты продолжают работать.
- При удалении приложения с портала все его боты отключаются, а данные портала удаляются из Wikibot.
Подключение через вебхук
Данная интеграция возможна только при наличии платной версии Bitrix24.
На портале перейдите в раздел Настройки --> Подключения своего бота и включите интеграцию Битрикс24. Скопируйте Webhook Url.
Перейдите по меню Приложения --> Разработчикам --> Добавить чат-бот и выберите пункт Передавать боту сообщения из чата.
Далее необходимо настроить бота.
Задайте следующие параметры:
- Имя бота, например Мой бот.
- URL обработчика бота - вставьте полученный на портале Wikibot Webhook Url.
- Тип бота Чат-бот для Открытых линий.
Пролистайте ниже, включите исходящий вебхук и настройте его:
- Добавьте URL обработчика - вставьте полученный на портале Wikibot Webhook Url.
- Добавьте События:
- Новое сообщение из ОЛ.
- Новое сообщение боту.
В блоке Настройка прав выберите Открытые линии (imopenlines), Создание и управление Чат-ботами (imbot) и Диск (disk). Без первого бот не узнает номер обращения, и дообучение не сможет прочитать переписку с оператором. Без права на Диск бот не сможет открыть изображения, которые присылает клиент: такие обращения будут переводиться на оператора.
Нажмите кнопку сохранить, чтобы применить изменения и получить необходимые параметры.
Пролистайте наверх, скопируйте текст из поля Вебхук для вызова REST API и вставьте в настройках Wikibot в поле REST API URL.
Cкопируйте текст из поля CLIENT_ID бота и вставьте в настройках Wikibot в поле CLIENT_ID бота.
Сохраните все изменения и перейдите к подключению бота к Открытой Линии
Подключение к Открытой Линии
Перейдите в раздел CRM --> Клиенты --> Контакт-центр. Выберите нужный канал коммуникаций — например, Telegram, ВКонтакте или онлайн-чат — и нажмите Создать открытую линию, если она не была создана ранее.
В настройках канала нажмите Настроить рядом с выбранной открытой линией.
На вкладке Чат-боты поставьте галочку При обращении клиента назначить ответственным чат-бота и выберите созданного бота из списка.
Настройте параметры бота исходя из ваших требований. Для настройки Когда отключать чат-бота выберите значение После перевода на оператора.
Добавьте виджет на сайт или подключите мессенджер в разделе CRM --> Клиенты --> Контакт-центр.
Ваш чат-бот готов! Проверьте работу бота, написав сообщение в виджет или телеграм.