Testeur de Webhook Discord

Teste ton webhook Discord en quelques secondes. Colle l'URL, valide-la et envoie un message de test pour t'assurer qu'il fonctionne.

Qu'est-ce qu'un webhook Discord ?

Un webhook Discord est une URL unique qui te permet d'envoyer des messages dans un salon Discord précis sans avoir besoin d'un bot. Les webhooks servent couramment aux notifications GitHub, aux alertes de supervision de serveurs, aux mises à jour de pipelines CI/CD et aux intégrations sur mesure. Chaque webhook a son propre nom, son propre avatar, et il est lié à un salon précis.

Comment créer un webhook Discord

1. Ouvre ton serveur Discord et va dans Paramètres du serveur
2. Va dans Intégrations > Webhooks
3. Clique sur Nouveau webhook
4. Donne-lui un nom et choisis le salon cible
5. Clique sur Copier l'URL du webhook
6. Colle l'URL dans le testeur ci-dessus pour vérifier qu'elle fonctionne

Comment fonctionne ce testeur

Colle ton URL de webhook et clique sur Vérifier. L'outil valide l'URL auprès de l'API Discord et affiche le nom, l'avatar et le salon lié du webhook. Si elle est valide, tu peux saisir un message personnalisé et l'envoyer via le webhook pour confirmer qu'il fonctionne. Ton URL de webhook transite par notre serveur pour des raisons de sécurité (un navigateur ne peut pas appeler l'API Discord directement à cause du CORS), mais elle n'est jamais stockée ni enregistrée.

Codes d'erreur fréquents des webhooks Discord

Quand une requête de webhook échoue, Discord renvoie un statut HTTP avec un corps JSON contenant un code numérique et un message. Voici ceux que tu rencontreras réellement :

• 400 Bad Request - Corps JSON mal formé, embed dépassant 6 000 caractères au total, ou champ trop long. Valide ta charge utile en local avant de l'envoyer.
• 401 Unauthorized - Le token du webhook est erroné ou a été régénéré. Régénérer un webhook dans les paramètres du serveur invalide immédiatement l'ancienne URL.
• 404 Not Found - Le webhook a été supprimé, le salon a été supprimé, ou l'URL contient une faute de frappe. Recopie l'URL depuis Paramètres du serveur > Intégrations.
• 429 Too Many Requests - Tu as atteint une limite de débit. Discord renvoie un champ retry_after (en secondes) qui indique quand réessayer. Respecte-le.
• Code 50027 (Invalid Webhook Token) - Même cause qu'un 401 ; renvoyé quand le segment du token dans l'URL est corrompu ou tronqué.
• Code 50006 (Cannot send empty message) - Ta charge utile n'a ni content, ni embeds, ni files. Au moins l'un des trois est obligatoire.
• Code 50035 (Invalid Form Body) - Cause la plus fréquente : embed.color envoyé sous forme de chaîne hexadécimale au lieu d'un entier décimal. Convertis #9B59B6 en 10181046 avant l'envoi.

Limites de débit des webhooks Discord

Discord applique des limites de débit par webhook et par salon, et la taille exacte des compartiments est déterminée côté serveur puis exposée dans les en-têtes de réponse plutôt que fixée à une valeur figée. Chaque réponse réussie contient X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset-After : lis-les pour planifier ta requête suivante, et n'écris pas un débit fixe en dur. Le corps d'une réponse 429 porte aussi une valeur retry_after (en secondes). Pour les intégrations à fort volume (pipelines de build, agrégation de logs), regroupe plusieurs événements dans un seul message : un appel de webhook peut porter jusqu'à 10 embeds de 6 000 caractères cumulés chacun, ce qui suffit généralement à condenser une rafale d'événements en une requête.

Bonnes pratiques de sécurité pour les webhooks

Une URL de webhook est un identifiant au porteur. Quiconque possède l'URL complète peut publier dans ton salon sous l'identité du bot du webhook, sans autre authentification. Traite-la comme un mot de passe :

• Ne commite jamais d'URL de webhook dans un dépôt Git public. L'analyse de secrets de GitHub détecte et révoque automatiquement les webhooks Discord divulgués, mais seulement après qu'ils ont déjà été exposés.
• Stocke les URL de webhook dans des variables d'environnement ou un gestionnaire de secrets, pas dans le code source ni dans des fichiers de configuration versionnés.
• Si un webhook est exposé, supprime-le immédiatement dans Paramètres du serveur > Intégrations > Webhooks. Le recréer génère un nouveau token ; l'ancienne URL cesse de fonctionner.
• Pour un usage côté client (une application navigateur qui publie sur Discord), fais transiter l'appel par ton propre backend afin que l'URL n'atteigne jamais le navigateur de l'utilisateur. Une URL divulguée depuis une application navigateur attire le vandalisme.
• Les webhooks Discord ignorent les mentions @everyone et @here tant que allowed_mentions ne les autorise pas explicitement. Mets "parse": [] pour désactiver tous les pings de mention si tu n'en as pas besoin.

Test manuel d'un webhook avec curl

Si tu préfères tester depuis le terminal, la charge utile minimale est un seul champ content. Un POST réussi renvoie un HTTP 204 avec un corps vide, ou un HTTP 200 avec le JSON du message créé si tu ajoutes ?wait=true à l'URL. Utilise ?wait=true quand tu as besoin de récupérer l'identifiant du message (par exemple pour le modifier ou le supprimer ensuite via l'endpoint /webhooks/<id>/<token>/messages/<message_id>).

Plus d'outils Discord gratuits

• Snowflake Checker - Vérifie l'ancienneté de n'importe quel compte Discord
• Colored Text Generator - Crée des messages colorés avec des codes ANSI
• Message Length Counter - Vérifie si ton message tient dans les limites de Discord
• Color Role Previewer - Prévisualise les couleurs de rôle sur tous les thèmes Discord

Propulsé par Pigona - Traduction gratuite pour Discord