Un webhook publie un court message dans un salon Discord quand il se passe quelque chose sur votre serveur : il démarre, s’arrête ou plante, un joueur se connecte ou part, ou un backup se termine. Tous les membres du salon le voient sans ouvrir le panel. Un webhook peut aussi envoyer vers n’importe quelle autre adresse https, pour vos propres outils.
Seul le propriétaire d’un serveur peut configurer ses webhooks. Les personnes que vous avez invitées sur le serveur ne voient pas la page.
1. Créer un webhook dans Discord
Vous avez besoin de la permission de gérer les webhooks sur le serveur Discord. Son propriétaire et ses admins l’ont normalement.
- Dans Discord, ouvrez Paramètres du serveur et allez dans Intégrations.
- Cliquez sur Créer un webhook, donnez-lui un nom et choisissez le salon textuel où il publie, par exemple un salon
#server-alerts. - Cliquez sur Copier l’URL du webhook.
Discord explique ces étapes avec des images dans son guide Intro to Webhooks. Traitez l’URL du webhook comme un mot de passe : toute personne qui la possède peut publier dans ce salon.
2. L’ajouter à votre serveur
- Ouvrez votre serveur dans le panel et cliquez sur Webhooks dans le menu de gauche.
- Cliquez sur En ajouter un, ou sur Nouveau webhook si le serveur en a déjà un.
- Donnez-lui un Nom si vous le souhaitez. Il n’est là que pour vous et nomme le webhook dans votre liste.
- Collez l’adresse dans URL. Elle doit commencer par
https://. Quand c’est un webhook Discord, le panel affiche Webhook Discord reconnu. - Sous Envoyer quand, cochez les événements voulus (voir plus bas). Serveur planté est coché au départ, et au moins un événement doit être coché.
- Cliquez sur Créer le webhook.
Les événements
| Événement | Quand il est envoyé |
|---|---|
| Serveur démarré | Quand le serveur est en ligne et prêt pour les joueurs, y compris après un redémarrage. |
| Serveur arrêté | Un arrêt demandé par quelqu’un : vous, un membre de l’équipe ou une planification. |
| Serveur planté | Le serveur s’est arrêté sans qu’on le lui demande. L’événement est envoyé une ou deux minutes plus tard, quand nous en sommes sûrs, et indique si le serveur est reparti tout seul. |
| Joueur connecté | Avec le pseudo du joueur, sur les jeux qui indiquent qui est en ligne. Les jeux qui ne donnent qu’un nombre indiquent combien de joueurs sont en ligne. |
| Joueur parti | Pareil, quand quelqu’un part. Les joueurs sont vérifiés une fois par minute tant que le serveur tourne. |
| Backup terminé | Indique si le backup a réussi et sa taille. |
| Installation terminée | Après la première installation ou une réinstallation. |
| Transfert terminé | Quand le déplacement de votre serveur est terminé. |
Les serveurs Project Zomboid ont des événements en plus, lus dans le journal du jeu : Un joueur est mort, Kill PvP, Action admin, Mod mis à jour, Compte à rebours de redémarrage lancé et Relayer le chat du jeu. Le chat n’est envoyé que si vous le cochez, et seulement le chat général : les messages privés, le chat de faction et celui de la safehouse ne sont jamais envoyés.
Ce qui arrive
- Dans Discord, les messages arrivent de la part de PlayNHost sous forme de courtes cartes avec le nom du serveur, ce qui s’est passé et quand. Discord affiche l’heure dans le fuseau horaire de chaque lecteur.
- Les messages citent le nom de votre serveur mais n’incluent jamais son adresse ni son identifiant, ils peuvent donc aller dans un salon public. Pour changer le nom affiché, renommez le serveur. Voir Comment renommer votre serveur et changer les slots de joueurs.
- Un joueur ne peut pas mentionner votre salon avec son pseudo. Un pseudo comme
@everyonearrive en texte brut. - Toute autre adresse reçoit les événements en JSON. Voir Pour vos propres outils plus bas.
Désactiver un webhook, le modifier ou le supprimer
- Utilisez l’interrupteur sur la ligne d’un webhook pour le désactiver et le réactiver. Il garde ses réglages tant qu’il est désactivé.
- Ouvrez le menu de la ligne et choisissez Modifier pour changer le nom, l’adresse ou les événements, ou Supprimer pour le retirer. Rien d’autre n’est affecté : votre serveur continue de tourner et le salon cesse simplement de recevoir des messages.
Bon à savoir
- Un serveur peut avoir jusqu’à 10 webhooks, par exemple un par salon.
- Pour qu’un salon reste lisible, chaque webhook envoie au maximum 4 messages par minute et 40 par heure. Les messages au-delà sont ignorés plutôt qu’envoyés en retard, et le message suivant indique combien de mises à jour précédentes ont été ignorées.
- Si le webhook est supprimé dans Discord, le panel le désactive de lui-même la prochaine fois qu’il essaie d’envoyer, et la ligne affiche Désactivé. Créez un nouveau webhook dans Discord, choisissez Modifier, collez la nouvelle adresse, puis réactivez-le.
- Il n’y a pas de bouton de test. Pour vérifier un nouveau webhook, cochez Serveur démarré et redémarrez votre serveur. Le message arrive peu après que le serveur est prêt.
- Les webhooks servent pour un salon que votre groupe partage. Pour des alertes rien que pour vous, dans le panel ou par e-mail, voir Comment gérer les notifications et les préférences.
Pour vos propres outils
Une adresse qui n’est pas un webhook Discord reçoit un POST avec un corps JSON :
sourcevautPlayNHost.eventsest une liste. Chaque événement a untype(commeserver.crashouplayer.join),server(le nom du serveur),at(quand c’est arrivé), untitleet untextlisibles, et un objetdataavec les détails.skippedindique combien de messages précédents ont été omis à cause de la limite ci-dessus.
L’adresse doit utiliser https et pointer vers une adresse publique sur Internet. Les redirections ne sont pas suivies. Les messages ne sont pas signés, gardez donc l’adresse elle-même secrète.
À lire aussi
- Comment voir ce qui s’est passé sur votre serveur montre qui a démarré, arrêté ou modifié quoi, et quand.
- Comment réparer un serveur qui ne démarre pas vous aide quand une alerte de plantage revient sans cesse.
