Webhooky Discordu
Součást Macro DeckPosílejte do kanálů na Discordu bohaté zprávy s embedy a zmínkami přes webhooky, s živým náhledem.
Dialog Přidat webhook Discordu s poli Název a URL webhooku
- Webhooky uložené pod názvem, jeden pro každý kanál
- Vizuální editor s náhledem, který vypadá jako Discord
- Až 10 embedů s poli, obrázky, autorem a zápatím
- Zmínky nikoho neupozorní, pokud to nepovolíte
- Proměnné šablon se doplní při spuštění akce
Webhook Discordu umožňuje čemukoli, co zná jeho URL, posílat příspěvky do jednoho kanálu na Discordu. Integrace Webhooky Discordu ukládá webhooky pod názvem a nabízí jednu akci, Odeslat zprávu přes webhook Discordu, s vizuálním editorem zprávy. Na počítači, na kterém běží Macro Deck, nepotřebuje aplikaci Discord ani účet Discord.
Co můžete posílat
Editor má čtyři karty:
- Zpráva: text zprávy s Markdownem Discordu a zalomením řádků a k tomu tlačítka, která vloží zmínku uživatele nebo role,
@everyonenebo@here. - Embedy: až 10 embedů, každý s nadpisem a odkazem nadpisu, popisem, barvou, časovým razítkem, autorem, zápatím, obrázkem, miniaturou a až 25 poli, která lze zobrazit vedle sebe.
- Profil: uživatelské jméno a avatar pro tuto zprávu místo vlastních údajů webhooku.
- Zmínky: koho mohou zmínky ve zprávě upozornit.
Ve výchozím stavu zpráva nikoho neupozorní, ani když někoho zmiňuje, @everyone nebo @here. Zmínka se v Discordu stále zobrazí, jen nikoho neupozorní. Všechna textová pole přijímají proměnné šablon, které se doplní při spuštění akce, takže zpráva může nést aktuální scénu, skladbu nebo počet diváků.
Náhled pod editorem se mění při psaní a ukazuje zprávu tak, jak ji vykreslí Discord. Nikdy nic neposílá do Discordu. Obrázky se zobrazují jako zástupné symboly a proměnné tak, jak jste je napsali. Odeslat testovací zprávu pošle zprávu do Discordu ihned poté, co potvrdíte tlačítkem Odeslat nyní, takže si můžete ověřit, jak opravdu vypadá.
Několik příkladů použití:
- Tlačítko Stream běží, které do kanálu s oznámeními pošle embed s názvem a odkazem vašeho streamu.
- Tlačítko, které do hudebního kanálu pošle právě hrající skladbu.
- Automatizace, která pošle zprávu do kanálu moderátorů, když se na vašem streamu něco stane.
Uložené webhooky a vlastní URL
Přidejte jednu konfiguraci pro každý kanál a pak v každé akci vyberte webhook podle jeho názvu. Když se URL změní, změníte ji na jednom místě. Pro jednorázovou zprávu můžete také nastavit Webhook na Vlastní URL a vložit URL přímo do akce. Macro Deck ukládá každou URL webhooku šifrovaně, už ji nikdy nezobrazí a nikdy ji nezapíše do protokolu.
Macro Deck před odesláním kontroluje limity Discordu, například 2000 znaků textu zprávy a 6000 znaků ve všech embedech dohromady, a případné problémy vypisuje nad náhledem už při úpravách. Když Discord omezí, jak často smí webhook posílat, Macro Deck počká a zkusí to ještě jednou, pokud čekání trvá nejvýše 5 sekund.
Co budete potřebovat
- Macro Deck 3 na Windows, macOS nebo Linuxu
- Připojení k internetu na počítači, na kterém běží Macro Deck
- Kanál na Discordu, ve kterém smíte spravovat webhooky, a jeho URL webhooku
Nastavení
Krok 1: Vytvořte webhook v Discordu
V Discordu otevřete nastavení kanálu, přejděte na Integrations a pak na Webhooks a vytvořte webhook nebo vyberte existující. Klikněte na Copy Webhook URL. URL začíná na
https://discord.com/api/webhooks/. Kdokoli, kdo ji má, může do kanálu posílat příspěvky, proto s ní zacházejte jako s heslem.Krok 2: Otevřete Webhooky Discordu v Macro Deck
V Macro Deck klikněte na postranním panelu na Integrace a pak na Webhooky Discordu. Na kartě Přehled klikněte v části Konfigurace na Přidat konfiguraci. Stejný dialog otevře i přepínač vpravo nahoře.
Krok 3: Uložte webhook
Vyplňte dialog Přidat webhook Discordu:
- Název: zobrazí se při výběru webhooku v akci, například název kanálu.
- URL webhooku: URL, kterou jste zkopírovali v Discordu.
Klikněte na Pokračovat. Pro každý další kanál přidejte jednu konfiguraci.
Krok 4: Přidejte akci na tlačítko
Na stránce Deck klikněte na tlačítko, které chcete použít. Deck musí být odemčený: když tlačítko vpravo nahoře ukazuje Uzamknout, je odemčený. Otevře se editor s vybranou možností Krátké stisknutí. Klikněte na + Přidat akci, v dialogu Přidat akci vlevo vyberte Webhooky Discordu a zvolte Odeslat zprávu přes webhook Discordu.
Krok 5: Napište zprávu
V poli Webhook vyberte uložený webhook. Na kartě Zpráva napište Text zprávy a podle potřeby přidejte na kartě Embedy embedy. Zkontrolujte náhled a pak klikněte na Odeslat testovací zprávu a Odeslat nyní, abyste zprávu viděli v Discordu.
Krok 6: Stiskněte tlačítko
Stiskněte tlačítko v telefonu, tabletu nebo ve webovém klientovi. Zpráva se objeví v kanálu na Discordu s doplněnými proměnnými. Pokud ne, akce ukáže důvod, například že Discord odmítl token webhooku.
Akce1
Umístěte je na tlačítko nebo je spusťte z postupu.
- Odeslat zprávu přes webhook Discordu
- Pošle zprávu s volitelnými embedy přes uložený nebo vlastní webhook Discordu, upravovanou s živým náhledem.
Často kladené dotazy
Jak zmíním uživatele nebo roli?
Zmínka potřebuje ID z Discordu. V Discordu zapněte v pokročilém nastavení Developer Mode, pak klikněte pravým tlačítkem na uživatele nebo roli a zvolte Copy ID. Na kartě Zmínky zvolte, zda se neupozorní nikdo, všichni zmínění, nebo jen ID, která uvedete.
Jaký je rozdíl oproti integraci Discord?
Integrace Discord má starší akci Spustit webhook s jedním embedem a bez náhledu. Ta dál funguje. Webhooky Discordu přidávají více embedů, řízení zmínek, profil pro každou zprávu a živý náhled.
Kde je URL webhooku uložená?
Macro Deck ji ukládá šifrovaně na počítači, na kterém běží. Už se nikdy nezobrazí, nikdy se nezapíše do protokolu a nikdy není součástí náhledu. Chcete-li ji změnit, zadejte ji znovu. Přijímají se jen adresy webhooků Discordu na discord.com, discordapp.com, ptb.discord.com a canary.discord.com.
Proč se v testovací zprávě nedoplní proměnná?
Odeslat testovací zprávu posílá proměnné tak, jak jsou napsané. Doplní se jen tehdy, když akce běží z tlačítka, automatizace nebo skriptu.
Proč akce selže?
Akce ukáže důvod, například že je zpráva prázdná nebo příliš dlouhá, že webhook v Discordu už neexistuje, že Discord odmítl token webhooku, nebo že Discord webhook omezuje. Pokud byl token odmítnut, zkopírujte URL webhooku znovu a zadejte ji do konfigurace.
Můžu zprávu upravit v aplikaci Companion?
Aplikace Companion a starší desktopové aplikace ukazují jen základní nastavení akce, se zprávou jako klíči a hodnotami, například content a embeds.0.title, a neukládají změny provedené ve vizuálním editoru. Bohaté zprávy upravujte v aktuální desktopové aplikaci.
