Ein Webhook ist eine automatisierte Nachricht, die von einer Anwendung an eine andere gesendet wird, wenn etwas passiert. Zum Beispiel kann ein Webhook konfiguriert werden, um Daten über einen neuen Datensatz, der in Blue erstellt wird, an ein anderes System zu senden.

Blue-Webhooks werden sofort, innerhalb von Millisekunden nach dem Auftreten des Ereignisses, ausgelöst. Diese Echtzeitnatur macht sie unverzichtbar für die Integration von Blue mit anderen Geschäftssystemen.

Webhooks

• Echtzeit-Datensynchronisierung über Systeme hinweg
• Fähigkeit, auf Blue-Ereignisse zu reagieren und Maßnahmen zu ergreifen
• Keine Notwendigkeit, wiederholt nach Änderungen zu suchen; sofortige Übertragung
• Erstellen Sie benutzerdefinierte Integrationen und Workflows

Unprecedented Control

Blue-Webhooks geben Ihnen eine feinkörnige Kontrolle über:

• Genau welche Ereignisse den Webhook auslösen sollen und aus welchem Projekt
• Filter, um den Umfang der Datensätze einzugrenzen
• Signaturvalidierung für verbesserte Sicherheit

Einen Webhook erstellen

In Blue können Projektadministratoren Webhooks unter den persönlichen Einstellungen erstellen. Sie geben an:

• Webhook-Name
• Payload-URL zum Senden von Daten
• Optionales Geheimnis für die Signatur

Trigger

Webhooks können durch eine Vielzahl von Blue-Ereignissen ausgelöst werden, einschließlich:

• Datensatz erstellt/aktualisiert/gelöscht
• Kommentar hinzugefügt/bearbeitet
• Zuweisung geändert
• Status der Checkliste geändert
• Wert des benutzerdefinierten Feldes geändert
• Und viele mehr

Webhook-Payload

Wenn sie ausgelöst werden, sendet Blue eine JSON-Payload, die alle Details des Ereignisses an Ihre angegebene URL enthält.

Hier ist ein Beispiel für eine Payload:

{
  "event": "RECORD_CREATED",
  "record": {
    "id": "1234",
    "title": "New record"
    ...
  },
  "company": {
    "id": "5678"  
  },
  "project": {
    "id": "91011"
  },
  "user": {
    "id": "1213" 
  }
}

Signatur

Um zu validieren, dass die Payloads tatsächlich von Blue stammen, kann eine optionale Signatur überprüft werden. Ähnlich wie bei OAuth wird die Signatur erstellt, indem der Inhalt der Payload mit Ihrem gewählten geheimen Schlüssel gehasht wird.

Beispielvalidierung in Node.js

const crypto = require('crypto');
const key = 'secret'; 
const body = {...webhookPayload} 
const hash = crypto.createHmac('sha256', key).update(body);
const signature = hash.digest('hex');

Zusätzliche Integrationen

Neben benutzerdefinierten Webhooks bietet Blue auch Integrationen mit Tools wie Zapier und Pabbly Connect, um die Verbindung von Blue-Daten mit Hunderten von beliebten Apps zu vereinfachen.

Beispiel Webhook-Antwort

{

  "event": "TODO_CREATED",

  "webhook": {

    "id": "clb4qaopy0000vt24mlp28v03",

    "uid": "edb5b5d51dc9461a952160dbe72153b4",

    "name": "Testing webhook",

    "url": "https://httpdump.app/dumps/7cc66eda-8e83-4039-ba49-4c36db14d508",

    "secret": "",

    "status": "HEALTHY",

    "enabled": true,

    "metadata": {

      "events": [

        "TODO_CREATED",

        "TODO_DELETED",

        "TODO_MOVED",

        "TODO_NAME_CHANGED",

        "TODO_CHECKLIST_CREATED",

        "TODO_CHECKLIST_NAME_CHANGED",

        "TODO_CHECKLIST_DELETED",

        "TODO_CHECKLIST_ITEM_CREATED",

        "TODO_LIST_CREATED",

        "TODO_LIST_DELETED",

        "TODO_LIST_NAME_CHANGED",

        "COMMENT_CREATED",

        "COMMENT_DELETED",

        "COMMENT_UPDATED"

      ],

      "projectIds": [

        "clakt90vu000bvt64hhffqleq",

        "claulnu1y0000vtrcjurjgds4",

        "clb4gay0y000qvtzs8smaays8"

      ]

    },

    "createdById": "claksl2ye0000vtas0h0ln71e",

    "createdAt": "2022-12-01T07:01:25.014Z",

    "updatedAt": "2022-12-01T11:23:00.661Z"

  },

  "currentValue": {

    "id": "clb4zna6x0000vt1swuwso25f",

    "uid": "11021cb836f34732b31e5ebd5dd5eb27",

    "title": "GGGG",

    "html": null,

    "text": null,

    "position": "32767.5",

    "archived": false,

    "done": false,

    "startedAt": null,

    "duedAt": null,

    "timezone": null,

    "createdAt": "2022-12-01T11:23:09.000Z",

    "updatedAt": "2022-12-01T11:23:09.241Z",

    "createdById": "claksl2ye0000vtas0h0ln71e",

    "todoListId": "clakt9v5t000kvt64f563l90l",

    "todoCustomFields": [],

    "todoUsers": [],

    "todoTags": [],

    "todoList": {

      "id": "clakt9v5t000kvt64f563l90l",

      "uid": "df0e931e6e8f4fc2905ece9da167d2d3",

      "createdAt": "2022-11-17T08:29:22.000Z",

      "updatedAt": "2022-11-17T08:29:22.050Z",

      "title": "ETEST",

      "position": 131070,

      "createdById": "claksl2ye0000vtas0h0ln71e",

      "projectId": "clakt90vu000bvt64hhffqleq",

      "project": {

        "id": "clakt90vu000bvt64hhffqleq",

        "uid": "d7db469a8908496f8e5f5e68030fe4c8",

        "slug": "teest",

        "name": "TEEST",

        "description": "",

        "archived": false,

        "createdAt": "2022-11-17T08:28:43.000Z",

        "updatedAt": "2022-11-17T08:28:42.811Z",

        "isTemplate": false,

        "isOfficialTemplate": false,

        "category": "GENERAL",

        "companyId": "clakt8jud0002vt64205yyj10",

        "imageId": null,

        "hideEmailFromRoles": null,

        "company": {

          "id": "clakt8jud0002vt64205yyj10",

          "uid": "400eb3f8238c486caf40957618be9662",

          "slug": "rogue",

          "name": "Rogue",

          "description": null,

          "createdAt": "2022-11-17T08:28:21.000Z",

          "updatedAt": "2022-11-17T08:28:20.726Z",

          "freeTrialExpiredAt": "2022-12-01T08:28:15.000Z",

          "freeTrialStartedAt": "2022-11-17T08:28:15.000Z",

          "subscribedAt": null,

          "imageId": null,

          "subscriptionPlanId": "clakt8jue0003vt64e40q2prj",

          "freeTrialExtendedById": null,

          "freeTrialExtendedAt": null

        }

      }

    }

  }

}