monday.com offre la possibilité d’envoyer un Webhook grâce à nos intégrations, ou vous pouvez même les créer via l’API. Vous pouvez envoyer un Webhook à chaque fois qu’un événement choisi se produit sur votre tableau. Veuillez poursuivre votre lecture pour en savoir plus.

Qu’est-ce qu’un webhook ?

Un webhook (également appelé lien de rappel HTTP ou point d’ancrage Web) est un moyen pour une application de fournir à d’autres applications des informations en temps réel. Un webhook fournit des données à d’autres applications dès qu’un changement se produit, ce qui signifie que vous obtenez des données immédiatement, contrairement aux API typiques où vous aurez besoin de rechercher les données très souvent afin de les obtenir en temps réel. Cette fonctionnalité rend les webhooks beaucoup plus efficaces, tant pour le fournisseur que pour l’utilisateur.

Comment créer un nouveau Webhook 

Depuis votre tableau, cliquez sur le bouton Intégrations sur le côté droit de votre écran, puis cliquez sur l'onglet Créer et recherchez l'intégration Webhooks dans la page Automatisation du tableau :

Ensuite, cliquez sur la bannière Webhooks et choisissez l'action pour laquelle vous souhaitez obtenir des informations instantanées :

Après avoir sélectionné l'action dont vous avez besoin, vous devrez spécifier l'URL. Il devrait s'agir d'une URL capable de renvoyer le JSON challenge, et qui désormais constituera le récepteur des charges utiles à l'avenir :

Et c’est tout ! Dès que cette modification se produit, par exemple lorsqu'un nouvel élément est ajouté à votre tableau, votre point de terminaison reçoit une charge utile concernant cette modification. Vous trouverez quelques charges utiles plus bas.

Ajoutez une description pour détailler l'utilisation de votre intégration Webhook dans votre processus de travail. Cela permettra à tout utilisateur utilisant cette intégration de mieux comprendre son objectif et la manière dont elle s'insère dans le processus de travail. 

Comment vérifier une URL de webhook

{
 challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
}

{
 challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
}

Vous trouverez ici un exemple simple d'écouteur de webhook dont la sortie correspond au format attendu :

app.post("/", function(req, res) { console.log(JSON.stringify(req.body, 0, 2)); res.status(200).send(req.body);})

À quoi ressemblerait les données de l'événement ?

{
 "event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "pulseId": 1772099344,
  "pulseName": "Create_item webhook",
  "groupId": "topics",
  "groupName": "Group Title",
  "groupColor": "#579bfc",
  "isTopGroup": true,
  "columnValues": {},
  "app": "monday",
  "type": "create_pulse",
  "triggerTime": "2021-10-11T09:07:28.210Z",
  "subscriptionId": 73759690,
  "triggerUuid": "b5ed2e17c530f43668de130142445cba"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "groupId": "topics",
  "pulseId": 1771812728,
  "pulseName": "Crate_item webhook",
  "columnId": "date4",
  "columnType": "date",
  "columnTitle": "Date",
  "value": {
   "date": "2021-10-11",
   "icon": null,
   "time": null
  },
  "previousValue": null,
  "changedAt": 1633943701.9457765,
  "isTopGroup": true,
  "app": "monday",
  "type": "update_column_value",
  "triggerTime": "2021-10-11T09:15:03.429Z",
  "subscriptionId": 73760484,
  "triggerUuid": "645fc8d8709d35718f1ae00ceded91e9"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "pulseId": 1771812728,
  "body": "<p>create_update webhook</p>",
  "textBody": "create_update webhook",
  "updateId": 1190616585,
  "replyId": null,
  "app": "monday",
  "type": "create_update",
  "triggerTime": "2021-10-11T09:18:57.368Z",
  "subscriptionId": 73760983,
  "triggerUuid": "6119292e27abcc571f90ea4177e94973"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1771812698,
  "groupId": "topics",
  "pulseId": 1772099344,
  "pulseName": "Create_item webhook",
  "columnId": "status",
  "columnType": "color",
  "columnTitle": "Status",
  "value": {
   "label": {
    "index": 3,
    "text": "Status change wbhook",
    "style": {
     "color": "#0086c0",
     "border": "#3DB0DF",
     "var_name": "blue-links"
    }
   },
   "post_id": null
  },
  "previousValue": null,
  "changedAt": 1633944017.473193,
  "isTopGroup": true,
  "app": "monday",
  "type": "update_column_value",
  "triggerTime": "2021-10-11T09:20:18.022Z",
  "subscriptionId": 73761176,
  "triggerUuid": "504b2eb76c80f672a18f892c0f700e41"
 }

"event": {
  "userId": 9603417,
  "originalTriggerUuid": null,
  "boardId": 1772135370,
  "pulseId": 1772139123,
  "pulseName": "sub-item",
  "groupId": "topics",
  "groupName": "Subitems",
  "groupColor": "#579bfc",
  "isTopGroup": true,
  "columnValues": {},
  "app": "monday",
  "type": "create_pulse",
  "triggerTime": "2021-10-11T09:24:51.835Z",
  "subscriptionId": 73761697,
  "triggerUuid": "5c28578c66653a87b00a80aa4f7a6ce3",
  "parentItemId": "1771812716",
  "parentItemBoardId": "1771812698"
 }