Перейти к основному содержимому

Создание и использование slash-commands

В пространстве должно быть разрешено создание слеш-команд

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

Для создания бота в Time, выполните следующие шаги:

  1. Откройте меню (𓃑) слева вверху и выберите "Integrations".

  2. В открывшемся меню выберите "Slash-Commands". Это позволит вам перейти к созданию новой команды.

  3. Нажмите "Add Slash Command". Это действие откроет форму для создания новой команды.

  4. Настройте параметры команды.

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

  6. Сохраните токен, так как вы не сможете посмотреть его повторно.

В запросе будут содержаться параметры запроса. В зависимости от настроек слеш-команды:

  • Метод отправки: GET — будут отправлены Query параметры в URL
  • Метод отправки POST — будут отправлены Query параметры в Body запроса с Content-Type: application/x-www-form-urlencoded

Пример структуры запроса:

ИмяТипОписаниеПример
channel_idstringID канала в котором была вызвана команда9ayyzd4nciyc3ptamsk6g4s3dy
channel_namestringНазвание канала в котором была вызвана командаTown Square
commandstringИспользованная команда/help
response_urlstringURL ответаhttps://time.tbank.ru/hooks/commands/7manpact9pnf5kwy45fo5qy7rw
team_domainstringНазвание пространстваT-Bank
team_idstringID пространстваw3in81d847bs9dpc8agfnympnr
textstringНаписанный после команды текстHello!
tokenstringТокен слеш-команды, который используется для валидации запросаdzcnm3gn97rypfrc8ncpzs58ah
user_idstringID вызвавшего команду пользователя9ugwhafrbbro9pgjn1xywh5mja
user_namestringИмя вызвавшего команду пользователяi.ivanov
root_idstringID корневого сообщения, если команда была вызвана в обсуждении8hxm9s3ui7bkic4iway6p66a8r

Поле token будет содержать токен слеш-команды, который используется для валидации запроса. Сервер может отправить ответ, на основе которого может быть создан, например: новый пост.

ИмяТипОписаниеПример
response_typestringТип ответаin_channel, ephemeral
textstringНаписанный после команды текстHello!
usernamestringОтображаемое имя в сообщении от слеш-командыHelper
channel_idstringКанал для ответаz49mscpgx3re7rhjstsu88yfio
icon_urlstringURL картинки аватара интеграции при ответе на команду-
typestringТип создаваемого поста-
propsMap with string as a key,
any type value
Дополнения к посту-
goto_locationstringURL на который будет перенаправлен пользовательhttps://time-messenger.ru/
skip_slack_parsingboolУстановите значение true, чтобы пропустить обработку Текста с учетом совместимости со Slack.false
extra_responsesArray of this structИспользуется для ответа несколько раз за одно взаимодействие-