Вебхуки Discord
Входить до Macro DeckПублікуйте в каналах Discord оформлені повідомлення з вбудовуваннями та згадками через вебхуки, з живим попереднім переглядом.
Діалог «Додати вебхук Discord» з полями «Назва» й «URL вебхука»
- Вебхуки зберігаються під назвою, по одному на канал
- Візуальний редактор із попереднім переглядом, як у Discord
- До 10 вбудовувань із полями, зображеннями, автором і нижнім колонтитулом
- Згадки нікого не сповіщають, доки ви цього не дозволите
- Змінні шаблонів підставляються під час виконання дії
Вебхук Discord дає змогу будь-чому, що знає його URL, публікувати повідомлення в один канал Discord. Інтеграція «Вебхуки Discord» зберігає вебхуки під назвою і пропонує одну дію, Надіслати повідомлення через вебхук Discord, з візуальним редактором повідомлення. Їй не потрібні ні застосунок Discord, ні обліковий запис Discord на комп’ютері, де працює Macro Deck.
Що можна надіслати
У редакторі чотири вкладки:
- Повідомлення: текст повідомлення з Markdown Discord і переносами рядків, а також кнопки, що вставляють згадку користувача чи ролі,
@everyoneабо@here. - Вкладення: до 10 вбудовувань, кожне із заголовком і посиланням заголовка, описом, кольором, позначкою часу, автором, нижнім колонтитулом, зображенням, мініатюрою і до 25 полями, які можна показувати поруч.
- Профіль: ім’я користувача й аватар для цього повідомлення замість власних у вебхука.
- Згадки: кого можуть сповіщати згадки в повідомленні.
Типово повідомлення нікого не сповіщає, навіть якщо в ньому згадано когось, @everyone або @here. Згадка все одно показується в Discord, просто без сповіщення. Усі текстові поля приймають змінні шаблонів, які підставляються під час виконання дії, тож повідомлення може містити поточну сцену, пісню чи кількість глядачів.
Попередній перегляд під редактором змінюється під час введення й показує повідомлення так, як його відобразить Discord. Він ніколи нічого не надсилає в Discord. Зображення показано як заповнювачі, а змінні так, як ви їх написали. Надіслати тестове повідомлення одразу надсилає повідомлення в Discord після підтвердження кнопкою Надіслати зараз, щоб ви могли перевірити, як воно виглядає насправді.
Кілька прикладів:
- Кнопка Трансляція почалася, що публікує в канал оголошень вбудовування з назвою та посиланням вашої трансляції.
- Кнопка, що публікує пісню, яка зараз грає, у музичний канал.
- Автоматизація, що надсилає повідомлення в канал модераторів, коли на вашій трансляції щось відбувається.
Збережені вебхуки та власні URL
Додайте по одному налаштуванню на канал, а потім вибирайте вебхук за назвою в кожній дії. Коли URL змінюється, ви змінюєте його в одному місці. Для разового повідомлення можна також вибрати в полі Вебхук значення Власний URL і вставити URL просто в дію. Macro Deck зберігає кожен URL вебхука в зашифрованому вигляді, більше ніколи його не показує і ніколи не записує в журнал.
Перед надсиланням Macro Deck перевіряє обмеження Discord, наприклад 2000 символів тексту повідомлення і 6000 символів в усіх вбудовуваннях разом, і вже під час редагування перелічує проблеми над попереднім переглядом. Коли Discord обмежує, як часто вебхук може публікувати, Macro Deck чекає й пробує ще раз, якщо очікування триває не більше 5 секунд.
Що потрібно
- Macro Deck 3 на Windows, macOS або Linux
- Підключення до інтернету на комп’ютері, де працює Macro Deck
- Канал Discord, у якому ви можете керувати вебхуками, і URL його вебхука
Як налаштувати
Крок 1: Створіть вебхук у Discord
У Discord відкрийте налаштування каналу, перейдіть до Integrations, потім до Webhooks і створіть вебхук або виберіть наявний. Натисніть Copy Webhook URL. URL починається з
https://discord.com/api/webhooks/. Будь-хто, хто його має, може публікувати в канал, тож поводьтеся з ним як із паролем.Крок 2: Відкрийте «Вебхуки Discord» у Macro Deck
У Macro Deck натисніть Інтеграції на бічній панелі, а потім Вебхуки Discord. На вкладці Огляд натисніть Додати налаштування в розділі Конфігурація. Перемикач угорі праворуч відкриває той самий діалог.
Крок 3: Збережіть вебхук
Заповніть діалог Додати вебхук Discord:
- Назва: показується, коли ви вибираєте вебхук у дії, наприклад назва каналу.
- URL вебхука: URL, який ви скопіювали в Discord.
Натисніть Продовжити. Для кожного наступного каналу додайте окреме налаштування.
Крок 4: Додайте дію на кнопку
На сторінці Панель клацніть кнопку, яку хочете використати. Панель має бути розблокована: якщо на кнопці вгорі праворуч написано Заблокувати, її розблоковано. Відкриється редактор, у якому вибрано Коротке натискання. Натисніть + Додати дію, ліворуч у діалозі Додати дію виберіть Вебхуки Discord і виберіть Надіслати повідомлення через вебхук Discord.
Крок 5: Напишіть повідомлення
Виберіть збережений вебхук у полі Вебхук. Напишіть Текст повідомлення на вкладці Повідомлення і за бажанням додайте вбудовування на вкладці Вкладення. Перевірте попередній перегляд, потім натисніть Надіслати тестове повідомлення і Надіслати зараз, щоб побачити повідомлення в Discord.
Крок 6: Натисніть кнопку
Натисніть кнопку на телефоні, планшеті або у вебклієнті. Повідомлення з’явиться в каналі Discord з підставленими змінними. Якщо ні, дія покаже причину, наприклад що Discord відхилив токен вебхука.
Дії1
Призначте їх кнопці або запускайте з потоку.
- Надіслати повідомлення через вебхук Discord
- Надсилає повідомлення з необов’язковими вбудовуваннями через збережений або власний вебхук Discord; редагується з живим попереднім переглядом.
Поширені запитання
Як згадати користувача чи роль?
Для згадки потрібен ID у Discord. У Discord увімкніть Developer Mode у розширених налаштуваннях, потім клацніть правою кнопкою миші користувача чи роль і виберіть Copy ID. На вкладці Згадки виберіть, чи не сповіщається ніхто, усі згадані чи лише ID, які ви перелічите.
Чим це відрізняється від інтеграції Discord?
Інтеграція Discord має старішу дію Виконати вебхук з одним вбудовуванням і без попереднього перегляду. Вона й далі працює. «Вебхуки Discord» додають кілька вбудовувань, керування згадками, профіль для кожного повідомлення і живий попередній перегляд.
Де зберігається 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, і не зберігають змін, зроблених у візуальному редакторі. Редагуйте оформлені повідомлення в поточному застосунку для ПК.
