WhatsApp-Nachricht senden aus AWS Lambda (Node.js)
Läuft dein Backend bereits auf AWS — mit einem API-Gateway-Endpunkt, einem S3-Upload-Trigger, einem DynamoDB-Stream oder einer geplanten EventBridge-Regel —, musst du für eine WhatsApp-Benachrichtigung keinen neuen Server hochziehen, nur um eine HTTP-API aufzurufen. Eine Lambda-Funktion kann die Nachricht selbst senden, ohne einen Prozess, der am Laufen gehalten werden muss, und ohne zusätzliche Infrastruktur, die du zwischen den Aufrufen bezahlst.
Dieser Leitfaden behandelt eine Lambda, die per API Gateway ausgelöst wird (ein Webhook-Empfänger), und eine, die per EventBridge ausgelöst wird (eine geplante Erinnerung) — die beiden häufigsten Muster für transaktionale WhatsApp-Nachrichten.
Was du brauchst
- Einen kostenlosen TextMeFlow-Account mit einer per QR-Code gekoppelten WhatsApp-Nummer.
- Deinen API-Key aus dem TextMeFlow-Dashboard.
- Eine Lambda-Funktion mit der Node.js-20.x-Runtime (oder neuer), die
fetchglobal mitbringt — keine zusätzliche HTTP-Bibliothek zum Bündeln.
Schritt 1: API-Key als Umgebungsvariable speichern
Schreibe den Key niemals fest in den Funktionscode. Gehe in der Lambda-Konsole zu Configuration → Environment variables und füge TEXTMEFLOW_API_KEY hinzu. Wenn du mit dem Serverless Framework, SAM oder CDK deployst, hole den Key beim Deployment lieber aus AWS Secrets Manager oder dem SSM Parameter Store, statt ihn in dein Template zu committen.
Schritt 2: die Sendefunktion
export const handler = async (event) => {
const body = JSON.parse(event.body ?? "{}");
const res = 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: body.phone,
text: body.message,
}),
});
if (!res.ok) {
const error = await res.json();
console.error("WhatsApp send failed", error);
return { statusCode: res.status, body: JSON.stringify(error) };
}
return { statusCode: 200, body: JSON.stringify({ sent: true }) };
};
Das funktioniert unverändert, egal ob der Trigger API Gateway ist (dort ist event.body der rohe Request-Body) oder ein direkter Lambda-Aufruf durch einen anderen Dienst — nur der Code, der event.body aufbaut, ändert sich.
Muster A: Webhook-Empfänger (API-Gateway-Trigger)
Setze die Funktion hinter eine API-Gateway-HTTP-API und richte einen vorgelagerten Webhook — Stripe, Shopify, ein Formular-Handler, alles, was JSON per POST senden kann — auf diesen Endpunkt. Die Lambda parst die Payload, extrahiert die Telefonnummer und eine Nachricht und ruft TextMeFlow auf. Da API Gateway fehlgeschlagene Zustellungen an die Lambda bereits in eine Queue stellt und wiederholt, brauchst du für den Webhook-Abschnitt selbst keine eigene Retry-Logik — nur für den Aufruf an TextMeFlow, den der nächste Abschnitt behandelt.
Muster B: geplante Erinnerung (EventBridge-Trigger)
Für Erinnerungen, die nach Zeitplan statt bei einem Ereignis ausgelöst werden — etwa ein täglicher Schwung Terminerinnerungen —, hängst du eine EventBridge-Regel (rate(1 hour) oder einen Cron-Ausdruck) an dieselbe Funktion, die dann aus DynamoDB oder RDS liest statt aus event.body:
export const handler = async () => {
const dueReminders = await getDueReminders(); // your own query
const results = await Promise.allSettled(
dueReminders.map((r) =>
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: r.phone, text: r.text }),
})
)
);
return { statusCode: 200, body: JSON.stringify({ count: results.length }) };
};
Verzichte hier auf Promise.all — ein einzelner fehlgeschlagener Request sollte nicht den ganzen Stapel abbrechen. Promise.allSettled lässt jede Erinnerung unabhängig versuchen, und die fehlgeschlagenen kannst du für einen zweiten Durchlauf loggen.
Drosselung abfedern statt bekämpfen
Ein Stapel Erinnerungen aus EventBridge ist genau die Art von Traffic, die TextMeFlows Pacing-Logik glätten soll: Aufeinanderfolgende Nachrichten an verschiedene Empfänger werden mit zufälliger Verzögerung gestaffelt, statt alle auf einmal rauszugehen, und eine 429-Antwort bedeutet, dass du das Stundenlimit deines Tarifs erreicht hast — nicht, dass etwas kaputt ist. Prüfe den Retry-After-Wert im Response-Body und stelle die fehlgeschlagenen Sendungen entweder für einen späteren Lambda-Aufruf in eine Queue (eine SQS-Dead-Letter-Queue eignet sich hier gut) oder lass sie auf den nächsten geplanten Lauf warten. Wiederhole nicht sofort in einer Schleife innerhalb desselben Aufrufs — das tauscht nur eine Lastspitze gegen die nächste. Alle Regeln zu Pacing und Rate-Limits stehen unter /de/docs/anti-spam.
Timeouts und Cold Starts
Die API von TextMeFlow antwortet in der Regel deutlich unter einer Sekunde, setze das Lambda-Timeout aber auf mindestens 10 Sekunden, damit Platz für Cold Starts und Netzwerkschwankungen bleibt — das Standard-Timeout von 3 Sekunden kappt gelegentlich einen langsamen Aufruf und meldet einen falschen Fehler. Laufen deine Erinnerungen nach Zeitplan, kostet dich ein Cold Start nichts; liegt ein Webhook auf dem kritischen Pfad einer Anfrage, auf die ein Nutzer wartet, solltest du Provisioned Concurrency in Betracht ziehen.
Über den kostenlosen Tarif hinaus
Der kostenlose Tarif enthält dauerhaft 50 Nachrichten pro Monat — genug, um beide Muster oben aufzubauen und zu testen. Sobald du Erinnerungen oder Benachrichtigungen in echtem Volumen verschickst, erhöht der Starter-Tarif für 5 €/Monat dein Kontingent, mit in der EU (Paris) gehosteten Daten und einem automatischen AVV (DPA) in den bezahlten Tarifen. Wenn du in derselben Lambda-basierten Lösung auch eingehende Antworten oder Zustellstatus verarbeitest, findest du in WhatsApp-Nachrichten senden aus n8n, Make.com oder Zapier das No-Code-Äquivalent desselben Webhook-Musters.
Bereit? Erstelle einen kostenlosen Account und sende in wenigen Minuten deine erste WhatsApp-Nachricht aus einer Lambda-Funktion.
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