Das Aktivieren der Webhook-Integration ermöglicht es absentify, ein Skript auf deinem Server aufzurufen, wenn ein oder mehrere Ereignisse im absentify-System auftreten.

Webhooks können als Ereignisbenachrichtigungen oder Push-Benachrichtigungen betrachtet werden. Sie ermöglichen es dir, Integrationen zu erstellen oder einzurichten, die sich auf bestimmte Ereignisse bei absentify abonnieren. Wenn eines dieser Ereignisse ausgelöst wird, senden wir eine HTTP POST-Nutzlast an die konfigurierte URL des Webhooks.

Webhooks können verwendet werden, um ein externes System zu aktualisieren oder sogar Benachrichtigungen an deine E-Mail-Adresse zu senden. Du erhältst Benachrichtigungen von absentify, wann immer Anträge erstellt oder aktualisiert werden, sodass du Integrationen auf absentify aufbauen kannst.

Los geht's

Das Konfigurieren von Webhooks kann einfach über die Einstellungen - Seite erfolgen.

Melde dich zuerst als Admin an, klicke dann in der oberen Kopfzeile auf Einstellungen und anschließend auf Integrationen.

Klicke auf URL konfigurieren.

Wähle im Dropdown-Menü das gewünschte Ereignis aus, das du mit deinem Endpunkt verknüpfen möchtest:

Alle
Antrag erstellt
Antragsstatus geändert

Gib den gewünschten Endpunkt ein und klicke auf Hinzufügen, um die Integration abzuschließen.

Webhook-Antwort

Wenn absentify eine Webhook-URL auf deiner Seite auslöst, werden die Daten im folgenden Format gesendet:

{
   "body":{
      "id":"a2032774-7d41-4820-8858-0e0ec37e64d3",
      "request_creator_member":{
            "email":"sample@user.com",
            "name":"Sample User",
            "id":"c67c0681-db0b-4bc5-8759-020643f618b0",
            "custom_id":""
      },
      "createdAt":"2023-02-10T21:29:32.774Z",
      "updatedAt":"2023-02-10T21:29:32.772Z",
      "start":"2023-02-13T00:00:00.000Z",
      "start_at":"afternoon",
      "end":"2023-02-13T00:00:00.000Z",
      "end_at":"end_of_day",
      "duration":0.5,
      "year":2023,
      "details":{
         "status":"APPROVED",
         "deducted":0.5,
         "reason":"",
         "approval_process":"Linear_all_have_to_agree",
         "request_approvers":[
            {
               "id":283860,
               "approver_member":{
                  "email":"sample@user.com",
                  "name":"Sample User",
                  "id":"c67c0681-db0b-4bc5-8759-020643f618b0",
                  "custom_id":""
               },
               "reason":null,
               "status":"APPROVED",
               "status_change_date":null,
               "predecessor_request_approver_id":null
            }
         ],
         "requester_member":{
            "email":"sample@user.com",
            "name":"Sample User",
            "id":"c67c0681-db0b-4bc5-8759-020643f618b0",
            "custom_id":"",
            "allowances":[
               {
                  "allowance":30,
                  "brought_forward":10.5,
                  "compensatory_time_off":0,
                  "remaining":38.5,
                  "taken":2,
                  "year":2023
               },
               {
                  "allowance":30,
                  "brought_forward":14.5,
                  "compensatory_time_off":0,
                  "remaining":10.5,
                  "taken":34,
                  "year":2022
               },
               {
                  "allowance":30,
                  "brought_forward":38.5,
                  "compensatory_time_off":0,
                  "remaining":68.5,
                  "taken":0,
                  "year":2024
               },
               {
                  "allowance":14.5,
                  "brought_forward":0,
                  "compensatory_time_off":0,
                  "remaining":14.5,
                  "taken":0,
                  "year":2021
               }
            ]
         },
         "leave_type":{
            "id":"b9362b30-251d-4ba8-929b-181d9afcc924",
            "name":"Holiday"
         },
         "cancel_reason":null,
         "canceld_date":null,
         "canceld_by_member":null
      }
   }
}

Aktualisiert am: 20/06/2024