TL;DR
7 min leestijdEen Discord-webhook is een URL in de vorm `https://discord.com/api/webhooks/{id}/{token}` waarmee een externe dienst een bericht in één kanaal kan plaatsen door een JSON-payload te sturen, zonder dat er een bot hoeft in te loggen. Volgens Discords eigen ontwikkelaarsdocumentatie heeft de aanroep geen aparte authenticatie nodig, omdat de id en het token in de URL zelf de inloggegevens zijn. Daarom moet je die URL als geheim behandelen. De globale API-limiet van Discord is 50 verzoeken per seconde per applicatie, volgens Discords eigen documentatie.
Wat is een Discord-webhook?
Een Discord-webhook is een kanaalspecifieke URL waarmee een externe dienst een bericht in dat kanaal kan plaatsen door een HTTP-verzoek te sturen, zonder in te loggen als bot of gebruiker. Discords eigen ontwikkelaarsdocumentatie beschrijft het endpoint als POST /webhooks/{webhook.id}/{webhook.token} en zegt zonder omwegen dat "this call does not require authentication", omdat de webhook-id en het token in de URL zelf de inloggegevens zijn. Dat ene feit bepaalt het meeste van wat een team moet weten bij het opzetten: de webhook aanmaken is een eenmalige stap in Discord waarvoor je rechten nodig hebt, terwijl je hem daarna gebruikt door simpelweg JSON naar een URL te sturen.
Hoe maak je een Discord-webhook in de kanaalinstellingen?
Een serverlid met de machtiging Webhooks beheren maakt een Discord-webhook aan vanuit de instellingen van een kanaal, op het tabblad Integraties, door Nieuwe webhook te kiezen en de URL te kopiëren die Discord daarvoor genereert. Dezelfde actie is via de API van Discord beschikbaar als POST /channels/{channel.id}/webhooks, waarvoor volgens de documentatie van Discord ook de machtiging Webhooks beheren op dat kanaal nodig is. Geef de webhook een naam en eventueel een avatar voordat je de URL kopieert, want vanaf dat moment kan iedereen met die URL in het kanaal posten.

Hoe ziet een JSON-payload voor een Discord-webhook eruit?
Een JSON-payload voor een Discord-webhook is de request body die naar de webhook-URL wordt gestuurd. Hij moet minstens een van content, embeds, poll of een bestandsbijlage bevatten, want de documentatie van Discord noemt dat als vereiste voor de execute webhook-aanroep. Het veld content bevat platte berichttekst tot 2000 tekens, username en avatar_url overschrijven de standaardnaam en -afbeelding van de webhook alleen voor dat ene bericht, en embeds bevat tot 10 rijk opgemaakte embed-objecten in één aanroep. Het mechanisme is een gewone JSON POST-body: een dienst bouwt dit object, stuurt het via HTTPS naar de webhook-URL, en Discord plaatst het resultaat in het kanaal waarin de webhook is aangemaakt.
{
"content": "Deployment finished",
"username": "Release Bot",
"avatar_url": "https://example.com/bot-avatar.png",
"embeds": []
}| Veld | Type | Opmerkingen |
|---|---|---|
content | string | Berichttekst, tot 2000 tekens |
username | string | Overschrijft de standaardnaam van de webhook voor dit bericht |
avatar_url | string | Overschrijft de standaardavatar van de webhook voor dit bericht |
tts | boolean | Verstuurt het bericht als tekst-naar-spraak |
embeds | array | Tot 10 embed-objecten per verzoek |
allowed_mentions | object | Bepaalt welke vermeldingen in het bericht mensen echt een melding geven |
Welke rate limits gelden voor een Discord-webhook?
Discord hanteert volgens de eigen ontwikkelaarsdocumentatie een globale limiet van 50 verzoeken per seconde per applicatie voor de hele API, en de route van een webhook heeft daarnaast een aparte, krappere limiet die Discord doorgeeft via response headers in plaats van als één gepubliceerd getal. Elke response bevat de headers X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset, en de documentatie van Discord zegt dat een client die headers moet lezen in plaats van een limiet hard te coderen, omdat limieten per route "subject to change" zijn. Een dienst die veel berichten in korte tijd verstuurt, moet na elke aanroep de header met resterende verzoeken controleren en pauzeren zodra die op nul staat, in plaats van uit te gaan van een vast aantal aanroepen per minuut.

Waarom is een Discord-webhook-URL geheim?
Een Discord-webhook-URL is geheim omdat de id en het token erin de volledige inloggegevens zijn die het endpoint controleert, en de documentatie van Discord bevestigt dat de execute webhook-aanroep geen extra authenticatie nodig heeft naast wat de URL al bevat. Iedereen met de URL kan elk bericht in dat kanaal plaatsen onder de naam van de webhook, zonder ooit in te loggen als Discord-gebruiker of bot. Bewaar de URL zoals je een API-sleutel bewaart, bijvoorbeeld in een omgevingsvariabele of een secrets manager, en commit hem nooit naar een openbare coderepository of plak hem nooit in een client-side script.
Kan een Discord-webhook ook berichten ontvangen, niet alleen versturen?
Een standaard Discord-webhook verstuurt alleen berichten naar een kanaal; hij kan geen berichten lezen die anderen daar plaatsen, want het execute webhook-endpoint is een eenrichtings-POST-doel zonder leestoegang. Een team dat wil reageren op wat er in een Discord-server gebeurt, zoals Reddit API-rate limits een tweerichtingsintegratie met Reddit regelen, heeft in plaats daarvan een Discord-bot nodig met een eigen token en de juiste gateway-machtigingen. Dat is een andere opzet dan een webhook, dichter bij hoe Twitter API-prijzen tweerichtingstoegang tot de data van X afschermen, en hoort bij de kant van social media-dataverzameling van een project in plaats van bij de meldingenkant; een handleiding in de stijl van Discords eigen ontwikkelaarsdocumentatie is de logische volgende stap voor een team dat een volwaardige bot bouwt.
- Plaatst berichten in één kanaal
- Geen bot-login, geen aparte authenticatie
- Kan geen berichten van anderen lezen
- Leest berichten en reageert op commando's
- Heeft een eigen token en gateway-machtigingen nodig
- Kan in veel kanalen en servers actief zijn
Veelgestelde vragen
Kan ik een bericht dat ik al met een Discord-webhook heb verstuurd, bewerken of verwijderen?
Ja. De response van de execute webhook-aanroep geeft een bericht-id terug als het verzoek ?wait=true bevat, en met die id kun je aparte bewerk- en verwijder-endpoints van dezelfde webhook gebruiken. Zonder wait=true geeft de eerste aanroep niet het berichtobject terug dat je nodig hebt om het later te bewerken.
Verloopt een Discord-webhook?
Een Discord-webhook-URL verloopt niet vanzelf; hij blijft geldig tot een serverbeheerder de webhook verwijdert of het kanaal waar hij bij hoort weghaalt. Omdat hij nooit uit zichzelf verloopt, is het veiliger om de URL als permanent geheim te behandelen en niet als tijdelijk token.
Kan meer dan één dienst dezelfde Discord-webhook-URL gebruiken?
Ja, technisch kunnen onbeperkt veel diensten verzoeken naar dezelfde webhook-URL sturen, want Discord maakt geen onderscheid tussen afzenders. In de praktijk houdt een aparte webhook per dienst of per bot berichten makkelijker herleidbaar naar hun bron, en kun je zo één integratie intrekken zonder een andere te breken.
Wat gebeurt er als ik een payload stuur die groter is dan de limieten van Discord?
Discord weigert het verzoek met een foutmelding in plaats van de inhoud stilletjes in te korten, dus een payload met meer dan 2000 tekens in content of meer dan 10 objecten in embeds laat de aanroep meteen mislukken. Als je na elke webhook-aanroep de statuscode controleert, merk je dit op voordat een bericht stilletjes nooit aankomt.
Moet specifiek de servereigenaar een Discord-webhook aanmaken?
Nee. Elk lid met de machtiging Webhooks beheren op een kanaal kan daar een webhook aanmaken, en die machtiging kan aan een rol worden gegeven zonder die rol servereigenaar of beheerder te maken. De API van Discord past dezelfde machtigingscontrole toe op het endpoint POST /channels/{channel.id}/webhooks waarmee je er programmatisch een aanmaakt.
Is een Discord-webhook hetzelfde als een Discord-bot?
Nee. Een webhook is een eenrichtings-URL om zonder login berichten in één kanaal te plaatsen, terwijl een bot een volwaardige applicatie is met een eigen token die berichten kan lezen, op commando's kan reageren en in veel kanalen en servers actief kan zijn. Een project dat alleen meldingen naar één kanaal hoeft te sturen, heeft een webhook nodig; een project dat moet luisteren en reageren, heeft een bot nodig.
Kan ik een Discord-webhook opzetten zonder code te schrijven?
Er een aanmaken kost helemaal geen code: een serverlid met de machtiging Webhooks beheren opent het tabblad Integraties van het kanaal, klikt op Nieuwe webhook en kopieert de gegenereerde URL. Een naam of avatar geven is op dat moment optioneel. Om echt een bericht te versturen heb je wel een manier nodig om een HTTPS POST-verzoek met een JSON-body te sturen, of dat nu een script is, een automatiseringstool of een dienst die al JSON spreekt. Wil je nieuwe Reddit-vermeldingen helemaal zonder script in een kanaal plaatsen, dan start de RedReplier-app voor Zapier een Zap per vermelding, zoals de Zapier Reddit-handleiding laat zien, en een n8n Reddit-workflow doet hetzelfde op je eigen server met een HTTP Request-node.
RedReplier
Aan de slag
Reddit, X, Bluesky en HN
Realtime meldingen op intentie
Onbeperkt AI-antwoorden
Gerangschikt op koopintentie
Hoe weet ik hoeveel verzoeken ik nog over heb voordat ik de rate limit van Discord raak?
Discord publiceert geen vast getal voor de route van een webhook; in plaats daarvan bevat elke response de headers X-RateLimit-Limit, X-RateLimit-Remaining en X-RateLimit-Reset. Volgens de eigen documentatie van Discord moet een client die headers lezen in plaats van een limiet hard te coderen, omdat limieten per route kunnen veranderen. Een dienst die veel berichten in korte tijd verstuurt, controleert na elke aanroep de header met resterende verzoeken en pauzeert zodra die op nul staat.
Kan een webhookbericht eruitzien alsof het van iemand anders komt?
De velden username en avatar_url in de JSON-payload overschrijven de standaardnaam en -afbeelding van de webhook, maar alleen voor dat ene bericht. De naam en avatar die bij het aanmaken van de webhook zijn ingesteld, blijven overal elders ongewijzigd. Met die overschrijving kan één webhook voor een deploymelding als 'Release Bot' posten en de volgende keer onder een andere naam, zonder de webhook zelf aan te passen.
Wat houdt iemand anders tegen om in mijn kanaal te posten als hij mijn webhook-URL heeft?
Niets. De webhook-id en het token in de URL zijn de volledige inloggegevens die Discord controleert, dus iedereen met die URL kan elk bericht in het kanaal plaatsen onder de naam van de webhook, zonder in te loggen als gebruiker of bot. Daarom behandel je de URL als een API-sleutel: bewaar hem in een omgevingsvariabele of een secrets manager, en commit hem nooit naar een openbare repository of plak hem nooit in client-side code.
Zie ons vaker in Google
Met één klik markeer je RedReplier als voorkeursbron, zodat onze artikelen hoger staan in je Topverhalen, AI-modus en AI-overzichten.
Voordat je gaat...
RedReplier
Vang elke koper die vraagt om wat jij verkoopt
RedReplier houdt Reddit, X, Bluesky en Hacker News in realtime in de gaten, rangschikt elke thread op koopintentie en schrijft een concept voor je antwoord, zodat jij er als eerste bij bent.
Reddit, X, Bluesky en HN
Realtime meldingen op intentie
Onbeperkt AI-antwoorden
Gerangschikt op koopintentie
Gerelateerde artikelen


Wat contestmodus op Reddit verbergt, en wat het betekent voor je antwoord
Een thread in de contestmodus van Reddit schudt reacties door elkaar, verbergt scores en klapt antwoorden in. Wie hem aanzet, wat mods zien en waar je antwoord hoort.


Wat iemand volgen op Reddit jou laat zien, en wat het hen vertelt
Iemand volgen op Reddit zet de profielposts van die persoon in je homefeed en laat het hen weten. Wat je ziet, hoe mensen zich afmelden en waarom de geschiedenis beter werkt.


Verborgen posts op Reddit vinden, weer zichtbaar maken en Hide gebruiken om te triëren
Waar verborgen posts op Reddit blijven, wat Reddit documenteert om ze op desktop en in de app te bekijken, hoe je er een terughaalt en hoe verbergen je triage versnelt.

