Bot Discord : web hooks

Discord permet la création de bots utilisables à travers l'API dédiée, après avoir autorisé les bots sur le serveur et plus précisement sur le canal voulu.

Il est possible d'y faire remonter un grand nombre d'informations de manière automatique.

Un bot discord permet de recevoir, dans la plateforme, des notifications de manière automatique. Ainsi il devient aisé d'avoir des alertes selon toutes sortes d'évènements.

De ce fait, il peut être intéressant de disposer d'un serveur pour son usage personnel, notamment pour les étudiants afin de pouvoir centraliser des informations et d'y recevoir des notifications.

Nous verrrons ici comment connecter gitlab à son bot afin de recevoir un message à chaque modification d'un repo.

Dans les paramètres du serveur, dans la rubrique "Intégrations", sous l'onglet webhooks, créer un nouveau webhook.

Ainsi on pourra assigner un salon par projet par exemple, ou bien mélanger les notifications de tous les projets au sein d'un même canal.

Une fois le webhook créé il suffit de copier l'URL, puis dans son projet gitlab, dans l'onglet "Integrations", choisir "Discord notifications", il suffira d'y coller l'URL récupérée dans discord.

Les paramètres du repo permettront de choisir les évènements qui déclenchent les notifications.

Pour plus d'informations vous pouvez consulter la documentation officielle Gitlab

Si certaines applications proposent un envois standard d'information à Discord, il est également possible de faire de même avec sa propre application.

Pour réaliser cela, une requête POST sur l'URL récupéré précédemment permet l'envoi d'informations au bot.

Les informations devront être formulées selon les différents champs décrit dans la documentation de discord à propos des webhooks

Le seul champ primordial à remplir est néanmoins "content", celui-ci correspond au corps du message, il peut être formaté avec les caractères d'échappement

Dès lors, il est possible d'envoyer un message à chaque insertion en base de données par exemple.

Il suffit alors de cabler les bons services sur cet API, pour se voir attribuer un service de notification facile.