Сменить разделСвой ИИ и интеграции

Слеш-команды: свои команды в поле сообщения

Как добавить команду вида /deploy, которая отправляет запрос на ваш адрес и публикует ответ в канале.

Слеш-команда — это слово со знаком «/» в начале, которое вы пишете в поле сообщения в канале: /deploy, /report. После неё можно добавить текст. Syncra отправляет команду вашему сервису, а ответ публикует в канале от имени бота. Так команда может запускать выкладку, показывать статус или искать заказ прямо из чата.

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

Как добавить команду

  1. Откройте настройки рабочего пространства, вкладку «Боты», страницу бота.
  2. В разделе «Слеш-команды» введите «Команда». Допустимы строчные латинские буквы, цифры, «-» и «_», до 32 символов. Знак «/» уже стоит перед полем, имя вводите без него.
  3. Если нужно, заполните «Описание (необязательно)»: оно объясняет, что делает команда.
  4. В поле «Адрес запроса (необязательно)» вставьте адрес вашего сервиса.
  5. Нажмите «Добавить команду».

Команда появится у всех участников рабочего пространства в списке команд, который открывается, когда в поле сообщения набирают «/». Её можно временно выключить переключателем в строке команды, а кнопка «Удалить» убирает её у всех без возможности отмены.

Имена /shrug, /me, /tableflip, /unflip и /help заняты встроенными командами. Имя, которое уже используется в рабочем пространстве, повторно взять нельзя.

Что получит ваш сервис

Syncra отправит POST-запрос с JSON: команда, текст после неё, канал, рабочее пространство, имя и идентификатор участника, который вызвал команду, и данные бота. Заголовки те же три, что у подписок на события, в X-Syncra-Event стоит slash.command. Подпись проверяется так же, как описано в статье «Подписки на события». Секрет у команды свой: нажмите «Показать» рядом с «Секрет подписи».

Что ответить

Верните JSON вида {"text":"Выкладка запущена"}. Syncra опубликует этот текст в канале от имени бота, обрезав его до 4000 символов. Ответ нужен в течение 5 секунд. Повторных попыток нет.

Если адрес не указан

Если оставить адрес пустым и у бота включены «Ответы ИИ», команду обработает ИИ бота. Если адреса нет и ИИ у бота выключен, команда не сработает.

Чего нет

  • Отложенных ответов: ответить надо сразу.
  • Ответов, которые видит только вызвавший.
  • Кнопок и других интерактивных элементов в ответе.
  • Повторной отправки: если ваш адрес не ответил за 5 секунд или ответил ошибкой, команда завершится ошибкой.

Что ещё почитать

Обновлено:

Другие статьи в разделе «Свой ИИ и интеграции»

Вернуться к категории

Не нашли ответ?

Напишите нам в Telegram. Отвечает человек из команды Syncra.

Написать в Telegram