Webhooki Discorda
Dołączona do Macro DeckPublikuj rozbudowane wiadomości z embedami i wzmiankami na kanałach Discorda przez webhooki, z podglądem na żywo.
Okno Dodaj webhook Discorda z polami Nazwa i URL webhooka
- Zapisywanie webhooków pod nazwą, po jednym na kanał
- Edytor wizualny z podglądem wyglądającym jak Discord
- Do 10 embedów z polami, obrazami, autorem i stopką
- Wzmianki nikogo nie powiadamiają bez wyraźnej zgody
- Zmienne szablonów są wypełniane przy uruchomieniu akcji
Webhook Discorda pozwala publikować na jednym kanale Discorda wszystkiemu, co zna jego URL. Integracja Webhooki Discorda zapisuje webhooki pod nazwą i udostępnia jedną akcję, Wyślij wiadomość przez webhook Discorda, z edytorem wizualnym wiadomości. Nie wymaga aplikacji Discord ani konta Discord na komputerze, na którym działa Macro Deck.
Co można wysłać
Edytor ma cztery karty:
- Wiadomość: tekst wiadomości z formatowaniem Markdown Discorda i podziałami wierszy oraz przyciski wstawiające wzmiankę użytkownika lub roli,
@everyonealbo@here. - Embedy: do 10 embedów, każdy z tytułem i linkiem tytułu, opisem, kolorem, znacznikiem czasu, autorem, stopką, obrazem, miniaturą i maksymalnie 25 polami, które mogą być wyświetlane obok siebie.
- Profil: nazwa użytkownika i awatar dla tej wiadomości zamiast tych z webhooka.
- Wzmianki: kto może zostać powiadomiony przez wzmianki w wiadomości.
Domyślnie wiadomość nikogo nie powiadamia, nawet jeśli wspomina kogoś, @everyone lub @here. Wzmianka nadal jest widoczna w Discordzie, po prostu nie wysyła powiadomienia. Wszystkie pola tekstowe przyjmują zmienne szablonów, wypełniane przy uruchomieniu akcji, więc wiadomość może zawierać bieżącą scenę, utwór lub liczbę widzów.
Podgląd pod edytorem zmienia się podczas pisania i pokazuje wiadomość tak, jak rysuje ją Discord. Nigdy niczego nie wysyła do Discorda. Obrazy są pokazywane jako symbole zastępcze, a zmienne w takiej postaci, w jakiej je wpisano. Wyślij wiadomość testową po potwierdzeniu przyciskiem Wyślij teraz od razu wysyła wiadomość do Discorda, aby można było sprawdzić, jak naprawdę wygląda.
Przykładowe zastosowania:
- Przycisk Start transmisji, który publikuje embed z tytułem i linkiem do streamu na kanale ogłoszeń.
- Przycisk, który publikuje odtwarzany utwór na kanale muzycznym.
- Automatyzacja, która wysyła wiadomość na kanał moderatorów, gdy coś dzieje się na streamie.
Zapisane webhooki i własne adresy URL
Dodaj jedną konfigurację na kanał, a następnie wybieraj webhook po nazwie w każdej akcji. Gdy URL się zmieni, zmienia się go w jednym miejscu. Dla jednorazowej wiadomości można też ustawić Webhook na Własny URL i wkleić URL w akcji. Macro Deck przechowuje każdy URL webhooka w postaci zaszyfrowanej, nigdy więcej go nie pokazuje i nigdy nie zapisuje go w dzienniku.
Przed wysłaniem Macro Deck sprawdza limity Discorda, na przykład 2000 znaków tekstu wiadomości i 6000 znaków we wszystkich embedach razem, i podczas edycji wyświetla ewentualne problemy nad podglądem. Gdy Discord ogranicza częstotliwość publikowania przez webhook, Macro Deck czeka i próbuje jeszcze raz, jeśli czas oczekiwania wynosi 5 sekund lub mniej.
Czego potrzebujesz
- Macro Deck 3 w systemie Windows, macOS lub Linux
- Połączenie z internetem na komputerze, na którym działa Macro Deck
- Kanał Discorda z uprawnieniem do zarządzania webhookami oraz URL jego webhooka
Konfiguracja krok po kroku
Krok 1: Utwórz webhook w Discordzie
W Discordzie otwórz ustawienia kanału, przejdź do Integracje, a potem Webhooki, i utwórz webhook lub wybierz istniejący. Kliknij Kopiuj URL webhooka. URL zaczyna się od
https://discord.com/api/webhooks/. Każdy, kto go zna, może publikować na kanale, więc traktuj go jak hasło.Krok 2: Otwórz Webhooki Discorda w Macro Deck
W Macro Deck kliknij Integracje na pasku bocznym, a następnie Webhooki Discorda. Na karcie Przegląd kliknij Dodaj konfigurację w sekcji Konfiguracja. Włączenie przełącznika w prawym górnym rogu otwiera to samo okno.
Krok 3: Zapisz webhook
Wypełnij okno Dodaj webhook Discorda:
- Nazwa: wyświetlana przy wyborze webhooka w akcji, np. nazwa kanału.
- URL webhooka: URL skopiowany w Discordzie.
Kliknij Dalej. Dodaj konfigurację dla każdego kolejnego kanału.
Krok 4: Dodaj akcję do przycisku
Na stronie Deck kliknij przycisk, którego chcesz użyć. Deck musi być odblokowany: gdy przycisk w prawym górnym rogu pokazuje Zablokuj, jest odblokowany. Otworzy się edytor z zaznaczonym Krótkie naciśnięcie. Kliknij + Dodaj akcję, po lewej stronie okna Dodaj akcję wybierz Webhooki Discorda i wybierz Wyślij wiadomość przez webhook Discorda.
Krok 5: Napisz wiadomość
Wybierz zapisany webhook w polu Webhook. Wpisz Tekst wiadomości na karcie Wiadomość i w razie potrzeby dodaj embedy na karcie Embedy. Sprawdź podgląd, a następnie kliknij Wyślij wiadomość testową i Wyślij teraz, aby zobaczyć wiadomość w Discordzie.
Krok 6: Naciśnij przycisk
Naciśnij przycisk na telefonie, tablecie lub w kliencie webowym. Wiadomość pojawi się na kanale Discorda z wypełnionymi zmiennymi. Jeśli tak się nie stanie, akcja pokaże przyczynę, na przykład że Discord odrzucił token webhooka.
Akcje1
Przypisz je do przycisku lub uruchamiaj w przebiegu.
- Wyślij wiadomość przez webhook Discorda
- Wysyła wiadomość z opcjonalnymi embedami przez zapisany lub własny webhook Discorda, edytowaną z podglądem na żywo.
Najczęściej zadawane pytania
Jak wspomnieć użytkownika lub rolę?
Wzmianka wymaga identyfikatora Discord. W Discordzie włącz Tryb dewelopera w ustawieniach zaawansowanych, a następnie kliknij prawym przyciskiem myszy użytkownika lub rolę i wybierz Kopiuj ID. Na karcie Wzmianki wybierz, czy powiadamiany jest nikt, wszyscy wspomniani, czy tylko podane identyfikatory.
Czym różni się to od integracji Discord?
Integracja Discord ma starszą akcję Wykonaj webhook z jednym embedem i bez podglądu. Nadal działa. Webhooki Discorda dodają wiele embedów, kontrolę wzmianek, profil dla każdej wiadomości i podgląd na żywo.
Gdzie jest przechowywany URL webhooka?
Macro Deck przechowuje go w postaci zaszyfrowanej na komputerze, na którym działa Macro Deck. Nigdy więcej nie jest wyświetlany, nigdy nie trafia do dziennika i nigdy nie jest częścią podglądu. Aby go zmienić, wpisz go ponownie. Akceptowane są tylko adresy webhooków Discorda w domenach discord.com, discordapp.com, ptb.discord.com i canary.discord.com.
Dlaczego zmienna nie jest wypełniona w wiadomości testowej?
Wyślij wiadomość testową wysyła zmienne w takiej postaci, w jakiej je wpisano. Są one wypełniane dopiero wtedy, gdy akcja zostanie uruchomiona z przycisku, automatyzacji lub skryptu.
Dlaczego akcja kończy się błędem?
Akcja pokazuje przyczynę, na przykład że wiadomość jest pusta lub za długa, że webhook nie istnieje już w Discordzie, że Discord odrzucił token webhooka albo że Discord ogranicza częstotliwość webhooka. Jeśli token został odrzucony, skopiuj ponownie URL webhooka i wpisz go w konfiguracji.
Czy można edytować wiadomość w aplikacji Companion?
Aplikacja Companion i starsze aplikacje na komputer pokazują proste ustawienia akcji, z wiadomością w postaci kluczy i wartości, takich jak content i embeds.0.title, i nie zapisują zmian wprowadzonych w edytorze wizualnym. Rozbudowane wiadomości edytuj w aktualnej aplikacji na komputer.