Слеш-команды чат-ботов
С помощью слеш-команды можно вызвать бота по требованию пользователя. Например, можно создать бота, который будет создавать тикеты в учетных системах, заявки на отпуска или поручения прямо из чата.
Для работы слеш-команд требуется активация функционала чат-ботов.
Связанные статьи:
1 Общая схема работы
- Пользователь вызывает в чате команду вида "/my-command параметры команды"
- Платформа отправляет вебхук специализированному сервису
- Сервис выполняет операцию и отправляет уведомление о результатах выполнения
2 Создание слеш-команд
Перейти во вкладку слеш-команды выбранного бота
Добавить новую команду
Описание полей:
- Команда - Имя команды, его нужно будет печатать в чате для вызова. В данном случае название команды new-vacation. Но в чате для вызова команды нужно будет напечатать /new-vacation
- URL исходящего вебхука - адрес веб-сервиса, который будет обрабатывать запрос
- Короткая подсказка - отображается прямо в чате при написании команды
- Подробное описание - позволяет создавать многострочное описание. Здесь желательно подробно описать команду, ее параметры и добавить примеры вызова. Описание будет отображено, если пользователь ошибся при вызове команды
После сохранения команды в чате появляется возможность вызова.
Нужно выбрать команду, указать параметры и отправить
3 Обработка команд и технические рекомендации
После вызова команды в чате интеграционному сервису будет отправлен запрос такого формата
{
"chat_id": "1f094a54-b409-6b67-8e26-41c111dcd047",
"command": "new-vacation",
"organization_id": "1efa7da8-ca48-6abc-90dc-111147f7a08a",
"response_url": "https://mts-link.ru/application/webhook/interaction/1f094a62-1ce1-6689-a434-4fa4a227",
"text": "12.12.2025 10 плановый отпуск",
"token": "1efe8710-a39e-0000-0000-00000014ee459",
"user_id": "00000000-090f-0000-0000-024247f7a08a"
}
Результат выполнения команды нужно выслать по адресу response_url.
Пример вызова с ответом на команду бота
curl --location 'https://mts-link.ru/application/webhook/interaction/1f094a62-1ce1-6689-a434-4fa4a227' \
--header 'Content-Type: application/json' \
--data '{"text": "ответ hr сервиса"}'
В чате отобразится ответ бота
