WhatsApp-Benachrichtigungen aus Asana-Webhooks senden
Die eigenen Benachrichtigungen von Asana gehen schnell unter: Zwischen jedem Kommentar, jeder Teilaufgabe und jeder „hat diese Aufgabe geliked"-Mail verschwindet das eine Update, das dir wirklich wichtig ist (ein kundenrelevantes Ergebnis als erledigt markiert, eine Aufgabe an jemanden im Urlaub übergeben). WhatsApp hat dieses Problem nicht: Man öffnet es innerhalb weniger Minuten. Dieser Leitfaden baut eine direkte Webhook-Brücke von Asana zu WhatsApp — ohne Umweg über ein Automatisierungstool eines Drittanbieters.
Warum direkt statt über Zapier oder Make
Asana-Webhooks senden für jede Änderung in einem Projekt eine signierte JSON-Payload an eine URL, die du kontrollierst: Aufgabe erstellt, Aufgabe erledigt, Zuständige Person geändert, Fälligkeitsdatum verschoben. Betreibst du bereits ein Backend, ist die Übersetzung dieser Payload in eine WhatsApp-Nachricht eine Sache von etwa einem Dutzend Zeilen Code — kein separates Abo, kein zusätzlicher Dienst, der unabhängig von deinem eigenen Stack ausfallen kann. Wenn du diesen Endpunkt lieber nicht selbst betreiben möchtest, bieten n8n, Make oder Zapier alle Asana-Trigger und bleiben der schnellere Weg für Teams, die gar keinen Code anfassen wollen.
Schritt 1: den Webhook registrieren
Asana-Webhooks legst du per POST an deren API an, gerichtet auf die Ressource, die du beobachten willst (meist eine Projekt-GID), und die Callback-URL, die die Events empfängt.
curl -X POST "https://app.asana.com/api/1.0/webhooks" \
-H "Authorization: Bearer YOUR_ASANA_TOKEN" \
-d "resource=PROJECT_GID" \
-d "target=https://yourdomain.tld/asana-webhook"
Asana führt vor der Aktivierung des Webhooks einen Handshake durch: Es sendet einen leeren POST mit einem X-Hook-Secret-Header an deine Callback-URL und erwartet, dass du denselben Header innerhalb weniger Sekunden in deiner Antwort zurückgibst. Dein Endpunkt muss also live und erreichbar sein, bevor du den Webhook registrierst — nicht erst danach.
// routes/web.php
Route::post('/asana-webhook', function (Request $request) {
if ($secret = $request->header('X-Hook-Secret')) {
return response('', 200)->header('X-Hook-Secret', $secret);
}
// handle real events below
return response()->json(['ok' => true]);
});
Schritt 2: nur die gewünschten Events herausfiltern
Asana bündelt mehrere Änderungen in einer einzigen Webhook-Zustellung, du bekommst also einen Strom von events in einer Payload. Die meisten davon sind Rauschen (eine Aufgabe wandert in einen anderen Abschnitt, ein Follower wird hinzugefügt), außer du filterst auf die gewünschte Kombination aus action und resource_type — typischerweise action: "changed" auf dem Feld completed einer Aufgabe oder parent-Änderungen bei einer Neuzuweisung.
Route::post('/asana-webhook', function (Request $request) {
if ($secret = $request->header('X-Hook-Secret')) {
return response('', 200)->header('X-Hook-Secret', $secret);
}
foreach ($request->input('events', []) as $event) {
if (($event['action'] ?? null) !== 'changed'
|| ($event['resource']['resource_type'] ?? null) !== 'task') {
continue;
}
$change = $event['change']['field'] ?? null;
if ($change !== 'completed') {
continue;
}
Http::withToken(config('services.textmeflow.api_key'))
->post('https://textmeflow.eu/v1/messages', [
'to' => config('services.asana_notify.phone'),
'text' => "Task {$event['resource']['gid']} was marked complete in Asana.",
]);
}
return response()->json(['ok' => true]);
});
Die Aufgaben-Payload eines changed-Events liefert standardmäßig nur eine GID — rufe mit deinem Asana-Token GET /api/1.0/tasks/{gid} ab, wenn du in der WhatsApp-Nachricht den echten Aufgabennamen statt einer kryptischen ID haben willst.
Schritt 3: ein Team benachrichtigen, nicht nur eine Nummer
Eine einzelne Telefonnummer in der Konfiguration reicht zum Testen, aber in der Produktion willst du meist das ganze Team erreichen oder je nach Zuweisung eine bestimmte Person. Sende an eine WhatsApp-Gruppe, wenn das Update für alle relevant ist, oder schlage die Nummer der zuständigen Person in deiner eigenen Nutzertabelle nach und sende 1:1. In beiden Fällen solltest du die Rate-Limits im Blick behalten: Wenn ein Event mehrere Empfänger erreichen soll, sende nacheinander mit kurzer Pause statt Requests parallel abzufeuern, und prüfe die 202/429-Antwort von /v1/messages, um zu wissen, ob ein Versand tatsächlich in die Queue gekommen ist.
Den Endpunkt absichern
Asana signiert Zustellungs-Payloads nicht mit etwas, das TextMeFlows eigener HMAC-Verifizierung für eingehende WhatsApp-Antworten vergleichbar wäre — das X-Hook-Secret deckt nur den Handshake ab, nicht jedes weitere Event. Speichere das Secret, das Asana dir beim Handshake gibt, und verlange es bei jedem späteren Aufruf deines Endpunkts als Header (oder als geheimen Query-Parameter), damit es sich nicht von Dritten fälschen lässt, die die URL erraten. Verarbeitest du im selben Backend auch eingehende WhatsApp-Nachrichten, leite diese durch TextMeFlows ordentliche Webhook-Signaturprüfung — die beiden Integrationen sind unabhängig voneinander und sollten keine gemeinsame Vertrauensannahme teilen.
Erweitern
Dasselbe Muster deckt weitere Asana-Trigger ab: eine neue Aufgabe in einem bestimmten Projekt, ein Fälligkeitsdatum innerhalb von 24 Stunden, ein benutzerdefiniertes Feld, das den Status wechselt. Kombiniere es mit TextMeFlows eigenen Webhook-Events, wenn du den Kreis in beide Richtungen schließen willst — zum Beispiel ein Kunde, der auf WhatsApp „approved" antwortet, woraufhin die verknüpfte Asana-Aufgabe über die Asana-API automatisch als erledigt markiert wird.
Loslegen
Willst du es selbst ausprobieren? Der kostenlose Tarif von TextMeFlow enthält 50 Nachrichten pro Monat ohne Ablaufdatum — genug, um diese gesamte Asana-Integration zu bauen und zu testen, bevor du etwas bezahlst. Kostenlos starten.
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