Gallery

Docs

История изменений

История релизов

НАЧАЛО РАБОТЫ С ПЛАТФОРМОЙ

ПЕРЕД СОЗДАНИЕМ АГЕНТА

КОНСТРУКТОР СЦЕНАРИЯ АГЕНТА

СОЗДАНИЕ АГЕНТА НА ПЛАТФОРМЕ

ОБУЧЕНИЕ И ТЕСТИРОВАНИЕ АГЕНТА

РАЗМЕЩЕНИЕ АГЕНТА В КАНАЛАХ

ЭКСПЛУАТАЦИЯ АГЕНТА

АНАЛИТИКА ОБЩЕНИЯ АГЕНТА

Explore

Вывод Агента в омниканальные платформы

Публичный асинхронный API "Omnichannel"

Omnichannel — универсальный канал с публичным API, предназначенный для подключения

@Агент⁠

а к

@Конечный канал⁠

, для которых нет встроенного в

@Платформа⁠

@Брендовый коннектор⁠

Организовать такой универсальный канал можно с помощью

@Универсальный коннектор⁠

“Omnichannel”.

Подключение

Конфигурация канала агента в Платформе

⁠

@Агент⁠

у необходимо создать и настроить

@Канал Агента⁠

@Коннектор⁠

ом “Omnichannel”.

Войдите в меню редактирования (Edit) настроек вашего

@Агент⁠

⁠

В появившемся окне перейдите на вкладку Channels для настройки каналов, затем:

выберите тип канала Omnichannel

Нажмите кнопку Add channel

⁠

Интеграция с сервером клиента происходит через универсальный

@Коннектор⁠

с названием “Omnichannel”, установите его в поле Channel.

⁠

По необходимости пропишите заголовок для данного

@Канал Агента⁠

в поле Title.

⁠

После выбора

@Коннектор⁠

вам станет доступна ссылка на вебхук канала агента (поле Chatbot webhook: URL).

⁠

⁠

Пропишите адрес вашего сервера в поле Channel webhook: URL в виде https://{server_adress},

где {server_adress} — адрес

@Платформа⁠

Важно: к указанному адресу будет подставлен метод при отправке
@Агент⁠
ом ответа на запрос из канала/сервера клиента: https://your_company.com/send_message.

Установите ваш токен в поле Channel webhook: Token в окне настроек

@Канал Агента⁠

Важно: токен необходимо указывать в случае, если авторизация на стороне клиента осуществляется через header. Подробнее описано в
Авторизация на стороне клиента⁠
.

⁠

Снимок экрана 2023-07-03 в 23.58.55 1.png

⁠

Активируйте канал переключением тумблера для того, чтобы

@Агент⁠

начал отвечать в нем.

⁠

Если

@Агент⁠

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

@Агент⁠

а, после чего повторить попытку активации

@Канал Агента⁠

⁠

После активации

@Канал Агента⁠

, если есть проблемы с его доступностью, будет выведено предупреждение (

@Канал Агента⁠

будет активирован несмотря на проблемы):

"Can’t reach channel" — выводится в случае, если сервер не отвечает по указанному URL

⁠

Сохраните

@Канал Агента⁠

— нажмите Save.

Важно: Все настройки будут применены только после сохранения.

Запросы из канала/сервера клиента к Агенту на Платформе

Поддерживаемый протокол и метод:

HTTPS, POST c content-type JSON

Endpoint для получения запросов каналом агента:

Запросы отправляются на Chatbot Webhook URL, указанный при

подключении⁠

@Канал Агента⁠

Формат endpoint (Chatbot Webhook URL):

Платформа развернута в облаке

https://admin.chatme.ai/connector/omnichannel/omnichannel_message/{token}/bot_api_webhook

Платформа развернута в контуре клиента

https://{server_adress}/connector/omnichannel/omnichannel_message/{token}/bot_api_webhook

Где:

{server_adress} — адрес

@Платформа⁠

{token} — токен авторизации.

Общая структура запроса

Вид тела запроса:

{

"event": (string),

"chat_id": (integer),

"visitor": {

"id": (string),

"fields": {

Fields (object)

}

"message": {

Message (object)

}

Важно: структура объекта Message зависит от типа передаваемого сообщения (текст, файл, нажатие на кнопку) и может состоять из разных видов данных и полей.