Webhooks ermöglichen es, auf Ereignisse (Events) in Clockodo in Echtzeit zu reagieren. Bei Eintritt eines definierten Events sendet unser System automatisch eine HTTP-POST-Anfrage an eine von Ihnen angegebene URL. So können Sie eigene Workflows anstoßen oder externe Systeme automatisieren und synchronisieren.
| Entity | Event-Typen | |
|---|---|---|
| User (Benutzer) |
• user.created (Erstellung) • user.updated (Aktualisierung) • user.deleted (Löschung) | |
| Absence (Abwesenheit) |
• absence.created (Erstellung) • absence.updated (Aktualisierung) • absence.deleted (Löschung) • absence.approved (Genehmigung) | |
| Customer (Kunde) |
• customer.created (Erstellung) • customer.updated (Aktualisierung) • customer.deleted (Löschung) | |
| Project (Projekt) |
• project.created (Erstellung) • project.updated (Aktualisierung) • project.deleted (Löschung) • project.completed (Abschluss) | |
| Subproject (Unterprojekt) |
• subproject.created (Erstellung) • subproject.updated (Aktualisierung) • subproject.deleted (Löschung) | |
| Service (Leistung) |
• service.created (Erstellung) • service.updated (Aktualisierung) • service.deleted (Löschung) | |
| Team |
• team.created (Erstellung) • team.updated (Aktualisierung) • team.deleted (Löschung) | |
| Lump Sum Service (Pauschalleistung) |
• lump_sum_service.created (Erstellung) • lump_sum_service.updated (Aktualisierung) • lump_sum_service.deleted (Löschung) | |
| Holidays Carry (Urlaubsübertrag) |
• holidays_carry.created (Erstellung) • holidays_carry.updated (Aktualisierung) • holidays_carry.deleted (Löschung) | |
| Holidays Quota (Urlaubskontingent) |
• holidays_quota.created (Erstellung) • holidays_quota.updated (Aktualisierung) • holidays_quota.deleted (Löschung) | |
| Overtime Carry (Überstundenübertrag) |
• overtime_carry.created (Erstellung) • overtime_carry.updated (Aktualisierung) • overtime_carry.deleted (Löschung) | |
| Nonbusiness Group (Feiertagsgruppe) |
• nonbusiness_group.created (Erstellung) • nonbusiness_group.updated (Aktualisierung) • nonbusiness_group.deleted (Löschung) | |
| Work Time Change Request (Antrag auf Änderung der Arbeitszeit) |
• work_time_change_request.created (Erstellung) • work_time_change_request.updated (Aktualisierung) • work_time_change_request.deleted (Löschung) | |
| Entry (Zeiteintrag) |
• entry.created (Erstellung) • entry.updated (Aktualisierung) • entry.deleted (Löschung) • entry.started (Start) • entry.stopped (Stop) |
Unter Webhooks im Menü können Sie einen neuen Webhook anlegen oder einen bestehenden bearbeiten. Wählen Sie dabei das gewünschte Event (siehe Tabelle oben), geben Sie die Ziel-URL sowie ein Token an.
Beim erstmaligen Anlegen oder Ändern der URL muss der Webhook validiert werden. Dies dient der Sicherheit und stellt sicher, dass die Ziel-URL auch tatsächlich von Ihnen verwaltet wird.
Zur Validierung sendet Clockodo einen POST-Request an die von Ihnen angegebene URL mit folgendem Payload:
{
"secret": "8ee3d438-fbfc-411c-a38a-25893becd505"
}Das so erhaltene Secret tragen Sie entsprechend in der Eingabemaske in Clockodo ein.
Jeder Webhook-Call wird als HTTP POST im JSON-Format an die konfigurierte URL gesendet. Das generelle Format ist wie folgt:
{
"subscription_id": 42,
"company_id": 1337,
"occurred_at": "1986-05-10T17:02:00Z",
"payload": {
"team": {
"id": 9001
}
},
"event_name": "team.updated",
"token": "My_Sup3r_T0k3n"
}Wir senden ausschließlich die ID der geänderten, erstellten oder gelöschten Entität und keine vollständigen Datensätze oder Deltas.
Dies hat mehrere Vorteile:
Bechtle
Peerigon GmbH
Phoenix Logistik
Fidea