Слеш-команды: свои команды в поле сообщения
Как добавить команду вида /deploy, которая отправляет запрос на ваш адрес и публикует ответ в канале.
Слеш-команда — это слово со знаком «/» в начале, которое вы пишете в поле сообщения в канале: /deploy, /report. После неё можно добавить текст. Syncra отправляет команду вашему сервису, а ответ публикует в канале от имени бота. Так команда может запускать выкладку, показывать статус или искать заказ прямо из чата.
Добавляют команды владелец и администратор рабочего пространства. Команда привязана к боту, поэтому сначала нужен бот.
Как добавить команду
- Откройте настройки рабочего пространства, вкладку «Боты», страницу бота.
- В разделе «Слеш-команды» введите «Команда». Допустимы строчные латинские буквы, цифры, «-» и «_», до 32 символов. Знак «/» уже стоит перед полем, имя вводите без него.
- Если нужно, заполните «Описание (необязательно)»: оно объясняет, что делает команда.
- В поле «Адрес запроса (необязательно)» вставьте адрес вашего сервиса.
- Нажмите «Добавить команду».
Команда появится у всех участников рабочего пространства в списке команд, который открывается, когда в поле сообщения набирают «/». Её можно временно выключить переключателем в строке команды, а кнопка «Удалить» убирает её у всех без возможности отмены.
Имена /shrug, /me, /tableflip, /unflip и /help заняты встроенными командами. Имя, которое уже используется в рабочем пространстве, повторно взять нельзя.
Что получит ваш сервис
Syncra отправит POST-запрос с JSON: команда, текст после неё, канал, рабочее пространство, имя и идентификатор участника, который вызвал команду, и данные бота. Заголовки те же три, что у подписок на события, в X-Syncra-Event стоит slash.command. Подпись проверяется так же, как описано в статье «Подписки на события». Секрет у команды свой: нажмите «Показать» рядом с «Секрет подписи».
Что ответить
Верните JSON вида {"text":"Выкладка запущена"}. Syncra опубликует этот текст в канале от имени бота, обрезав его до 4000 символов. Ответ нужен в течение 5 секунд. Повторных попыток нет.
Если адрес не указан
Если оставить адрес пустым и у бота включены «Ответы ИИ», команду обработает ИИ бота. Если адреса нет и ИИ у бота выключен, команда не сработает.
Чего нет
- Отложенных ответов: ответить надо сразу.
- Ответов, которые видит только вызвавший.
- Кнопок и других интерактивных элементов в ответе.
- Повторной отправки: если ваш адрес не ответил за 5 секунд или ответил ошибкой, команда завершится ошибкой.
Что ещё почитать
Обновлено: