Auf der monday.com Plattform kannst du über unsere Integrationen einen Webhook senden oder sogar über die API erstellen. Du kannst jedes Mal einen Webhook senden, wenn ein ausgewähltes Ereignis in deinem Board auftritt. Lies weiter, um mehr zu erfahren.

Was ist ein Webhook?

Webhook (auch Web-Callback oder HTTP-Push-API genannt) ist eine Möglichkeit für eine App, anderen Anwendungen Echtzeitinformationen bereitzustellen.Ein Webhook liefert Daten an andere Anwendungen, sobald eine Änderung erfolgt, d.h. Man erhält Daten sofort, im Gegensatz zu typischen APIs, bei denen sehr häufig nach Daten abgefragt werden muss, um sie in Echtzeit zu erhalten.Dies macht Webhooks sowohl für den Anbieter als auch für den Verbraucher viel effizienter.

So erstellst du einen neuen Webhook 

Klicke in deinem Board auf den Button Integrationen auf der rechten Seite deines Bildschirms, klicke anschließend auf den Tab Erstellen und suche auf der Automatisierungen-Seite des Boards nach der Integration Webhooks:

Klicke dann auf den Banner „Webhooks“ und wähle die Aktion aus, für die du sofortige Nutzlasten erhalten möchtest:

Nachdem du die gewünschte Aktion ausgewählt hast, musst du die URL angeben.Dies sollte eine URL sein, die die JSON-Challenge zurückgeben kann, und sie wird der Empfänger der weiterführenden Nutzlasten sein:

Und das war‘s!Sobald diese Änderung erfolgt, beispielsweise ein neues Element zu deinem Board hinzugefügt wird, erhält dein Endpunkt eine Nutzlast über die Änderung.Einige Nutzlasten findest du weiter unten.

Füge eine Beschreibung hinzu, um zu erläutern, wie deine Webhook-Integration in deinem Workflow verwendet wird. So kann jeder Benutzer, der diese Integration nutzt, besser verstehen, was ihr Zweck ist und wie sie sich in den Workflow einfügt. 

So verifizierst du eine Webhook-URL

{
 challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
}

{
 challenge: “3eZbrw1aBm2rZgRNFdxV2595E9CY3gmdALWMmHkvFXO7tYXAYM8P”
}

Hier ist ein einfaches Beispiel für einen Webhook-Listener, der die Ausgabe des Webhooks druckt und korrekt auf die Challenge reagiert:

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

Wie werden die Ereignisdaten aussehen?

{
 "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"
 }