Docs
Wypróbuj

Webhook Discord

Webhook Discord to jedyny kanał alertów RankVoyager doręczany na zewnątrz aplikacji (poza opcjonalnym e-mailem dla alertów krytycznych). Wszystkie zdarzenia z Centrum Łączności lecą jako wiadomości na wskazany kanał Discord - zwykle dedykowany #monitoring na serwerze firmowym.

Dlaczego tylko Discord

Discord ma najprostszy, najlepiej udokumentowany webhook (POST z embedami) dostępny dla zwykłych użytkowników bez wymagania bota / OAuth. Aplikacja formatuje wiadomości jako Discord Embed - z kolorem zgodnym z typem alertu, tytułem, opisem, polami dla domeny i kodu błędu.

Pole webhook URL akceptuje też URL Slacka (https://hooks.slack.com/services/...), ale wiadomości w Slacku wyświetlą się jako surowy JSON embedu, nie jako natywne notyfikacje. To nie jest wspierany sposób użycia. Jeśli potrzebujesz Slacka - napisz do nas, planujemy osobne wsparcie.

Konfiguracja krok po kroku

Utwórz webhook w Discordzie

Na swoim serwerze Discord:

  1. Ustawienia serwera (kółko zębate obok nazwy serwera)
  2. Integracje → Webhooks → Nowy webhook
  3. Nazwij go (np. RankVoyager Alerts) i wybierz kanał (sugerujemy dedykowany #monitoring albo #alerts)
  4. Kliknij Kopiuj URL Webhooka - zostaje w schowku

Wklej URL w aplikacji

W RankVoyager: Konfiguracja → Powiadomienia. Wklej URL do pola URL webhooka.

URL powinien zacząć się od https://discord.com/api/webhooks/. Aplikacja zweryfikuje format od razu - jeśli zacznie się od czegoś innego, pokaże ostrzeżenie (ale i tak pozwoli zapisać, bo Slack ma swój format).

Wyślij wiadomość testową

Klik Wyślij test. Na wskazany kanał Discord powinna w ciągu 1–2 sekund spaść wiadomość:

✅ RankVoyager - test powiadomienia
Webhook jest poprawnie skonfigurowany.
Powiadomienia o incydentach będą trafiać na ten kanał.

Jeśli nic nie dostałeś - sprawdź czy:

  • kanał istnieje i nie został zarchiwizowany
  • serwer nie wymaga MFA do akcji administracyjnych
  • URL nie został obcięty przy kopiowaniu

Test można powtarzać tyle razy, ile chcesz.

Zapisz

Klik Zapisz. URL trafia do profilu (webhook_url) i od tej chwili wszystkie nowe alerty będą tu wysyłane.

Format wiadomości

Każdy alert leci jako Discord Embed z polami:

  • Tytuł - typ alertu + skrócony opis (np. ”🔴 Strona offline: example.com”)
  • Kolor - czerwony / pomarańczowy / żółty / niebieski w zależności od priorytetu
  • Pole „Domena” - z którą stroną wiązany jest alert
  • Pole „Szczegóły” - kod HTTP, czas trwania, wartość TTFB itp. zależnie od typu
  • Stopka - link do pełnego widoku alertu w aplikacji

Wiadomości testowe (przycisk Wyślij test) mają kolor zielony i tekst znaczący że to test.

Co kontroluje, czy alert poleci

Trzy poziomy:

  1. Globalnie - czy webhook jest w ogóle ustawiony w profilu (webhook_url IS NOT NULL).
  2. Per okno serwisowe - jeśli strona jest w aktywnym oknie serwisowym (zob. Flota), alert nie poleci.
  3. Per typ - wszystkie typy alertów lecą domyślnie. Filtrowanie per typ jest na razie tylko po stronie kanału Discord (np. dedykowany kanał na competitor_change).

Wiadomości Discord mają limit 30 wiadomości / minutę na webhook (limit od strony Discord, nie nasz). Jeśli kilkanaście Twoich stron jednocześnie pójdzie offline (np. przy padzie DNS), alerty mogą się delikatnie opóźnić, ale nie zgubią się - kolejkujemy je po stronie naszej funkcji webhook-notifier.

Wyłączenie webhooka

W Konfiguracji → Powiadomienia wyczyść pole URL i kliknij Zapisz. Od tej chwili żaden alert nie poleci na Discorda. Alerty dalej zapisywane są w aplikacji (i widoczne w Centrum Łączności) - wyłączenie webhooka to tylko wyłączenie zewnętrznego doręczenia.

Bezpieczeństwo URL

URL webhooka Discord jest tajny - kto go zna, może wysyłać wiadomości na Twój kanał. Aplikacja przechowuje go zaszyfrowanego w bazie i nie pokazuje w pełni w UI (pokaże tylko początek). Jeśli URL wyciekł - w Discordzie usuń webhook (Ustawienia serwera → Integracje → Webhooks → Usuń) i utwórz nowy.