WhatsApp-Benachrichtigungen aus ClickUp per Webhook
ClickUp hat keine eingebaute WhatsApp-Integration, aber eine eigene Webhook-API, die bei fast jeder Aktion an einer Aufgabe einen HTTP-Request abfeuern kann: eine Statusänderung, eine neue Aufgabe, eine geänderte Deadline oder ein zugewiesenes Teammitglied. Kombinierst du das mit der TextMeFlow-API, sendest du innerhalb weniger Minuten eine WhatsApp-Nachricht an einen Kunden oder Kollegen, sobald sich etwas an einer Aufgabe ändert.
Dieser Artikel zeigt den kürzesten Weg: ClickUp → dein eigener Webhook-Empfänger → die TextMeFlow-API. Zapier oder Make sind nicht nötig, du kannst diese Tools aber nutzen, wenn du keinen eigenen Endpunkt pflegen möchtest.
Einen ClickUp-Webhook anlegen
ClickUp hat in der Oberfläche keinen Button, um einen Webhook zu registrieren — das geht nur über die API selbst. Du sendest einen POST an https://api.clickup.com/api/v2/team/{team_id}/webhook mit deinem ClickUp-API-Token, der URL deines Empfängers und den Events, auf die du reagieren willst:
curl -X POST "https://api.clickup.com/api/v2/team/123456/webhook" \
-H "Authorization: $CLICKUP_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"endpoint": "https://jouw-domein.be/webhooks/clickup",
"events": ["taskStatusUpdated", "taskCreated", "taskDueDateUpdated"]
}'
ClickUp antwortet mit einer webhook_id und einem secret. Bewahre dieses Secret auf — jeder eingehende Webhook-Aufruf enthält einen X-Signature-Header, einen HMAC-SHA256 der Payload mit diesem Secret als Schlüssel. Prüfe diese Signatur, bevor du die Payload verarbeitest, sonst kann jeder, der die URL kennt, gefälschte Statusänderungen einspeisen.
// routes/api.php (Laravel)
Route::post('/webhooks/clickup', function (Illuminate\Http\Request $request) {
$expected = hash_hmac('sha256', $request->getContent(), config('services.clickup.secret'));
if (!hash_equals($expected, $request->header('X-Signature', ''))) {
abort(401);
}
$event = $request->input('event');
$taskId = $request->input('task_id');
// ... Änderung verarbeiten, siehe unten
return response()->json(['ok' => true]);
});
Vom ClickUp-Event zur WhatsApp-Nachricht
Jeder Webhook-Aufruf enthält den event-Typ und eine task_id, aber nicht immer die vollständigen Aufgabendaten. Für den neuen Status oder das Fälligkeitsdatum holst du in der Regel einen separaten GET /task/{task_id}-Aufruf dazu, oder du nutzt das Feld history_items, das manche Events bereits mitschicken. Verknüpfe die Telefonnummer über ein benutzerdefiniertes Feld oder eine eigene Zuordnungstabelle mit der Aufgabe und gib sie an die TextMeFlow-API weiter:
$phone = Task::where('clickup_task_id', $taskId)->value('whatsapp_number');
if ($phone && $event === 'taskStatusUpdated') {
$task = Http::withToken(config('services.clickup.token'))
->get("https://api.clickup.com/api/v2/task/{$taskId}")
->json();
Http::withToken(config('services.textmeflow.api_key'))
->post('https://textmeflow.eu/api/v1/messages', [
'to' => $phone,
'type' => 'text',
'text' => "Status-Update: „{$task['name']}\" steht jetzt auf „{$task['status']['status']}\".",
]);
}
Willst du kein eigenes Backend pflegen, baust du dieselben zwei Schritte (Signaturprüfung + Weiterleitung) auch in n8n oder Make — siehe unseren Leitfaden WhatsApp-Nachrichten senden aus n8n, Make.com oder Zapier für den Aufbau eines solchen Flows.
Welche Events sich lohnen
ClickUp sendet Dutzende von Event-Typen; für WhatsApp-Benachrichtigungen sind nur wenige relevant:
taskStatusUpdated— einen Kunden oder ein Teammitglied informieren, sobald eine Aufgabe auf „In Prüfung" oder „Abgeschlossen" wechselt.taskCreated— intern eskalieren, wenn eine neue dringende Aufgabe eingeht (nach Liste oder Tag filtern, sonst bekommst du für jede Aufgabe eine Nachricht).taskDueDateUpdated— eine Deadline-Erinnerung senden, wenn sich ein Fälligkeitsdatum verschiebt, kombiniert mit einem geplanten Cronjob, der täglich prüft, welche Aufgaben morgen fällig sind.
Abonniere nur die Events, die du auch wirklich verarbeitest — jeder zusätzliche Event-Typ erhöht die Zahl der Aufrufe an deinen Endpunkt ohne Nutzen.
Den Ablauf absichern und begrenzen
Neben der HMAC-Verifizierung von ClickUp selbst gilt auf der TextMeFlow-Seite deiner Integration dieselbe Regel: Jede Statusmeldung, die TextMeFlow zurückschickt (zum Beispiel „zugestellt" oder „fehlgeschlagen"), kommt mit einer eigenen HMAC-Signatur im Header, die du prüfen musst, bevor du sie verarbeitest. Die vollständige Erklärung steht in WhatsApp-Webhook-Signaturen verifizieren und in der Webhook-Dokumentation.
Behalte außerdem die Anti-Spam-Regeln auf der Sendeseite im Blick: Rate-Limits, ein Risiko-Score pro Nummer und automatische STOP-Verarbeitung sorgen dafür, dass deine WhatsApp-Nummer nicht überlastet wird, selbst wenn eine ClickUp-Liste plötzlich zehn Statusänderungen pro Minute weiterreicht.
Loslegen
Du brauchst nur einen TextMeFlow-API-Key, um diese Anbindung zu bauen. Der kostenlose Tarif gibt dir 50 Nachrichten pro Monat, um die Integration zu testen, bevor du auf einen bezahlten Tarif wechselst.
Selbst WhatsApp-Nachrichten per API senden?
Für immer gratis bis 50 Nachrichten/Monat. QR scannen und in 5 Minuten die erste Nachricht senden.
Für immer gratis