Zum Hauptinhalt springen

Webhooks

Erhalte Echtzeit-Benachrichtigungen in externen Tools, wenn sich etwas in awork ändert.

Verfasst von Isabel Helbig

Webhooks sind benutzerdefinierte HTTP-Callbacks für Ereignisse, die in awork stattfinden.


Hauptvorteile und Anwendungsfälle

  • Benachrichtige externe Tools über Änderungen, zum Beispiel wenn eine Aufgabe erstellt oder ein Projektstatus geändert wird

  • Rufe andere APIs bei bestimmten Ereignissen auf (zum Beispiel wenn eine neue Aufgabe oder Zeiterfassung erstellt wird)

  • Erstelle Automatisierungen oder Synchronisationen, damit User*innen Daten teilen und über verschiedene Tools hinweg zusammenarbeiten können

  • Entwickle individuelle Integrationen mithilfe von Webhooks und unserer API


So konfigurierst du einen neuen Webhook

Du benötigst zunächst einen Webhook-Endpunkt, damit du die Webhook-Anfrage empfangen und prüfen kannst.

Einen Webhook-Endpunkt erstellen

  • Verwende ein Tool (zum Beispiel Requestbin), um einen Webhook-Endpunkt zu erstellen

  • Kopiere die URL des Endpunkts

Den Webhook in awork hinzufügen

  • Navigiere zu Einstellungen > Integrationen

  • Öffne die Integrations-Bibliothek

  • Wähle in der Kategorie API-Konnektoren die Option Webhooks

  • Klicke auf Integration einrichten

Details eingeben, Ereignis auswählen und testen

  • Gib die erforderlichen Informationen wie Bezeichnung und URL ein

  • Aktiviere bei Bedarf die Authentifizierung

  • Klicke im Bereich Auslösende Event(s) auf Hinzufügen, um das awork-Ereignis auszuwählen, das den Webhook auslösen soll

  • Deaktiviere bei Bedarf Nur Events von Properties der ersten Ebene: Standardmäßig werden nur Events erster Ebene gesendet für Aufgaben-, Projekt- und Zeiterfassungs-Properties. Änderungen an verschachtelten Properties (wie z.B. Tags) werden ignoriert. Dies kann die Anzahl der Webhook-Requests erheblich reduzieren.

  • Teste den Webhook und prüfe die empfangene Anfrage in deinem Endpunkt-Tool

  • Klicke auf Speichern

Vorhandene Webhooks verwalten

Alle Webhooks werden auf der Integrationsseite unter Bereits integriert angezeigt.

Von hier aus kannst du:

  • Einen Webhook bearbeiten

  • Einen Webhook pausieren

  • Die Logs eines Webhooks prüfen

  • Einen Webhook löschen


Best Practices und Ressourcen

Sieh dir die folgenden zusätzlichen Ressourcen an:

Tipp: Wenn du Integrationen ohne Programmierung erstellen möchtest, nutze Zapier. Mit der awork-Zapier-Integration kannst du Projekte und Aufgaben erstellen oder erfasste Zeiten aus awork in andere Tools übertragen.


FAQ

Was sind Webhooks in awork?

Webhooks benachrichtigen externe Tools über Änderungen in awork, zum Beispiel wenn eine Aufgabe erstellt oder ein Projektstatus geändert wird.

Was kann ich mit Webhooks erstellen?

Du kannst bei bestimmten Ereignissen andere APIs aufrufen (zum Beispiel bei der Erstellung einer neuen Aufgabe oder Zeiterfassung), um Automatisierungen oder Synchronisationen zu erstellen.

Wo konfiguriere ich Webhooks in awork?

Gehe zu Einstellungen > Integrationen, öffne die Integrationsbibliothek und wähle Webhooks aus.

Wo kann ich bestehende Webhooks sehen und verwalten?

Du findest sie unter Bereits integriert auf der Integrationsseite. Dort kannst du Webhooks bearbeiten, pausieren, löschen oder Logs prüfen.

Kann ich statt Webhooks etwas anderes verwenden?

Ja. Als Alternative kannst du Zapier nutzen. Damit kannst du Tools integrieren, ohne selbst Code schreiben zu müssen.

Hat dies deine Frage beantwortet?