imbot.command.answer

Просмотров: 12714
Дата последнего изменения: 17.05.2022

Анна Кокина

Сложность урока:

3 уровень - средняя сложность. Необходимо внимание и немного подумать.

Публикация ответа на команду

Обратите внимание! Метод указан с использованием функции restCommand - это метод отправки данных в Битрикс24, данный метод есть в примере ЭхоБота и представлен здесь в качестве примера. Вы можете использовать свою функцию или javascript-метод BX24.callMethod или bitrix24-php-sdk.

Обратите внимание! Для обработки команды нужно, чтобы в приложении была обработка события добавления команды ONIMCOMMANDADD.

Вызов метода

$result = restCommand('imbot.command.answer', Array(

    'COMMAND_ID' => 13, // Идентификатор команды, которая подготовила ответ (обязательно указывать или COMMAND)
    'COMMAND' => 'echo', // Название команды, которая подготовила ответ (обязательно указывать или COMMAND_ID)
    'MESSAGE_ID' => 1122, // Идентификатор сообщения, на которое необходимо дать ответ
    'MESSAGE' => 'answer text' // Текст ответа
    'ATTACH' => '' // Вложение, необязательное поле
    'KEYBOARD' => '' // Клавиатура, необязательное поле
    'MENU' => '' // Контекстное меню, необязательное поле 
    'SYSTEM' => 'N' // Отображать сообщения в виде системного сообщения, необязательное поле, по умолчанию 'N'
    'URL_PREVIEW' => 'Y' // Преобразовывать ссылки в rich-ссылки, необязательное поле, по умолчанию 'Y'
    'CLIENT_ID' => '', // Строковый идентификатор чат-бота, используется только в режиме Вебхуков

), $_REQUEST["auth"]);

Результат выполнения

Идентификатор сообщения команды MESSAGE_ID или ошибка.

Ссылки по теме

Возможные коды ошибок

Код	Описание
COMMAND_ID_ERROR	Команда не найдена.
APP_ID_ERROR	Чат-бот не принадлежит этому приложению. Работать можно только с чат-ботами, установленными в рамках приложения.
MESSAGE_EMPTY	Не передан текст сообщения.
ATTACH_ERROR	Весь переданный объект вложения не прошел валидацию.
ATTACH_OVERSIZE	Превышен максимально допустимый размер вложения (30 Кб).
KEYBOARD_ERROR	Весь переданный объект клавиатуры не прошел валидацию.
KEYBOARD_OVERSIZE	Превышен максимально допустимый размер клавиатуры (30 Кб).
MENU_ERROR	Весь переданный объект меню не прошел валидацию.
MENU_OVERSIZE	Превышен максимально допустимый размер меню (30 Кб).
WRONG_REQUEST	Что-то пошло не так.

Курсы разработаны в компании «1С-Битрикс»