Suche

Frag mich alles

Eine Automatisierung aus einer externen App auslösen

Verwende den Trigger „Webhook received", um eine ClickUp-Automatisierung zu starten, wenn eine externe App eine Anfrage sendet. Apps wie Stripe, GitHub oder eine benutzerdefinierte Integration können Daten in ClickUp senden, um deine Automatisierung auszuführen – ganz ohne Drittanbieter-Connector dazwischen.

Wenn eine Automatisierung von einer externen App gestartet werden soll, verwende den Trigger Webhook received. Dieser Trigger startet eine Standard- oder Chat-Automatisierung, wenn eine externe App eine POST-Anfrage an ClickUp sendet. Um stattdessen Daten aus ClickUp zu senden, verwende die Aktion Webhook aufrufen.

Der Trigger „Webhook received" ist ab dem Business-Plan verfügbar. Funktionsverfügbarkeit und Limits variieren je nach Plan und Benutzerrolle. Mehr erfahren

Was ist der Trigger „Webhook received"?

Mit dem Trigger „Webhook received" kann eine externe App Informationen in ClickUp senden, um eine Automatisierung zu starten.

image

Die Informationen, die die externe App sendet, sind der Payload. ClickUp generiert für jede Automatisierung, die diesen Trigger verwendet, eine eindeutige URL. Sendet eine App eine POST-Anfrage an diese URL, wird die Automatisierung ausgeführt.

Jede URL ist genau einer Automatisierung zugeordnet und läuft nicht ab.

Die ClickApp „Webhook received" aktivieren

Bevor Admins Automatisierungen mit diesem Trigger erstellen können, muss die ClickApp aktiviert werden:

  1. Klicke oben links auf deinen Workspace-Namen und wähle Apps.
  2. Suche nach Webhook received und aktiviere den Schalter.

So funktioniert die Authentifizierung

ClickUp erstellt einen API-Schlüssel für deinen Workspace. Alle Webhook-URLs im Workspace verwenden denselben API-Schlüssel. Sende den API-Schlüssel im Authorization-Header jeder Anfrage an die Webhook-URL. Anfragen ohne gültigen API-Schlüssel werden abgelehnt.

Standardmäßig können nur Workspace-Eigentümer und Admins den API-Schlüssel einsehen.

Verwende im Abschnitt „Trigger" Anzeigen, um den API-Schlüssel einzusehen, oder Kopieren, um ihn zu kopieren. Den API-Schlüssel findest du auch auf der ClickApp-Karte Webhook received und kannst dort ebenfalls Anzeigen oder Kopieren verwenden.

Eine Automatisierung mit dem Trigger „Webhook received" erstellen

In einem Space, Ordner, Unterordner, einer Liste oder einem Chat-Kanal:

  1. Klicke oben rechts auf das Roboter-Symbol.
  2. Klicke auf Automatisierung erstellen.
  3. Wähle den Trigger Webhook received. Eine eindeutige Webhook-URL wird generiert und dein Workspace-API-Schlüssel wird angezeigt.
  4. Klicke neben Webhook-URL auf Kopieren, um die URL zu kopieren. Klicke neben API-Schlüssel auf Kopieren, um den Schlüssel zu kopieren.
  5. Füge unter Beispiel-Payload einen JSON-Beispiel-Body ein. ClickUp wandelt dessen Felder in Variablen um, die du in den nachfolgenden Aktionen verwenden kannst.
  6. Wähle eine verfügbare Aktion aus.
  7. Klicke auf Erstellen.
  8. Um die Automatisierung auszuführen, sende eine POST-Anfrage an die Webhook-URL.
  9. Sende den API-Schlüssel als Rohwert im Authorization-Header. Eine gültige Anfrage gibt 202 zurück.
  10. Klicke im Abschnitt „Trigger" neben Webhook-URL auf Neu generieren, um eine neue URL zu erstellen. Die alte URL funktioniert danach nicht mehr und gibt 404 zurück.

Eingehende Anfragen sind auf 1 MB begrenzt. Das Rate Limit liegt bei 60 Anfragen pro Minute und API-Token sowie 200 Anfragen pro Minute und Workspace.

Den API-Schlüssel rotieren

So rotierst du den Workspace-API-Schlüssel:

  1. Klicke oben links auf deinen Workspace-Namen und wähle Apps.
  2. Suche nach Webhook received und wähle es aus.
  3. Klicke unter API-Schlüssel auf Rotieren.
  4. Der neue Schlüssel gilt für alle Webhook-URLs im Workspace. Der alte Schlüssel gibt für jede URL 401 zurück.

Aktualisiere den API-Schlüssel in jeder externen App, die Anfragen an den Workspace sendet.