Webim (External Bot API 2.0)

Webim — платформа онлайн-консультирования. Общение возможно через различные каналы: чат на сайте, мессенджеры, социальные сети, чат-боты, мобильные приложения и другие. Платформа также интегрируется с CRM и HelpDesk системами.

Webim в платформе JAICP вы можете подключить как входящий или операторский канал. В этой статье мы рассматриваем подключение канала Webim (External Bot API 2.0). Для данного канала подключение ботов происходит посредством External Bot API 2.0.

Настройка Webim (External Bot API 2.0)

Авторизуйтесь в платформе Webim как администратор. На панели управления нажмите Настройки > Боты.

Приступите к созданию нового бота, заполните поля:

Оператор для бота — выберите оператора, к которому будет прикреплён бот. Рекомендуется создавать для ботов отдельных операторов.
Тип бота — выберите Умный бот
Порядок сортировки — порядок определяет, на каком месте в списке ботов данный бот будет находиться. Чем меньше число, тем выше приоритет.
Статус — выберите статус бота.
Версия — выберите версию 2.
Ссылка на внешний API — в качестве ссылки на внешний API укажите https://example.com. После подключения канала в платформе JAICP необходимо будет заменить эту ссылку.

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

Подробнее о методах Webim (External Bot API 2.0)

Создание канала

Нажмите на панели управления Каналы > Входящие > Создать канал. В разделе Другие выберите Webim (External Bot API 2.0).

Заполните поля:

Название — укажите название для канала или оставьте по умолчанию.
Токен — вставьте скопированный ранее токен.
Почтовый адрес — укажите почтовый адрес учетной записи администратора сервиса Webim.
Пароль — укажите пароль учетной записи администратора сервиса Webim.

Указание данных учетной записи администратора необходимо только для получения списка операторов.

Домен — введите домен, на который вы устанавливаете сервис Webim. Например, для учетной записи https://examplecom.webim.ru домен examplecom.
Oтправлять ли /start в начале диалога — при активном параметре бот начинает диалог, не дожидаясь сообщения от клиента.
Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию master. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита.
Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).

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

Нажмите Создать. Дождитесь всплывающего окна с результатом деплоя.

После создания канала формируется API Endpoint, перейдите к редактированию канала и скопируйте значение поля API Endpoint. Вернитесь в Webim, перейдите к редактированию бота. Замените здесь значение поля Ссылка на внешний API на скопированный API Endpoint.

Тестирование бота

Перейдите в окно диалога с ботом в подключенном мессенджере и отправьте ему приветственную/активационную фразу, предусмотренную вашим сценарием. После этого должен начаться ваш диалог с ботом.