Webhooks


Webhooks sortants qui sont appelés à chaque addition/modification/suppression d'un élément du Bazar.

Page Github: https://github.com/YesWiki/yeswiki-extension-webhooks

Configuration


Après l'installation, rendez-vous sur la page principale du Bazar et vous trouverez en bas le formulaire pour ajouter des webhooks sortants.

- A gauche vous pouvez choisir le format de sortie du webhook (Brut, Mattermost, Slack)
- A droite vous devez entrer l'URL du webhook à appeler

Chaque fois que vous cliquez sur "Mettre à jour", une nouvelle colonne est ajoutée.
Si vous souhaitez effacer un webhook, il suffit de mettre un URL vide et l'élément sera supprimé lors de la mise à jour.

Mattermost


Pour permettre à une chatroom Mattermost (comme Framateam) de recevoir des messages à chaque fois qu'un élément est ajouté/édité/supprimé, suivez ces instructions:

- Connectez-vous à votre chatroom Mattermost en tant qu'administrateur
- Dans le menu principal, choisissez "Intégration"
- Choisissez "Webhooks entrants"
- Créez un webhook avec les configurations de votre choix
- Sur la page Bazar de votre wiki, choisissez "Mattermost" et copiez l'adresse fournie par Mattermost.

C'est fait !

Slack


Pour connecté votre Bazar à une chatroom Slack, suivez le guide ici: https://api.slack.com/incoming-webhooks

Sur la page Bazar de votre wiki, choisissez "Slack" et copiez l'adresse fournie par Slack.

Brut


Si vous choisissez le format Brut, toutes les informations à propos de l'élément Bazar ajouté/édité/supprimé sera POSTée à l'URL indiquée. C'est une option qui conviendra plus à des développeurs.

En plus, ces informations seront envoyées:

- action: type d'action effectuée (add/edit/delete)
- text: texte formatté qui décrit l'action effectuée (la même que celle envoyée à Mattermost/Slack)

Si vous souhaitez voir les données envoyées par le webhook, vous pouvez utiliser une URL spéciale de test pour les webhooks entrant : http://VOTRE_ADRESSE.COM/?BazaR&vue=test-webhook. Toutes les données envoyées sur cette URL seront insérées dans la table yeswiki_triples.