JAICP

Ответ бота


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

Универсальные ответы передаются в структуре replies. replies — массив реплик бота, содержащий строго типизированные элементы. Предназначен для передачи в различные каналы, такие, как Telegram, Slack и др.

Бот возвращает один или более ответов, которые задаются специальными тегами или складываются скриптом в $response.replies.

script:
    $response.replies.push( {
        type: text|image|buttons|...
        text: ...
        imageUrl: ...
        }
 ]

$response.replies — список ответов, выведенных в процессе обработки реакций.

Один ответ бота может содержать не более 100 сообщений в массиве $response.replies. Их суммарная длина не должна превышать 50 000 символов.


Типы ответов

Ниже представлен список поддерживаемых платформой replies.

Тип Описание
text Простой текстовый ответ, каждый элемент выводится отдельным сообщением.
buttons Вывод кнопки.
inlineButtons Вывод inline-кнопки.
image Вывод изображения.
raw Используется для передачи методов, специфичных для определенного канала.
switch Переключает диалог клиента с бота на оператора.
location Вывод координат.
timeout Задает переход в состояние, если от пользователя нет ответа.
dtmf Запрос у абонента набор DTMF-сообщения (цифры/символы в тоновом режиме). Только для телефонного канала.
hangup Прервать звонок. Только для телефонного канала.
htmlResponse Тип ответа htmlResponse используется для вывода визуальной составляющей навыков, созданных с использованием Interactive Canvas.
carousel Вывод списка элементов с возможностью выбора одного из них.
sms Отправка SMS-сообщений.

Подробная информация о формате ответа бота, параметрах, типах сообщений для каналов представлена в статье Типы ответов.