WhatsApp-Nachrichten aus Firebase Cloud Functions senden
Wenn deine App auf Firebase läuft, liegen die Daten, die eine WhatsApp-Nachricht auslösen sollen — eine neue Bestellung, eine Statusänderung, eine Buchung — bereits in Firestore. Statt diese Daten von außen abzufragen, kann eine Cloud Function direkt auf den Write reagieren und im selben Zug die TextMeFlow-API aufrufen. Kein separates Backend, kein Cronjob, der alle paar Minuten prüft, ob sich etwas geändert hat.
Dieser Artikel behandelt die zwei Trigger, die du in der Praxis brauchst: eine onDocumentWritten-Funktion für Firestore für alles, was an einem einzelnen Dokument hängt, und eine geplante Funktion für Erinnerungen, die nach der Uhr statt nach einer Änderung auslösen.
API-Key als Secret speichern, nicht als Umgebungsvariable
Cloud Functions (2. Generation) unterstützt Secret Manager nativ, und genau dort gehört ein tmf_-API-Key hin — nie in .env, nie zusammen mit firebase.json committet. Einmalig anlegen:
firebase functions:secrets:set TEXTMEFLOW_API_KEY
Du wirst aufgefordert, den Wert einzufügen, und Firebase speichert ihn in Google Secret Manager statt im Code oder der Konfiguration deiner Funktion.
Auf einen Firestore-Write reagieren
Angenommen, du hast eine Sammlung orders und willst eine WhatsApp-Nachricht in dem Moment, in dem das Feld status eines Dokuments auf shipped wechselt. Mit dem Firebase Functions v2 SDK:
const { onDocumentUpdated } = require("firebase-functions/v2/firestore");
const { defineSecret } = require("firebase-functions/params");
const textmeflowKey = defineSecret("TEXTMEFLOW_API_KEY");
exports.notifyOrderShipped = onDocumentUpdated(
{ document: "orders/{orderId}", secrets: [textmeflowKey] },
async (event) => {
const before = event.data.before.data();
const after = event.data.after.data();
if (before.status === after.status || after.status !== "shipped") {
return;
}
const res = await fetch("https://api.textmeflow.eu/v1/messages", {
method: "POST",
headers: {
Authorization: `Bearer ${textmeflowKey.value()}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
to: after.customerPhone,
text: `Deine Bestellung #${after.orderNumber} wurde versendet und ist auf dem Weg.`,
}),
});
if (!res.ok) {
const body = await res.text();
throw new Error(`TextMeFlow-Versand fehlgeschlagen: ${res.status} ${body}`);
}
}
);
Die Prüfung before.status === after.status ist wichtiger, als sie aussieht: Ein Firestore-Trigger löst auch bei Writes aus, die nur ein anderes Feld desselben Dokuments betreffen — ohne diese Prüfung würdest du eine doppelte WhatsApp-Nachricht senden, sobald jemand nachträglich die Lieferadresse einer bereits versendeten Bestellung ändert.
Bei einer Nicht-2xx-Antwort einen Fehler zu werfen, ist ebenfalls bewusst so gewählt. Cloud Functions wiederholt einen fehlgeschlagenen Aufruf (wenn du Retries am Trigger aktivierst), und wenn der echte Fehler — ein falsches Telefonformat, eine getrennte Sitzung, ein 429 durch ein Rate Limit — nach oben durchgereicht wird, übernimmt Firebases eigene Retry-Logik die Arbeit, statt dass die Nachricht lautlos in einem Funktionslog verschwindet, das niemand öffnet, bis sich ein Kunde beschwert.
Geplante Erinnerungen mit Cloud Scheduler
Nicht jede Nachricht hängt an einer einzelnen Dokumentänderung. Eine Erinnerung wie „dein Termin ist morgen" muss nach der Uhr auslösen, nicht nach einem Write. onSchedule kapselt Cloud Scheduler genau für diesen Fall:
const { onSchedule } = require("firebase-functions/v2/scheduler");
const { getFirestore } = require("firebase-admin/firestore");
exports.appointmentReminders = onSchedule(
{ schedule: "0 9 * * *", secrets: [textmeflowKey] },
async () => {
const db = getFirestore();
const tomorrow = new Date();
tomorrow.setDate(tomorrow.getDate() + 1);
const dateStr = tomorrow.toISOString().slice(0, 10);
const snapshot = await db
.collection("appointments")
.where("date", "==", dateStr)
.get();
await Promise.all(
snapshot.docs.map((doc) => {
const appt = doc.data();
return fetch("https://api.textmeflow.eu/v1/messages", {
method: "POST",
headers: {
Authorization: `Bearer ${textmeflowKey.value()}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
to: appt.phone,
text: `Erinnerung: dein Termin ist morgen um ${appt.time}.`,
}),
});
})
);
}
);
Diese Funktion läuft täglich um 09:00 Uhr in der für die Funktion eingestellten Zeitzone, sucht jeden für morgen geplanten Termin und sendet pro Dokument eine WhatsApp-Nachricht. Das ist ein naher Verwandter des Musters in WhatsApp-Bestätigungen aus Stripe-Webhooks senden — eine Trigger-Quelle, die kein direkter API-Aufruf ist, aber am Ende denselben /v1/messages-Aufruf füttert.
Doppelte Sends bei wiederholten Aufrufen vermeiden
Eine geplante Funktion oder ein wiederholter Firestore-Trigger kann für dasselbe logische Ereignis zweimal laufen — Cloud Functions garantiert „at-least-once"-Zustellung, nicht „exactly-once". Wenn eine doppelte WhatsApp-Erinnerung einen Kunden mehr stören würde als eine verpasste, schreibe vor oder nach dem Versand eine Markierung zurück nach Firestore (remindedAt: new Date() am Termin-Dokument) und prüfe sie am Anfang der Funktion. Damit wird aus einem Retry ein No-op statt einer zweiten Nachricht, die zehn Sekunden später im selben Chat landet.
Die Antwort als Warteschlange behandeln, nicht als Zustellgarantie
Ein 202 Accepted mit einer message_id bedeutet, dass TextMeFlow den Job in die Warteschlange gestellt hat — nicht, dass WhatsApp ihn zugestellt hat. Wenn du diese message_id zurück auf das Firestore-Dokument schreibst (whatsappMessageId: body.message_id), kann dein Handler für eingehende Webhooks genau dieses Dokument aktualisieren, sobald das Zustellstatus-Event eintrifft — so taucht ein fehlgeschlagener Versand als abfragbares Feld auf, statt nach Rückgabe der Funktion einfach zu verschwinden.
Registriere dich für den kostenlosen Plan, um einen API-Key zu bekommen und das in dein eigenes Firebase-Projekt einzubauen — 50 Nachrichten pro Monat kosten nichts, während du die Trigger-Logik testest, bevor du echte Volumen versendest.
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