TL;DR
6 min czytaniaWebhook 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.

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": []
}| Pole | Typ | Uwagi |
|---|---|---|
content | string | Tekst wiadomości, do 2000 znaków |
username | string | Zastępuje domyślną nazwę webhooka dla tej wiadomości |
avatar_url | string | Zastępuje domyślny awatar webhooka dla tej wiadomości |
tts | boolean | Wysyła wiadomość jako zamianę tekstu na mowę |
embeds | array | Do 10 obiektów osadzonych na żądanie |
allowed_mentions | object | Okreś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ę.

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.
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.
- Publikuje wiadomości na jednym kanale
- Bez logowania bota i osobnego uwierzytelniania
- Nie może czytać wiadomości publikowanych przez innych
- Czyta wiadomości i odpowiada na polecenia
- Wymaga własnego tokenu i uprawnień bramy
- Może działać na wielu kanałach i serwerach
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
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
Ż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


Co ukrywa contest mode na Reddicie i co to oznacza dla twojej odpowiedzi
Wątek w contest mode na Reddicie miesza komentarze, ukrywa wyniki i zwija odpowiedzi. Kto go włącza, co widzą moderatorzy i gdzie umieścić odpowiedź.


Co daje obserwowanie użytkownika na Reddicie i o czym się on dowiaduje
Obserwowanie użytkownika na Reddicie dodaje posty z jego profilu do twojego feedu i go o tym informuje. Co widać, jak to wyłączyć i dlaczego historia jest lepsza.


Jak znaleźć ukryte posty na Reddicie, przywrócić je i używać Hide do selekcji wątków
Gdzie trafiają ukryte posty na Reddicie, co Reddit dokumentuje o ich oglądaniu w przeglądarce i aplikacji, jak je odkryć i jak ukrywanie przyspiesza selekcję.

