· 1 min · TextMeFlow Team

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

  1. Erstelle einen kostenlosen TextMeFlow-Account — 50 Nachrichten/Monat, keine Kreditkarte, keine Meta-Business-Verifizierung.
  2. Scanne den QR-Code aus dem Portal mit dem Handy, auf dem deine WhatsApp-Nummer läuft.
  3. 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