glossary

Jak utworzyć webhook Discorda do automatycznego publikowania wiadomości

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •6 min czytania
Jak utworzyć webhook Discorda do automatycznego publikowania wiadomościJak utworzyć webhook Discorda do automatycznego publikowania wiadomości

TL;DR

6 min czytania

Webhook Discorda to adres URL w postaci `https://discord.com/api/webhooks/{id}/{token}`, który pozwala zewnętrznej usłudze opublikować wiadomość na jednym kanale przez wysłanie danych JSON, bez logowania bota. Dokumentacja dla deweloperów Discorda podaje, że wywołanie nie wymaga osobnego uwierzytelnienia, bo identyfikator i token w adresie URL same są danymi dostępowymi, dlatego ten adres trzeba traktować jak sekret. Globalny limit API Discorda to, według jego dokumentacji, 50 żądań na sekundę na aplikację.

Czym jest webhook Discorda?

Webhook Discorda to adres URL przypisany do kanału, który pozwala zewnętrznej usłudze opublikować na nim wiadomość przez wysłanie żądania HTTP, bez logowania się jako bot lub użytkownik. Dokumentacja dla deweloperów Discorda opisuje ten punkt końcowy jako POST /webhooks/{webhook.id}/{webhook.token} i stwierdza wprost: "this call does not require authentication", czyli wywołanie nie wymaga uwierzytelnienia, bo identyfikator i token webhooka zawarte w adresie URL same są danymi dostępowymi. Ten jeden fakt wyznacza większość tego, co zespół musi wiedzieć o konfiguracji: utworzenie webhooka to jednorazowy krok w Discordzie wymagający uprawnień, a późniejsze korzystanie z niego sprowadza się do wysłania danych JSON pod adres URL.

Jak utworzyć webhook Discorda w ustawieniach kanału?

Członek serwera z uprawnieniem do zarządzania webhookami (Manage Webhooks) tworzy webhook w ustawieniach kanału, na karcie Integracje, wybierając opcję nowego webhooka i kopiując wygenerowany przez Discorda adres URL. To samo można zrobić przez API Discorda za pomocą POST /channels/{channel.id}/webhooks, a dokumentacja podaje, że również wymaga to uprawnienia Manage Webhooks na tym kanale. Przed skopiowaniem adresu nazwij webhook i w razie potrzeby dodaj awatar, bo od tej chwili każdy, kto zna ten adres, może publikować na kanale.

Programista pisze na laptopie i przygotowuje dane JSON wysyłane w wywołaniu webhooka.

Jak wyglądają dane JSON webhooka Discorda?

Dane JSON webhooka Discorda to treść żądania wysyłanego pod jego adres URL. Musi ona zawierać co najmniej jeden z elementów: content, embeds, poll lub załącznik, bo dokumentacja Discorda wymienia to jako wymaganie wywołania webhooka. Pole content przenosi zwykły tekst wiadomości o długości do 2000 znaków, username i avatar_url zastępują domyślną nazwę i obraz webhooka tylko dla tej jednej wiadomości, a embeds przenosi do 10 bogato sformatowanych obiektów osadzonych w jednym wywołaniu. To standardowa treść żądania POST w formacie JSON: usługa buduje ten obiekt, wysyła go pod adres webhooka przez HTTPS, a Discord publikuje wynik na kanale, na którym webhook utworzono.

{
  "content": "Deployment finished",
  "username": "Release Bot",
  "avatar_url": "https://example.com/bot-avatar.png",
  "embeds": []
}
PoleTypUwagi
contentstringTekst wiadomości, do 2000 znaków
usernamestringZastępuje domyślną nazwę webhooka dla tej wiadomości
avatar_urlstringZastępuje domyślny awatar webhooka dla tej wiadomości
ttsbooleanWysyła wiadomość jako zamianę tekstu na mowę
embedsarrayDo 10 obiektów osadzonych na żądanie
allowed_mentionsobjectOkreśla, które wzmianki w wiadomości faktycznie powiadamiają ludzi

Jakie limity żądań obowiązują webhook Discorda?

Według dokumentacji dla deweloperów Discord stosuje globalny limit 50 żądań na sekundę na aplikację w całym API, a trasa webhooka ma osobny, węższy limit, który Discord komunikuje w nagłówkach odpowiedzi, a nie jako jedną opublikowaną liczbę. Każda odpowiedź zawiera nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset, a dokumentacja zaleca ich odczytywanie zamiast wpisywania limitu na stałe, bo limity dla tras są "subject to change", czyli mogą się zmienić. Usługa wysyłająca wiele wiadomości naraz powinna po każdym wywołaniu sprawdzać nagłówek z liczbą pozostałych żądań i wstrzymywać się, gdy spadnie on do zera, zamiast zakładać stałą liczbę wywołań na minutę.

Ikona kłódki nad ekranem laptopa symbolizuje poufność, jakiej wymaga adres URL webhooka.

Dlaczego adres URL webhooka Discorda jest sekretem?

Adres URL webhooka Discorda jest sekretem, bo identyfikator i token w nim zawarte stanowią całość danych dostępowych sprawdzanych przez punkt końcowy, a dokumentacja Discorda potwierdza, że wywołanie webhooka nie wymaga żadnego dodatkowego uwierzytelnienia. Każdy, kto ma ten adres, może opublikować na kanale dowolną wiadomość pod nazwą webhooka, nie logując się jako użytkownik ani bot. Przechowuj go tak jak klucz API, na przykład w zmiennej środowiskowej lub menedżerze sekretów, i nigdy nie umieszczaj go w publicznym repozytorium ani w skrypcie po stronie klienta.

Jak wiadomość trafia na kanał przez webhook Discorda
Członek serwera tworzy webhook w ustawieniach integracji kanału
Discord zwraca adres URL z identyfikatorem i tokenem webhooka
Zewnętrzna usługa wysyła dane JSON pod ten adres przez HTTPS
Discord publikuje wiadomość na kanale, bez logowania bota
Źródło: dokumentacja dla deweloperów Discorda dotycząca zasobu webhook i limitów API, stan na 9 września 2026.

Czy webhook Discorda może odbierać wiadomości, a nie tylko je wysyłać?

Standardowy webhook Discorda tylko wysyła wiadomości na kanał i nie może czytać tego, co publikują tam inni, bo punkt końcowy webhooka przyjmuje wyłącznie żądania POST i nie daje dostępu do odczytu. Zespół, który chce reagować na to, co dzieje się na serwerze Discord, podobnie jak przy dwukierunkowej integracji z Redditem, którą regulują limity API Reddita, potrzebuje bota Discorda z własnym tokenem i odpowiednimi uprawnieniami bramy. To inna konfiguracja niż webhook, bliższa temu, jak cennik API Twittera ogranicza dwukierunkowy dostęp do danych X, i należy do obszaru zbierania danych z mediów społecznościowych, a nie do powiadomień. Dla zespołu budującego pełnego bota kolejnym krokiem będzie przewodnik w stylu wprowadzenia do dokumentacji dla deweloperów.

Webhook czy bot: co sprawdzi się lepiej?
Webhook Discorda
  • Publikuje wiadomości na jednym kanale
  • Bez logowania bota i osobnego uwierzytelniania
  • Nie może czytać wiadomości publikowanych przez innych
Bot Discorda
  • Czyta wiadomości i odpowiada na polecenia
  • Wymaga własnego tokenu i uprawnień bramy
  • Może działać na wielu kanałach i serwerach
Webhook tylko wysyła wiadomości, a bot także słucha.

Najczęściej zadawane pytania

Czy mogę edytować lub usunąć wiadomość wysłaną webhookiem Discorda?

Tak. Gdy żądanie zawiera ?wait=true, odpowiedź Discorda zwraca identyfikator wiadomości, którego można użyć w osobnych punktach końcowych do edycji i usuwania przypisanych do tego samego webhooka. Bez wait=true pierwsze wywołanie nie zwraca obiektu wiadomości potrzebnego do późniejszej edycji.

Czy webhook Discorda wygasa?

Adres URL webhooka Discorda sam nie wygasa i działa, dopóki administrator serwera nie usunie webhooka lub kanału, do którego należy. Skoro nie wygasa samoczynnie, bezpieczniej traktować go jak stały sekret, a nie tymczasowy token.

Czy kilka usług może korzystać z tego samego adresu webhooka Discorda?

Tak, technicznie dowolna liczba usług może wysyłać żądania pod ten sam adres, bo Discord nie rozróżnia nadawców. W praktyce osobny webhook dla każdej usługi lub bota ułatwia ustalenie źródła wiadomości i pozwala odciąć jedną integrację bez psucia pozostałych.

Co się stanie, jeśli wyślę dane przekraczające limity Discorda?

Discord odrzuci żądanie z błędem, zamiast po cichu przyciąć treść, więc dane z ponad 2000 znaków w content lub ponad 10 obiektami w embeds powodują niepowodzenie wywołania. Sprawdzanie kodu statusu po każdym wywołaniu webhooka pozwala to wykryć, zanim okaże się, że wiadomość nigdy nie dotarła.

Czy utworzenie webhooka Discorda wymaga właściciela serwera?

Nie. Webhook może utworzyć każdy członek z uprawnieniem Manage Webhooks na danym kanale, a to uprawnienie można nadać roli, która nie jest właścicielem ani administratorem serwera. API Discorda stosuje to samo sprawdzenie uprawnień w punkcie końcowym POST /channels/{channel.id}/webhooks, który służy do tworzenia webhooków programowo.

Czy webhook Discorda to to samo co bot Discorda?

Nie. Webhook to jednokierunkowy adres URL do publikowania wiadomości na jednym kanale bez logowania, a bot to pełna aplikacja z własnym tokenem, która może czytać wiadomości, odpowiadać na polecenia i działać na wielu kanałach i serwerach. Projekt, który ma tylko wysyłać powiadomienia na jeden kanał, potrzebuje webhooka, a projekt, który ma słuchać i odpowiadać, potrzebuje bota.

Czy mogę skonfigurować webhook Discorda bez pisania kodu?

Samo utworzenie nie wymaga żadnego kodu: członek serwera z uprawnieniem Manage Webhooks otwiera kartę Integracje na kanale, tworzy nowy webhook i kopiuje wygenerowany adres URL. Nazwa i awatar są na tym etapie opcjonalne. Do faktycznego wysłania wiadomości potrzebny jest jednak jakiś sposób na wykonanie żądania HTTPS POST z treścią JSON, na przykład skrypt, narzędzie do automatyzacji albo usługa obsługująca JSON. Aby publikować nowe wzmianki z Reddita na kanale zupełnie bez skryptu, aplikacja RedReplier dla Zapiera uruchamia Zapa dla każdej wzmianki, co pokazuje przewodnik po Zapierze i Reddicie, a przepływ n8n dla Reddita robi to samo na twoim serwerze za pomocą węzła HTTP Request.

RedReplier
RedReplier

Rozpocznij

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Skąd mam wiedzieć, ile żądań zostało mi do limitu Discorda?

Discord nie publikuje stałej liczby dla trasy webhooka. Zamiast tego każda odpowiedź zawiera nagłówki X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset. Dokumentacja Discorda zaleca ich odczytywanie zamiast wpisywania limitu na stałe, bo limity dla tras mogą się zmieniać. Usługa wysyłająca wiele wiadomości naraz sprawdza po każdym wywołaniu nagłówek z liczbą pozostałych żądań i wstrzymuje się, gdy spadnie on do zera.

Czy wiadomość z webhooka może wyglądać, jakby pochodziła od kogoś innego?

Pola username i avatar_url w danych JSON zastępują domyślną nazwę i obraz webhooka, ale tylko dla tej jednej wiadomości. Nazwa i awatar ustawione przy tworzeniu webhooka pozostają bez zmian w pozostałych miejscach. Dzięki temu jeden webhook może opublikować alert o wdrożeniu jako „Release Bot”, a następnym razem pod inną nazwą, bez edytowania samego webhooka.

Co powstrzyma kogoś przed publikowaniem na moim kanale, jeśli zdobędzie adres webhooka?

Nic. Identyfikator i token w adresie URL to wszystkie dane dostępowe, które sprawdza Discord, więc każdy, kto ma ten adres, może opublikować na kanale dowolną wiadomość pod nazwą webhooka, bez logowania jako użytkownik lub bot. Dlatego adres traktuje się jak klucz API: przechowuj go w zmiennej środowiskowej lub menedżerze sekretów i nigdy nie umieszczaj w publicznym repozytorium ani w kodzie po stronie klienta.

Więcej naszych treści w Google

Jedno kliknięcie oznacza RedReplier jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

RedReplier

RedReplier

Żaden kupujący pytający o ofertę nie umknie

RedReplier śledzi Reddita, X, Bluesky i Hacker News w czasie rzeczywistym, ocenia każdy wątek pod kątem intencji zakupowej i przygotowuje odpowiedź, by dotrzeć tam jako pierwszy.

Reddit, X, Bluesky i HN

Alerty o intencjach w czasie rzeczywistym

Nielimitowane odpowiedzi AI

Ocena według intencji zakupowej

Powiązane artykuły