WhatsApp-Benachrichtigungen aus Jira-Issue-Webhooks
Die E-Mail-Zusammenfassungen und die Glocke in Jira lassen sich leicht ignorieren, besonders für Leute, die nicht den ganzen Tag in Jira sind – ein Support-Leiter, der auf einen Übergang nach „ready for QA" wartet, ein kundennaher Projektmanager, der in dem Moment Bescheid wissen muss, in dem ein blockierendes Issue wieder geöffnet wird. WhatsApp wird innerhalb weniger Minuten nach dem Eintreffen geöffnet. Diese Anleitung verbindet die eigenen Webhooks von Jira direkt mit der TextMeFlow-API, sodass aus einem Statuswechsel oder einer Neuzuweisung eine WhatsApp-Nachricht wird, ohne ein Automatisierungs-Abo dazwischen.
Warum direkt statt über ein Automatisierungstool
Jira kann bei Ereignissen zu erstellten, aktualisierten und gelöschten Issues sowie bei Kommentaren eine signierte JSON-Payload an jede beliebige URL senden. Betreibst du bereits ein Backend, ist es ein kleiner Route-Handler, diese Payload in eine WhatsApp-Nachricht umzuwandeln – nichts weiteres zu hosten, nichts weiteres, was unabhängig von deinem eigenen Stack ausfallen kann. Möchtest du diesen Endpunkt lieber weder schreiben noch pflegen, haben n8n, Make oder Zapier alle native Jira-Trigger und sind der schnellere Weg, wenn im Team niemand Code anfassen will.
Schritt 1: Den Webhook registrieren
Bei Jira Cloud verwaltest du Webhooks pro App, wenn du eine Connect-/Forge-App baust, oder – für ein einfacheres Setup auf deiner eigenen Instanz oder über einen von einem Admin angelegten Webhook – unter Settings → System → WebHooks (Jira-Administratorrechte erforderlich). Richte ihn auf deinen Endpunkt und wähle die Ereignisse, die dich interessieren:
URL: https://yourdomain.tld/jira-webhook
Events: jira:issue_updated, jira:issue_created
JQL filter: project = SUPPORT AND status changed
Der JQL-Filter ist wichtiger, als es aussieht – ohne ihn bekommst du jede Änderung an jedem Issue im Projekt, auch solche, für die niemand eine Handy-Benachrichtigung braucht.
Schritt 2: Die Payload verarbeiten und nach echten Änderungen filtern
Jira sendet bei jedem Ereignis das vollständige Issue-Objekt plus einen changelog-Block, der genau auflistet, welche Felder sich geändert haben. Gleiche darauf ab, statt die Änderung selbst abzuleiten:
// routes/web.php
Route::post('/jira-webhook', function (Request $request) {
$changelog = $request->input('changelog.items', []);
$statusChange = collect($changelog)->first(
fn ($item) => ($item['field'] ?? null) === 'status'
);
if (! $statusChange) {
return response()->json(['ok' => true]);
}
$issue = $request->input('issue', []);
$key = $issue['key'] ?? 'UNKNOWN';
$summary = $issue['fields']['summary'] ?? '';
$to = $statusChange['toString'] ?? '';
Http::withToken(config('services.textmeflow.api_key'))
->post('https://textmeflow.eu/v1/messages', [
'to' => config('services.jira_notify.phone'),
'text' => "{$key} ist nach {$to} gewechselt: {$summary}",
]);
return response()->json(['ok' => true]);
});
Eine Neuzuweisung funktioniert genauso – suche nach einem Changelog-Eintrag, dessen field assignee ist, und ermittle die Telefonnummer des neuen Bearbeiters aus deiner eigenen Benutzertabelle, statt einen einzelnen Empfänger fest zu codieren.
Schritt 3: An die richtige Person leiten, nicht an alle
Eine einzelne Nummer in der Config reicht für einen ersten Test, aber in der Produktion soll die Nachricht meist bei derjenigen Person ankommen, die als Nächstes für dieses Issue verantwortlich ist – der neue Bearbeiter bei einer Neuzuweisung, eine feste Support-WhatsApp-Gruppe bei einem Statuswechsel nach „Escalated". Halte diese Zuordnung in deiner eigenen Datenbank und nicht in Jira; Webhook-Payloads enthalten nur Jira-Konto-IDs, du brauchst also weiterhin eine Nachschlagetabelle, die diese mit Telefonnummern verknüpft. Muss ein Ereignis mehrere Personen erreichen, sende nacheinander mit kurzer Verzögerung und prüfe die 202-/429-Antwort von /v1/messages gemäß der Dokumentation zu den Rate Limits – eine Salve paralleler Anfragen für ein einziges Issue-Update auszulösen, ist der schnellste Weg, sie zu erreichen.
Den Endpunkt absichern
Jira-Webhooks sind bei einem Standard-Webhook auf Instanzebene nicht standardmäßig signiert – jeder, der die URL findet, könnte eine gefälschte Payload POSTen. Setze ein geheimes Token in den URL-Pfad oder in einen Header, den deine Route vor der Verarbeitung prüft, und halte diesen Endpunkt getrennt von der Verarbeitung eingehender WhatsApp-Nachrichten. Die eigenen eingehenden Webhooks von TextMeFlow nutzen eine echte HMAC-Signaturprüfung – die beiden Integrationen sind unabhängig voneinander und sollten keine gemeinsame Vertrauensannahme teilen, nur weil sie in derselben Codebasis liegen.
Erweiterungen
Dasselbe Muster der Changelog-Filterung deckt jedes Jira-Feld ab: Priorität auf Highest erhöht, ein Fälligkeitsdatum gesetzt, ein Kommentar von jemandem außerhalb des Teams. Kombiniere es mit den Webhook-Ereignissen von TextMeFlow, um den Kreis in beide Richtungen zu schließen – ein Kunde, der auf WhatsApp „freigegeben" antwortet, löst einen Aufruf der Jira-API aus, die das verknüpfte Issue automatisch weiterschaltet.
Loslegen
Der kostenlose Tarif von TextMeFlow enthält 50 Nachrichten pro Monat ohne Ablaufdatum, genug, um diese gesamte Jira-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