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