Webhook Discord : créer un webhook et envoyer des messages automatiques

Créer un webhook Discord

Comment créer un webhook Discord ? En deux minutes, d'après l'article du centre d'aide sur les webhooks :

1. Ouvrez les paramètres du serveur, onglet Intégrations.
2. Cliquez sur « Création de webhook » (ou « Nouveau webhook »).
3. Donnez-lui un nom et un avatar : ce sont ceux qui s'afficheront sur ses messages.
4. Choisissez le salon où il publiera.
5. Cliquez sur « Copier l'URL du webhook » et gardez-la en lieu sûr.

Il faut la permission « Gérer les webhooks ». Le nom compte de 1 à 80 caractères et ne peut contenir ni « clyde » ni « discord », selon la documentation pour développeurs. La page Intégrations liste ensuite tous les webhooks du serveur, avec qui les a créés et quand.

Envoyer un message

Un webhook reçoit une requête POST au format JSON. Le plus simple, en ligne de commande :

curl -H "Content-Type: application/json" \
  -d '{"content": "Nouvelle inscription à la formation 🎉"}' \
  "https://discord.com/api/webhooks/IDENTIFIANT/JETON"

Remplacez l'adresse par celle que vous avez copiée. Le message apparaît aussitôt dans le salon, sous le nom et l'avatar du webhook.

Le texte accepte toute la mise en forme de l'écriture Discord : gras, titres, listes, et même les timestamps qui s'adaptent au fuseau du lecteur.

Envoyer un embed avec un webhook Discord

Un embed est un encadré avec un titre, une description, une barre de couleur et des champs. Exemple de webhook Discord embed :

{
  "username": "Boutique",
  "embeds": [
    {
      "title": "Nouvelle commande",
      "description": "Formation **Lancer sa boutique**, accès à vie.",
      "color": 5793266,
      "fields": [
        { "name": "Client", "value": "Léa M.", "inline": true },
        { "name": "Montant", "value": "297 €", "inline": true }
      ]
    }
  ]
}

La couleur s'écrit en nombre décimal : 5793266 correspond au bleu #5865F2. Les limites, d'après la documentation des messages : 256 caractères pour le titre, 4 096 pour la description, 25 champs, et 6 000 caractères pour l'ensemble des embeds d'un message.

Relier GitHub ou un outil compatible Slack

Certains services savent déjà parler à Discord :

• GitHub : ajoutez /github à la fin de l'adresse du webhook et déclarez-la dans les réglages du dépôt, avec le type application/json. Le salon reçoit les envois de code, les demandes de fusion, les tickets. C'est la façon la plus simple de relier un GitHub webhook Discord.
• Les outils compatibles Slack : ajoutez /slack à la fin de l'adresse. Quelques champs propres à Slack sont ignorés.

Idées d'usage

• Les ventes : chaque commande de votre boutique arrive dans un salon #ventes réservé à l'équipe.
• Les inscriptions : un formulaire rempli sur votre site devient un message, et quelqu'un le prend en charge.
• Les publications : un nouvel article de blog ou une nouvelle vidéo s'annonce tout seul dans #annonces.
• La surveillance : une alerte quand votre site ne répond plus.

La plupart des outils d'automatisation savent envoyer une requête à une adresse : c'est tout ce qu'il faut.

Protéger l'adresse du webhook

L'adresse d'un webhook contient son jeton : quiconque la connaît peut publier dans votre salon, et même supprimer le webhook. La documentation de Discord précise que ces opérations ne demandent aucune autre authentification.

• Ne la publiez jamais : ni dans un dépôt de code public, ni dans le code d'une page web.
• Rangez-la côté serveur, dans une variable d'environnement.
• Si elle a fuité, supprimez le webhook dans l'onglet Intégrations et créez-en un nouveau.

Les limites

Discord ne publie pas de quota par webhook. Les limites s'appliquent par route, avec un plafond global de 50 requêtes par seconde ; au-delà, Discord répond par une erreur 429 et indique dans l'en-tête Retry-After combien de temps attendre, d'après la page sur les limites de débit. Envoyez vos messages au fil de l'eau plutôt qu'en rafale.

Webhook ou bot ?

Un webhook ne fait que publier. Il ne lit pas les messages, ne répond pas, n'ouvre pas de salon. Pour accueillir les membres, répondre à leurs questions ou ouvrir un ticket, il faut un bot. Notre article sur le bot de ticket Discord explique la différence, et celui sur l'IA sur Discord ce qu'un agent sait faire.

Questions fréquentes

Comment créer un webhook Discord ?

Ouvrez les paramètres du serveur, onglet Intégrations, puis « Création de webhook ». Choisissez un nom, un avatar et un salon, puis copiez l'URL du webhook. Il faut la permission « Gérer les webhooks ».

Un webhook Discord est-il gratuit ?

Oui. Les webhooks font partie de Discord, sans abonnement ni bot à installer. Il suffit d'un serveur où vous avez la permission « Gérer les webhooks ».

Un webhook peut-il lire les messages ?

Non. Un webhook ne fait que publier dans le salon choisi. Pour lire et répondre aux messages, il faut un bot.

Que faire si l'URL de mon webhook a fuité ?

Supprimez le webhook dans les paramètres du serveur, onglet Intégrations, puis créez-en un nouveau et mettez à jour l'adresse dans vos outils. Toute personne qui a l'ancienne adresse pouvait publier dans votre salon.