Вебхуки Discord
Входит в Macro DeckПубликуйте в каналах Discord оформленные сообщения с embed-блоками и упоминаниями через вебхуки, с живым предпросмотром.
Диалог «Добавить вебхук Discord» с полями «Имя» и «URL вебхука»
- Вебхуки сохраняются под именем, по одному на канал
- Визуальный редактор с предпросмотром, как в Discord
- До 10 embed-блоков с полями, изображениями, автором и подвалом
- Упоминания никого не уведомляют, пока вы это не разрешите
- Переменные шаблонов подставляются при выполнении действия
Вебхук Discord позволяет всему, что знает его URL, публиковать сообщения в один канал Discord. Интеграция «Вебхуки Discord» сохраняет вебхуки под именем и предлагает одно действие, Отправить сообщение через вебхук Discord, с визуальным редактором сообщения. Ей не нужны ни приложение Discord, ни аккаунт Discord на компьютере, где работает Macro Deck.
Что можно отправить
В редакторе четыре вкладки:
- Сообщение: текст сообщения с Markdown Discord и переносами строк, а также кнопки, которые вставляют упоминание пользователя или роли,
@everyoneили@here. - Вложения: до 10 embed-блоков, у каждого заголовок и ссылка заголовка, описание, цвет, отметка времени, автор, подвал, изображение, миниатюра и до 25 полей, которые можно показывать рядом.
- Профиль: имя пользователя и аватар для этого сообщения вместо собственных у вебхука.
- Упоминания: кого могут уведомлять упоминания в сообщении.
По умолчанию сообщение никого не уведомляет, даже если в нём упомянут кто-то, @everyone или @here. Упоминание всё равно отображается в Discord, просто без уведомления. Все текстовые поля принимают переменные шаблонов, которые подставляются при выполнении действия, поэтому сообщение может содержать текущую сцену, песню или число зрителей.
Предпросмотр под редактором меняется по мере ввода и показывает сообщение так, как его отрисует Discord. Он никогда ничего не отправляет в Discord. Изображения показываются как заглушки, а переменные так, как вы их написали. Отправить тестовое сообщение сразу отправляет сообщение в Discord после подтверждения кнопкой Отправить сейчас, чтобы вы могли проверить, как оно выглядит на самом деле.
Несколько примеров:
- Кнопка Мы в эфире, которая публикует в канал объявлений embed-блок с названием и ссылкой вашей трансляции.
- Кнопка, которая публикует играющую сейчас песню в музыкальный канал.
- Автоматизация, которая отправляет сообщение в канал модераторов, когда на трансляции что-то происходит.
Сохранённые вебхуки и свои URL
Добавьте по одной настройке на канал, а затем выбирайте вебхук по имени в каждом действии. Если URL изменится, вы меняете его в одном месте. Для разового сообщения можно также выбрать в поле Вебхук значение Свой URL и вставить URL прямо в действие. Macro Deck хранит каждый URL вебхука в зашифрованном виде, больше никогда его не показывает и никогда не записывает в журнал.
Перед отправкой Macro Deck проверяет ограничения Discord, например 2000 символов текста сообщения и 6000 символов во всех embed-блоках вместе, и прямо во время редактирования перечисляет проблемы над предпросмотром. Если Discord ограничивает частоту публикаций вебхука, Macro Deck ждёт и пробует ещё раз, если ожидание занимает не больше 5 секунд.
Что понадобится
- Macro Deck 3 на Windows, macOS или Linux
- Подключение к интернету на компьютере, где работает Macro Deck
- Канал Discord, в котором вы можете управлять вебхуками, и URL его вебхука
Настройка
Шаг 1: Создайте вебхук в Discord
В Discord откройте настройки канала, перейдите в Интеграции, затем в Вебхуки и создайте вебхук или выберите существующий. Нажмите Копировать URL вебхука. URL начинается с
https://discord.com/api/webhooks/. Любой, у кого он есть, может публиковать сообщения в канал, поэтому обращайтесь с ним как с паролем.Шаг 2: Откройте «Вебхуки Discord» в Macro Deck
В Macro Deck нажмите Интеграции на боковой панели и выберите Вебхуки Discord. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог.
Шаг 3: Сохраните вебхук
Заполните диалог Добавить вебхук Discord:
- Имя: показывается при выборе вебхука в действии, например название канала.
- URL вебхука: URL, который вы скопировали в Discord.
Нажмите Продолжить. Для каждого следующего канала добавьте отдельную настройку.
Шаг 4: Добавьте действие на кнопку
На странице Панель нажмите на кнопку, которую хотите использовать. Панель должна быть разблокирована: если на кнопке в правом верхнем углу написано Заблокировать, она разблокирована. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите Вебхуки Discord и затем Отправить сообщение через вебхук Discord.
Шаг 5: Напишите сообщение
Выберите сохранённый вебхук в поле Вебхук. Напишите Текст сообщения на вкладке Сообщение и при желании добавьте embed-блоки на вкладке Вложения. Проверьте предпросмотр, затем нажмите Отправить тестовое сообщение и Отправить сейчас, чтобы увидеть сообщение в Discord.
Шаг 6: Нажмите кнопку
Нажмите кнопку на телефоне, планшете или в веб-клиенте. Сообщение появится в канале Discord с подставленными переменными. Если нет, действие покажет причину, например что Discord отклонил токен вебхука.
Действия1
Назначьте их на кнопку или запускайте из цепочки действий.
- Отправить сообщение через вебхук Discord
- Отправляет сообщение с необязательными embed-блоками через сохранённый или свой вебхук Discord; редактируется с живым предпросмотром.
Часто задаваемые вопросы
Как упомянуть пользователя или роль?
Для упоминания нужен ID в Discord. В Discord включите Режим разработчика в расширенных настройках, затем щёлкните правой кнопкой мыши по пользователю или роли и выберите Копировать ID. На вкладке Упоминания выберите, уведомляется ли никто, все упомянутые или только ID, которые вы перечислите.
Чем это отличается от интеграции Discord?
В интеграции Discord есть более старое действие Отправить вебхук с одним embed-блоком и без предпросмотра. Оно продолжает работать. «Вебхуки Discord» добавляют несколько embed-блоков, управление упоминаниями, профиль для каждого сообщения и живой предпросмотр.
Где хранится URL вебхука?
Macro Deck хранит его в зашифрованном виде на компьютере, где работает Macro Deck. Он больше никогда не показывается, никогда не записывается в журнал и никогда не входит в предпросмотр. Чтобы изменить его, введите его заново. Принимаются только адреса вебхуков Discord на discord.com, discordapp.com, ptb.discord.com и canary.discord.com.
Почему в тестовом сообщении не подставляется переменная?
Отправить тестовое сообщение отправляет переменные так, как они написаны. Они подставляются, только когда действие выполняется с кнопки, из автоматизации или скрипта.
Почему действие не выполняется?
Действие показывает причину, например что сообщение пустое или слишком длинное, что вебхука в Discord больше нет, что Discord отклонил токен вебхука или что Discord ограничивает частоту запросов вебхука. Если токен отклонён, скопируйте URL вебхука заново и введите его в настройке.
Можно ли редактировать сообщение в приложении Companion?
Приложение Companion и старые настольные приложения показывают простые параметры действия, с сообщением в виде ключей и значений, например content и embeds.0.title, и не сохраняют изменения, сделанные в визуальном редакторе. Редактируйте оформленные сообщения в текущем настольном приложении.
