WhatsApp API mit PHP, Python & Node.js: Beispiele
Wenn du ein Backend-Feature baust — Bestellbestätigungen, Terminerinnerungen, OTP-Codes —, brauchst du kein No-Code-Tool in der Mitte. Die API von TextMeFlow ist ein einziger authentifizierter POST-Request, deshalb ist der direkte Aufruf aus deinem eigenen PHP-, Python- oder Node.js-Code oft einfacher, als eine Automatisierungsplattform anzubinden. Dieser Leitfaden enthält funktionierende Snippets für alle drei.
Bevor du startest
- Erstelle einen kostenlosen TextMeFlow-Account — 50 Nachrichten/Monat, keine Kreditkarte, keine Meta-Business-Verifizierung.
- Scanne den QR-Code aus dem Portal mit dem Handy, auf dem deine WhatsApp-Nummer läuft.
- Kopiere deinen API-Key aus dem Dashboard.
Vollständige Endpunkt-Referenz: /de/docs/api.
PHP
<?php
$response = file_get_contents('https://api.textmeflow.eu/v1/messages', false, stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/json\r\n" .
"Authorization: Bearer YOUR_API_KEY\r\n",
'content' => json_encode([
'to' => '+32472932208',
'text' => 'Deine Bestellung #1042 wurde versendet.',
]),
],
]));
$data = json_decode($response, true);
echo $data['status']; // "queued"
Wenn du von TextMeBot migrierst, braucht der Drop-in-Kompatibilitätsendpunkt /send.php (beschrieben im Migrationsleitfaden) überhaupt keine Codeänderungen — tausche einfach Basis-URL und Key aus. Neue Integrationen sollten direkt /v1/messages verwenden, da es einen richtigen JSON-Body und eine message_id zurückgibt, die du nachverfolgen kannst.
Python
import requests
response = requests.post(
"https://api.textmeflow.eu/v1/messages",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"to": "+32472932208",
"text": "Deine Bestellung #1042 wurde versendet.",
},
)
response.raise_for_status()
message_id = response.json()["message_id"]
Für Terminerinnerungen aus einem Cronjob oder einer Celery-Task halte die to-Nummer im E.164-Format (+ und Ländervorwahl) — die API lehnt alles andere mit einem 422 ab.
Node.js
const response = await fetch("https://api.textmeflow.eu/v1/messages", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer YOUR_API_KEY",
},
body: JSON.stringify({
to: "+32472932208",
text: "Deine Bestellung #1042 wurde versendet.",
}),
});
const data = await response.json();
console.log(data.status); // "queued"
Funktioniert genauso in einer Next.js-API-Route, einem Express-Handler oder einer Lambda — es gibt keine SDK-Abhängigkeit, nur fetch und deinen API-Key.
Medien senden
Alle drei Beispiele oben akzeptieren neben text ein optionales Feld media_url — verweise auf eine beliebige öffentlich erreichbare Datei (Bild, PDF, Sprachnachricht) bis 100 MB, und sie wird an die WhatsApp-Nachricht angehängt.
Fehler und Kontingent behandeln
Eine 202-Antwort bedeutet, dass die Nachricht in der Warteschlange ist, nicht dass sie zugestellt wurde — frage GET /v1/messages/{id} ab, wenn du den Zustellstatus in deinem eigenen Dashboard brauchst. Eine 429 bedeutet, dass du das Rate-Limit oder das Monatskontingent deines Tarifs erreicht hast; der kostenlose Tarif ist für die gesamte Lebensdauer des Accounts auf 50 Nachrichten/Monat begrenzt, alles darüber erfordert also einen bezahlten Tarif (Starter ab 5 €/Monat).
Antworten empfangen
Senden ist bei den meisten Integrationen nur die halbe Miete. Richte im Portal einen Webhook ein, und TextMeFlow sendet jede eingehende WhatsApp-Nachricht als HMAC-signiertes JSON per POST an deinen Endpunkt — prüfe die Signatur serverseitig, bevor du der Payload vertraust. Das genaue Header-Format und ein Verifizierungsbeispiel findest du unter /de/docs/webhooks.
Fazit
Für die meisten Backend-Anwendungsfälle ist das die gesamte Integration: ein POST zum Senden, ein Webhook-Endpunkt zum Empfangen. Kein Meta Business Manager, keine Freigabe-Warteschlange für Vorlagen, kein SDK zu installieren. Starte kostenlos und sende deine erste Nachricht in wenigen Minuten.
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