Erstelle eine Chat-Webhook-Automatisierung, um mit einer externen integrierten App zu kommunizieren, wenn ein bestimmtes Ereignis in ClickUp eintritt. Wenn beispielsweise eine Chat-Nachricht in einem bestimmten Channel gepostet wird, wird sie automatisch auch an Zapier oder Make weitergeleitet.

Du kannst auch Webhooks mit Aufgaben-Automatisierungen verwenden.

Verfügbarkeit und Limits von Funktionen variieren je nach Plan und Benutzerrolle. Weitere Informationen

Automatisierungs-Trigger, -Aktionen, URL-Header und -Parameter verwenden

Trigger sind Ereignisse, die eine Automatisierung starten.

Nachricht wird gepostet ist der einzige Chat-Webhook-Trigger.

Aktionen sind die Ereignisse, die die Automatisierung nach dem Auslösen ausführt. Um einen Webhook aufzurufen, verwende die Aktion Webhook aufrufen.

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

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

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

Eine Chat-Webhook-Automatisierung erstellen

So erstellst du eine Chat-Webhook-Automatisierung, ausgehend von einem Channel:

1. Klicke oben rechts auf das Roboter-Symbol.
2. Klicke auf Automatisierung erstellen.
3. Konfiguriere deinen Trigger, deine Bedingungen und deine Aktionen:
   • Wähle die Aktion Webhook aufrufen aus.
   • Wähle einen vorhandenen Webhook aus oder klicke auf Webhook erstellen:
   • Gib deinem Webhook einen Namen und optional eine Beschreibung.
   • Gib deine Webhook-URL ein.
   • Wähle die folgenden dynamischen Felder aus, um sie in die URL aufzunehmen.
   • Kommentar-ID: Füge die einzelne Chat-Kommentar-ID hinzu.
   • Channel-ID: Füge die Chat-Channel-ID hinzu.
   • Füge optionale benutzerdefinierte Header hinzu:
   • Klicke auf Hinzufügen und gib dann einen Schlüssel und einen Wert ein.
   • Webhook-Header enthalten standardmäßig Content-type=application/json.
   • 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.
4. Klicke auf Webhook erstellen.

Eine Chat-Webhook-Automatisierung testen

Nach dem Erstellen des Webhooks kannst du ihn in ClickUp testen.

So testest du eine Chat-Webhook-Automatisierung:

1. Klicke direkt nach dem Erstellen des Webhooks oben links im Automatisierungs-Modal auf das Caret. Oder gehe von einem Channel aus vor:
   • Klicke auf das Roboter-Symbol.
   • Wähle Chat-Automatisierungen verwalten aus.
   • Klicke auf den Tab Webhooks.
2. Fahre mit der Maus über den Webhook und klicke auf Testen.
   • Es wird eine Benachrichtigung angezeigt, die Erfolg oder Misserfolg angibt.

Wenn der Test fehlschlägt

Du kannst prüfen, ob die externe App verfügbar ist. Wenn sie nicht erreichbar ist, blockieren wir den Webhook-Aufruf möglicherweise aus Sicherheitsgründen.

Wenn der Test erfolgreich ist

Wenn der Test erfolgreich ist, kannst du den Chat-Webhook in einer Automatisierung aktivieren.

Eine Chat-Automatisierung mit einem vorhandenen Webhook erstellen

Nach dem Testen des Chat-Webhooks aktivierst du ihn in deinem Workspace.

So aktivierst du den Chat-Webhook:

1. Wähle direkt nach dem Testen des Webhooks im Automatisierungs-Modal den Tab Verwalten aus.
2. Klicke auf Automatisierung hinzufügen.
3. Konfiguriere deinen Trigger, deine Bedingungen und deine Aktionen:
   • Wähle die Aktion Webhook aufrufen aus.
   • Wähle deinen Webhook aus.
4. Klicke auf Erstellen.

Fehlgeschlagener Webhook-Aufruf

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

Den Chat-Webhook deaktivieren

Nachdem der Chat-Webhook aktiviert wurde, kannst du ihn wieder deaktivieren.

So deaktivierst du den Chat-Webhook, ausgehend von einem Channel:

1. Klicke oben rechts auf das Roboter-Symbol.
2. Wähle Chat-Automatisierungen verwalten aus.
3. Klicke auf den Tab Webhooks.
4. Klicke rechts neben deinem Webhook auf den Umschalter, um ihn zu deaktivieren.
5. Lies die Warnung, dass Automatisierungen, die den Webhook verwenden, ebenfalls deaktiviert werden.
6. Klicke auf Deaktivieren.
7. Der Chat-Webhook wird jetzt im Tab Inaktiv angezeigt.

Um den Chat-Webhook wieder zu aktivieren, öffne den Tab „Inaktiv" und schalte den Umschalter ein.

Header-Schlüssel und -Werte

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