Erstelle eine Webhook-Automatisierung, um mit einer externen integrierten App zu kommunizieren, wenn ein bestimmtes Ereignis in einer ClickUp-Aufgabe eintritt.

Dieser Artikel behandelt das Senden von Daten aus ClickUp mit der Aktion Webhook aufrufen. Wenn stattdessen eine externe App eine Automatisierung in ClickUp starten soll, verwende den Webhook empfangen-Trigger.

In unserem Artikel Chat-Webhook-Automatisierung erstellen erfährst du alles über unsere Chat-Webhooks.

Verfügbarkeit und Limits von Funktionen variieren je nach Plan und Benutzerrolle. Mehr erfahren

Was sind Webhooks?

Webhooks sind eine automatisierte Methode, um Informationen aus ClickUp an deine Integrationen und andere Systeme zu senden.

Statt Informationen aktiv von ClickUp abzurufen, senden Webhooks sie proaktiv, damit die Daten in anderen Systemen immer aktuell bleiben.

Die Informationen, die ClickUp beim Auslösen oder Aufrufen eines Webhooks sendet, werden als Payload bezeichnet.

Bei Aufgaben-Webhooks enthält der Payload Informationen über die Aufgabe, die die Automatisierung in ClickUp ausgelöst hat.

Du kannst Webhooks auch über unsere öffentliche API einrichten. Weitere Informationen findest du in der Webhooks-Dokumentation.

Aktionen für „Webhook aufrufen"

In einem Space, Ordner, Unterordner oder einer Liste in ClickUp kannst du eine Automatisierung erstellen, die durch Aufgabenaktivität ausgelöst wird und einen Webhook als Automatisierungsaktion aufruft.

Die folgende Tabelle beschreibt die verfügbaren Aktionen:

Jede Aktion hat einen anderen Payload. Für neue Integrationen empfehlen wir die Aktion Webhook aufrufen.

URL-Header und Parameter verwenden

Verwende URL-Header und Parameter, um Details zum Webhook festzulegen, zum Beispiel:

• Den ClickUp-Speicherort, von dem der Webhook gesendet wird
• Den Endpunkt der externen App
• Oder den Medientyp des Anfrage-Bodys

URL-Header sind vertraulich. Nach dem Speichern kannst du die Header-Werte nicht mehr einsehen oder bearbeiten.

Im Folgenden findest du die von uns bereitgestellten Header sowie einige Hinweise zum Erstellen benutzerdefinierter Header:

Webhook erstellen, ohne eine Automatisierung anzulegen

So erstellst du einen Webhook, bevor du eine Automatisierung einrichtest – in einem Space, Ordner, Unterordner oder einer Liste:

1. Klicke oben rechts auf das Roboter-Symbol.
2. Klicke auf Automatisierungen verwalten.
3. Klicke auf den Webhooks-Tab.
4. Klicke auf Webhook erstellen.
5. Gib einen eindeutigen Titel ein.
6. Füge eine Beschreibung hinzu.
7. Gib deine Webhook-URL ein.
8. Wähle dynamische Felder aus, um sie in die URL aufzunehmen.
9. Füge benutzerdefinierte Header hinzu:
   • Standardmäßig enthalten Webhook-Header Content-type=application/json.
   • Klicke auf Hinzufügen, um weitere Schlüssel-Wert-Paare hinzuzufügen.
10. Füge optionale benutzerdefinierte URL-Parameter hinzu:
    • Gib einen Schlüssel und einen Wert ein, um benutzerdefinierte URL-Parameter hinzuzufügen.
    • Klicke auf Hinzufügen, um weitere Schlüssel-Wert-Paare hinzuzufügen.
11. Klicke auf Webhook testen, um einen Beispiel-Payload zu senden.
12. Klicke auf Webhook erstellen.

Einen vorhandenen Webhook in einer Automatisierung verwenden

So erstellst du eine Automatisierung mit einem vorhandenen Webhook – in einem Space, Ordner, Unterordner oder einer Liste:

1. Klicke oben rechts auf das Roboter-Symbol.
2. Klicke auf Automatisierung erstellen.
3. Wähle die Aktion Webhook aufrufen aus.
4. Wähle deinen Webhook aus dem Dropdownmenü aus.
5. Klicke auf Erstellen.

Webhook über die Aktion „Webhook aufrufen" erstellen

So erstellst du einen Webhook beim Erstellen einer Automatisierung – in einem Space, Ordner, Unterordner oder einer Liste:

1. Klicke oben rechts auf das Roboter-Symbol.
2. Klicke auf Automatisierung erstellen.
3. Wähle die Aktion Webhook aufrufen aus.
4. Klicke auf Webhook erstellen.
5. Gib einen eindeutigen Titel ein.
6. Füge eine Beschreibung hinzu.
7. Gib deine Webhook-URL ein.
8. Wähle dynamische Felder aus, um sie in die URL aufzunehmen.
9. Im Abschnitt Header ist der Content-Type standardmäßig auf application/json gesetzt.
   • Um einen benutzerdefinierten Header hinzuzufügen, klicke auf +Hinzufügen und gib einen Schlüssel und einen Wert ein.
10. Gib im Abschnitt URL-Parameter einen Schlüssel und einen Wert ein, um benutzerdefinierte Parameter hinzuzufügen.
11. Klicke auf Webhook testen, um einen Beispiel-Payload zu senden, bevor du deinen Webhook aktivierst.
12. Klicke auf Webhook erstellen.
13. Schließe die Konfiguration deines Automatisierungs-Triggers, der Bedingungen und weiterer Aktionen ab.
14. Klicke auf Erstellen.

Webhook testen

Nach dem Erstellen eines Webhooks kannst du ihn über den Webhooks-Tab testen, bearbeiten, löschen oder deaktivieren:

1. Fahre mit der Maus über den Webhook und klicke auf Testen.
2. Eine Benachrichtigung zeigt an, ob der Test erfolgreich war oder fehlgeschlagen ist.

Wenn der Test fehlschlägt

Prüfe, ob die externe App betriebsbereit ist. Ist sie ausgefallen, blockieren wir den Webhook-Aufruf möglicherweise aus Sicherheitsgründen.

Wenn der Test erfolgreich ist

Du kannst den Webhook bedenkenlos aktivieren und in Automatisierungen verwenden!

Fehlgeschlagener Webhook-Aufruf

Wenn dein Webhook aktiv ist und ein Webhook-Aufruf zunächst fehlschlägt, wiederholen wir den Versuch für 1 Stunde und 15 Minuten. In dieser Zeit wird der Aufruf in deinem Automatisierungen-Aktivitäts-Tab mit dem Status „Ausstehend" angezeigt.

Webhook deaktivieren

Nach der Aktivierung eines Aufgaben-Webhooks kannst du ihn inaktiv schalten.

Klicke im Webhooks-Tab auf den Schalter, um einen vorhandenen Webhook zu deaktivieren.

Alle Automatisierungen, die den Webhook verwenden, werden ebenfalls deaktiviert.

Die Aktion „Webhook aufrufen (Legacy)" verwenden

So verwendest du die Aktion „Webhook aufrufen (Legacy)" – in einem Space, Ordner, Unterordner oder einer Liste:

1. Klicke oben rechts auf das Roboter-Symbol.
2. Klicke auf Automatisierung erstellen.
3. Wähle die Aktion Webhook aufrufen (Legacy) aus.
4. Gib deine Webhook-URL ein.
5. Wähle dynamische Felder aus, um sie in die URL aufzunehmen.
6. Klicke auf Erstellen.