Un webhook est une URL qui publie un message dans un salon. Pas de bot, pas de jeton, pas d'hébergement, pas d'intents. Si tout ce dont vous avez besoin est « il s'est passé quelque chose, préviens Discord », c'est la réponse et cela prend deux minutes.
Webhook ou bot ?
| Vous voulez | Utilisez |
|---|---|
| Publier une alerte quand une compilation finit | Un webhook |
| Relayer des événements du serveur dans un salon | Un webhook |
| Répondre à une commande slash | Un bot |
| Réagir à ce que disent les gens | Un bot, avec des intents |
| Publier sous plusieurs noms et avatars différents | Un webhook — les bots ne font pas cela facilement |
| Gérer des rôles ou modérer | Un bot |
Que faire
- Créez-le dans les paramètres du salon
Intégrations → Webhooks → Nouveau webhook. Vous le nommez et choisissez le salon. C'est toute l'installation.
- Copiez l'URL
C'est l'identifiant. Quiconque l'a peut publier dans ce salon en tant que ce webhook, ce qui amène au point suivant.
- Envoyez-lui un message JSON
Un POST avec un champ
content, ou un tableauembeds. Tout langage le fait en trois lignes, et la plupart des outils qui doivent notifier acceptent déjà des URL de webhook. - Réglez le nom et l'avatar par message si vous voulez
Un webhook peut publier sous un nom différent à chaque fois. C'est ainsi que les ponts de relais affichent le nom de l'auteur d'origine sur chaque message.
Quiconque la détient peut publier n'importe quoi dans ce salon, indéfiniment, sous n'importe quel nom et avatar. Ne la poussez pas dans un dépôt public et ne la collez pas dans un salon. Si l'une fuite, supprimez le webhook dans les paramètres du salon : cela invalide l'URL immédiatement, et en créer un nouveau prend quelques secondes.
Elles sont plus strictes que celles d'un bot, et un script qui publie en boucle les heurtera. Si vous envoyez plus d'un message toutes les quelques secondes, soit vous regroupez le contenu en un seul message, soit vous avez dépassé les webhooks et il vous faut un bot.
Publiez sur l'URL depuis la ligne de commande ou un petit script et voyez le message apparaître dans le salon avec le nom que vous avez défini.