Слеш-команды чат-ботов

С помощью слеш-команды можно вызвать бота по требованию пользователя. Например, можно создать бота, который будет создавать тикеты в учетных системах, заявки на отпуска или поручения прямо из чата.

Для работы слеш-команд требуется активация функционала чат-ботов.

Связанные статьи:

- Создание чат-бота

- Настройка чат-бота

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 сервиса"}'

В чате отобразится ответ бота

Слеш-команды в мобильном приложении

Слеш-команды теперь доступны в мобильных приложениях МТС Линк на iOS и Android.

С их помощью можно запускать команды чат-ботов и действия во внешних сервисах прямо из мобильного чата — например, создавать заявки, задачи или обращения.

Как воспользоваться слеш-командой

1. Откройте нужный чат.

2. В поле ввода сообщения введите символ /.

3. Выберите нужную команду из списка или начните вводить ее название вручную.

4. Заполните необходимые параметры команды.

5. Отправьте сообщение.

После выполнения команды результат отобразится непосредственно в чате. Если произошла ошибка, пользователь увидит соответствующее уведомление.

Важно

Набор доступных слеш-команд зависит от настроек организации. Команды создают и настраивают администраторы организации, поэтому в разных организациях список команд может отличаться.

Если в организации слеш-команды не настроены или чат-бот недоступен, список команд при вводе символа / отображаться не будет.