Webhook Discord : en créer un et envoyer des messages
Guide des webhooks Discord
Webhook Discord : création, payload JSON, embeds | We.Inc
Créez un webhook Discord, construisez le payload JSON (content, username, avatar_url, embeds) avec les limites de caractères en direct, et copiez du code curl, JavaScript et Python prêt à l'emploi.
Un webhook Discord est une URL secrète liée à un salon. Envoyez en POST un corps JSON avec content (jusqu'à 2000 caractères), embeds (jusqu'à 10), ou les deux, et le message apparaît dans ce salon sous le nom du webhook. Aucun bot ni connexion n'est nécessaire, et c'est aussi pourquoi toute personne qui détient l'URL peut publier.
Les champs d'Execute Webhook que vous utiliserez le plus
- Champ
- Type
- Remarques
- Texte du message, jusqu'à 2000 caractères
- Remplace le nom du webhook pour ce message
- Remplace l'avatar du webhook pour ce message
- Jusqu'à 10 objets embed enrichis
- Limite les @mentions qui notifient réellement
- thread_id (paramètre de requête)
- Publie dans un fil du salon
- wait (paramètre de requête)
- true renvoie le message créé au lieu d'un 204
Les webhooks sont le moyen le plus rapide d'envoyer des alertes, des soumissions de formulaire ou des avis de déploiement dans un salon Discord. Le générateur ci-dessous écrit le JSON pour vous, compte les caractères par rapport aux limites de Discord pendant la saisie, et transforme le résultat en code curl, JavaScript et Python à coller dans un script ou sur un serveur. Il n'envoie rien lui-même, votre URL de webhook ne quitte donc jamais votre machine.
- Dans les paramètres de votre serveur Discord, créez un webhook pour le salon dans lequel vous voulez publier.
- Choisissez le salon, définissez un nom et un avatar, puis copiez l'URL du webhook.
- Remplissez le générateur ci-dessous et copiez le code généré.
- Exécutez-le depuis un terminal ou votre serveur, avec l'URL dans une variable d'environnement.
- Traitez l'URL comme un mot de passe. Gardez-la dans une variable d'environnement, hors du code front-end et des dépôts publics.
- Si une URL fuite, supprimez ce webhook dans les paramètres de votre serveur et créez-en un nouveau ; l'ancienne URL cesse de fonctionner.
- Définissez allowed_mentions à { "parse": [] } quand le contenu inclut une saisie utilisateur, pour que personne ne puisse déclencher @everyone.
- Ajoutez ?wait=true quand vous avez besoin de récupérer l'id du message, par exemple pour le modifier ou le supprimer plus tard.
- La couleur de l'embed est un entier décimal, la couleur hexadécimale 4F98FB est donc envoyée sous la forme 5216507.
Questions fréquentes
Comment obtenir une URL de webhook Discord ?
Vous avez besoin de la permission Gérer les webhooks sur le serveur ou le salon. Dans les paramètres de votre serveur Discord, créez un webhook pour le salon et copiez son URL.
Pourquoi mon webhook renvoie-t-il 400 Bad Request ?
En général, le corps est vide ou invalide. Vous devez envoyer au moins l'un des éléments suivants : content, embeds, components, un fichier ou un sondage, et content doit faire 2000 caractères ou moins. Envoyez aussi l'en-tête Content-Type: application/json, sinon le corps n'est pas lu comme du JSON.
Puis-je appeler un webhook Discord depuis le navigateur ?
Non. Toute page qui le fait expose l'URL à chaque visiteur, qui peut alors publier n'importe quoi dans votre salon. Envoyez depuis un serveur, une fonction serverless ou un script, et faites appeler celui-ci par votre page.
Quelles sont les limites des embeds ?
Discord documente un titre de 256 caractères maximum, des valeurs de champ jusqu'à 1024 caractères, et un total combiné de 6000 caractères pour le titre, la description, les noms et valeurs des champs, le texte du pied et le nom de l'auteur dans tous les embeds d'un même message.
Un webhook peut-il lire des messages ou répondre aux utilisateurs ?
Non. Un webhook peut seulement publier (et modifier ou supprimer ses propres messages). Lire des salons, réagir à des commandes ou répondre à des personnes nécessite une application bot.
Ce que contient l'URL
- Une URL de webhook se termine par deux parties : l'id du webhook et son token. Le token est le seul identifiant, c'est pourquoi la documentation de Discord précise que l'exécution d'un webhook ne demande aucune autre authentification. Toute personne disposant de l'URL complète a le même pouvoir que vous.
Content, embeds ou les deux
- Le simple content convient aux alertes courtes et prend en charge le markdown de Discord. Les embeds vous donnent une barre latérale colorée, un titre cliquable, des champs disposés en colonnes et un pied, ce qui se lit mieux pour des données structurées comme une commande ou un rapport d'erreur.
- Vous pouvez envoyer les deux en un seul appel. Le content apparaît au-dessus des embeds, et allowed_mentions décide si les noms qu'il contient notifient réellement les personnes.
Envoyer en volume
- Quand vous envoyez trop vite, Discord répond avec un statut 429 et une valeur JSON retry_after en secondes. Respectez-la et mettez les messages en file d'attente, plutôt que de réessayer dans une boucle serrée. Regrouper plusieurs événements dans un seul message avec plusieurs embeds réduit aussi le nombre d'appels.
Requêtes prêtes à l'emploi
curl : un message simple
L'URL est lue depuis une variable d'environnement, elle n'atterrit donc jamais dans l'historique de votre shell ni dans un commit.
Node.js : un embed avec des champs
Utilise le fetch intégré de Node 18 et versions ultérieures. wait=true fait renvoyer le message par Discord pour que vous puissiez journaliser son id.
Python avec requests
json= définit l'en-tête Content-Type pour vous. Un statut 204 signifie que le message a été publié.
Générateur de payload pour webhook Discord
Saisissez votre message et votre embed, surveillez le nombre de caractères, et copiez le JSON ou le code. Rien n'est envoyé depuis cette page.
Contenu du message
Nom d'utilisateur de remplacement
URL d'avatar de remplacement
Ajouter un embed
Titre de l'embed
Description de l'embed
Couleur de l'embed
Texte du pied
Bloquer toutes les mentions (allowed_mentions parse: [])
Caractères de l'embed : {n} / 6000
Limite dépassée : Discord rejettera ce message.
Vide : ajoutez du contenu ou un embed.
Format de sortie
Aperçu approximatif
Webhook
Commencer gratuitement · Sans carte bancaire
Voir aussi: Guides
- Détectée, non indexée
- Types d'enregistrements DNS expliqués, avec exemples
- Ai-je besoin d'un site web pour mon entreprise ?
- Docker Compose
- Redirection de domaine
- Gestion des noms de domaine pour agences web
- Domaine vs Hébergement
- Double opt-in
Produit
Pour qui
- Pour les agences
- Pour les indépendants
- Pour les hébergeurs
- Pour les plateformes SaaS
- Pour les startups
- Services financiers
- Solutions pour la santé
Fonctionnalités
- Éditeur visuel
- SEO et analyses
- Image de marque personnalisée
- Tableau de bord client
- Facturation revendeur
Ressources
- Blog
- Centre d'aide
- Outils gratuits pour les entreprises
- Free UI Components
- Modèles
- Collections de modèles
- Exemples de sites
- Guides
- Comparatifs
- Alternatives
- Les meilleurs
- Avis
- Guides des tarifs
- Cas d'usage
- Glossaire et guides
- Intégrations
- Développeurs
- Benchmark
- Windows App