Контекстные приложения
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
О том, что такое контекст-приложения, можно прочитать здесь.
Для работы с контекстом выполните несколько действий:
-
Зарегистрируйте приложение. Вы можете зарегистрировать скрытое приложение, чтобы оно не отображалось на панели ввода текста
-
Отправьте (или обновите) любое сообщение с прикрепленной клавиатурой или с меню
-
В параметрах кнопки клавиатуры или пункта меню необходимо передайте идентификатор приложения
Примеры
Примечание
В примере используется функция restCommand. Это метод отправки данных в Битрикс24. Другой пример использования метода вы найдете в примере ЭхоБота. Вы можете использовать для вызова метода свою функцию, javascript-метод BX24.callMethod или bitrix24-php-sdk.
restCommand(
'imbot.message.add',
Array(
"DIALOG_ID" => 2,
"BOT_ID" => 17,
"MESSAGE" => "Hello! My name is EchoBot :)",
"KEYBOARD" => [
{
"TEXT":"Open App",
"APP_ID":11
}
],
"MENU" => [
{
"TEXT":"Open App",
"APP_ID":11
}
]
),
$_REQUEST["auth"]
);
Как использовать примеры в документации
Примечание
Кроме APP_ID, вы можете передать любую строку в параметр APP_PARAMS. При открытии вашего IFRAME данные будут переданы параметру BUTTON_PARAMS.
Правила разработки IFRAME-обработчика и ограничения представлены в документации. При создании сообщения вы можете использовать один из двух вариантов — клавиатура (KEYBOARD) или контекстное меню (MENU).