WhatsApp-Alerts für CI/CD-Fehler und Uptime-Monitoring
Slack und E-Mail reichen für Alerts, die du irgendwann bemerkst. Für solche, die innerhalb von fünf Minuten eine Reaktion brauchen – ein fehlgeschlagenes Produktions-Deploy, ein Server, der nicht mehr antwortet –, reichen sie nicht. Um 2 Uhr nachts hat niemand die Slack-Benachrichtigungen auf voller Lautstärke, aber fast jeder sieht eine eingehende WhatsApp-Nachricht. Da TextMeFlow nur eine REST-API hinter einer Telefonnummer ist, genügen ein paar Zeilen, um es an eine CI-Pipeline oder einen Uptime-Monitor anzubinden – ganz ohne ein neues Bereitschaftstool einzuführen.
Einen Alert aus einem GitHub-Actions-Workflow senden
Der einfachste Fall: ein Schritt, der nur läuft, wenn ein vorheriger Job fehlschlägt, und einen POST an /v1/messages abfeuert.
- name: Notify on failure
if: failure()
run: |
curl -sS -X POST https://api.textmeflow.eu/v1/messages \
-H "Authorization: Bearer ${{ secrets.TEXTMEFLOW_API_KEY }}" \
-H "Content-Type: application/json" \
-d '{
"to": "+32472932208",
"text": "Deploy fehlgeschlagen: ${{ github.repository }} @ ${{ github.sha }} (Run ${{ github.run_id }})",
"urgent": true
}'
Speichere den API-Key als Repository-Secret, nie in der Workflow-Datei selbst. Die Antwort ist ein 202 mit einer message_id, die du loggen kannst, wenn du die Zustellung später über GET /v1/messages/{id} bestätigen willst. Nimm Commit-SHA und Run-ID in den Text auf – ein nacktes „Build fehlgeschlagen“ zwingt den Leser ohnehin dazu, GitHub zu öffnen, und das verfehlt den Sinn eines Push-Alerts.
Webhooks von Uptime-Monitoren weiterleiten
Die meisten Uptime-Tools (selbst gehostete wie Uptime Kuma oder externe mit generischer Webhook-Integration) rufen bei jedem Up/Down-Wechsel bereits deine URL mit einem JSON-Body auf – sie wissen nur nicht, wie sie direkt mit der TextMeFlow-API sprechen. Die Lösung ist ein winziger Relay-Endpunkt in deinem vorhandenen Stack, der deren Payload in einen TextMeFlow-Versand übersetzt:
// Express-Relay: empfängt den Webhook des Monitors, sendet ihn weiter an TextMeFlow
app.post('/alerts/uptime', express.json(), async (req, res) => {
const { monitor, status, msg } = req.body; // Form hängt von deinem Monitor ab
if (status === 'down') {
await fetch('https://api.textmeflow.eu/v1/messages', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.TEXTMEFLOW_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
to: process.env.ONCALL_NUMBER,
text: `${monitor} is DOWN: ${msg}`,
urgent: true,
}),
});
}
res.sendStatus(200);
});
Halte dieses Relay bewusst schlicht: eine Aufgabe (Payload-Form übersetzen, weiterleiten), keine eigene Wiederholungslogik. Schlägt der TextMeFlow-Aufruf fehl, lass das Retry/Backoff deines Monitors den Webhook erneut senden, statt eine zweite Wiederholungsschicht darüberzulegen.
Ruhezeiten umgehen – aber nur bei echten Vorfällen
TextMeFlow verzögert nicht dringende Nachrichten, die zwischen 22:00 und 08:00 Uhr Ortszeit des Empfängers gesendet werden, damit eine Erinnerung niemanden weckt. Bei einem echten Vorfall ist das genau das Gegenteil dessen, was du willst – deshalb gibt es das Feld urgent: true, das die Ruhezeiten-Steuerung komplett überspringt. Nutze es nur für Alarme, die außerhalb der Bürozeiten wirklich eine Reaktion verlangen; die Anti-Spam-Pipeline hebt den Risiko-Score deines Kontos bei jedem erzwungenen Versand in den Ruhezeiten leicht an, was bei einer Handvoll echter Vorfälle pro Monat in Ordnung ist und nicht für das Alltagsrauschen der CI gedacht. Leite deine instabilen, automatisch wiederholten Testfehler an Slack und spare dir urgent-Sendungen für die Alarme auf, für die du jemanden anrufen würdest.
Lass einen Alert-Sturm nicht dein eigenes Ratenlimit sprengen
Fallen zehn Services in derselben Minute aus, versucht dein Monitoring brav, zehn WhatsApp-Nachrichten in genau dieser Minute zu senden – gegen dasselbe Ratenlimit und dasselbe Monatskontingent wie jeder andere Verkehr auf deinem Konto. Zwei Dinge baust du am besten von Anfang an ein: Debouncing an der Quelle (eine Zusammenfassung pro flackerndem Vorfall, nicht eine Nachricht pro Check) und die Behandlung von 429-Antworten der API wie überall sonst – siehe Ratenlimits und Nachrichtenstatus behandeln für Retry-/Backoff-Code in Node und Python. Besteht deine Bereitschaftsrotation aus mehr als fünf Personen und du bist versucht, denselben Text an alle gleichzeitig zu schicken, variiere die Nachricht leicht (Name, Rolle oder einfach die Eskalationsstufe des Empfängers) – derselbe Text an mehr als fünf verschiedene Nummern innerhalb von zehn Minuten löst die Broadcast-Erkennung aus, die für Marketing-Blasts gedacht ist, nicht für Alarmierungen. Die genauen Limits pro Tarif stehen in der Dokumentation zu Ratenlimits.
Erste Schritte
Du brauchst keinen kostenpflichtigen Tarif, um das aufzusetzen: Die 50 Nachrichten pro Monat des kostenlosen Tarifs, ohne Ablaufdatum, reichen, um einen GitHub-Actions-Schritt oder ein Uptime-Monitor-Relay von Anfang bis Ende zu testen, bevor es echte Alarme überträgt. Die vollständige Request-/Response-Form findest du in der API-Referenz, dann starte kostenlos und lass noch heute deinen ersten Alert zu einem fehlgeschlagenen Deploy auf deinem Handy landen.
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