· 2 min · TextMeFlow Team

WhatsApp-Nachrichten pro Empfänger personalisieren (API)

Bei der offiziellen WhatsApp Business API musst du Nachrichten vorab als „Template“ bei Meta freigeben lassen, mit festen Platzhaltern wie {{1}} und {{2}}. Das dauert Tage, und jede Textänderung bedeutet erneutes Warten auf die Freigabe.

TextMeFlow funktioniert anders: Du sendest Klartext an POST /v1/messages. Es gibt keine Template-Registrierung, keine Wartezeit auf Freigabe und kein festes Platzhalterformat. Der Nachteil ist, dass du selbst für die Personalisierung verantwortlich bist; der Vorteil ist, dass du volle Freiheit über jeden Satz hast, pro Empfänger, ohne auf jemanden zu warten. Dieser Artikel zeigt, wie du das in der Praxis aufbaust.

Warum Personalisierung mehr ist als einen Namen einzusetzen

Identischer Text an Dutzende Kontakte in einem Batch ist genau das Muster, das den internen Risk-Score von TextMeFlow steigen lässt: Die Einzigartigkeit des Inhalts ist eines der Signale, die zählen, zusammen mit der Anzahl eindeutiger Empfänger und der Bounce-Rate der letzten 24 Stunden (siehe /de/docs/anti-spam). Eine Erinnerung, die für alle wortgleich ist, wirkt wie ein Massenversand. Dieselbe Erinnerung mit Name, Datum und einem kleinen Detail wirkt wie eine persönliche Nachricht, und das erspart in der Praxis eine Menge Support-Fragen und Abmeldungen.

Der Ansatz: Text vor dem Senden zusammenbauen

Da die API keine Platzhalter-Syntax kennt, baust du den String einfach selbst in deinem Code zusammen, pro Zeile aus deiner Datenbank oder CSV, und sendest jede Nachricht einzeln an die API.

<?php

$apiKey = getenv('TEXTMEFLOW_API_KEY');

$afspraken = [
    ['naam' => 'Sofie', 'telefoon' => '+32472932208', 'datum' => 'Donnerstag um 14 Uhr', 'dienst' => 'Wartung'],
    ['naam' => 'Karim', 'telefoon' => '+32498112233', 'datum' => 'Freitag um 9:30 Uhr', 'dienst' => 'Reifenwechsel'],
];

foreach ($afspraken as $a) {
    $tekst = sprintf(
        "Hallo %s, dein Termin für %s ist für %s geplant. Antworte STOP, um dich abzumelden.",
        $a['naam'],
        $a['dienst'],
        $a['datum']
    );

    $response = file_get_contents('https://api.textmeflow.eu/v1/messages', false, stream_context_create([
        'http' => [
            'method'  => 'POST',
            'header'  => "Authorization: Bearer {$apiKey}\r\nContent-Type: application/json\r\n",
            'content' => json_encode(['to' => $a['telefoon'], 'text' => $tekst]),
        ],
    ]));

    // Rate-Limit beachten: max. 1 Nachricht pro Sekunde pro Nummer.
    usleep(1_100_000);
}

Der sprintf-Ansatz ist bewusst simpel: Für ein paar Variablen braucht es keine Templating-Bibliothek. Bei größeren Mengen (hunderte Zeilen) genügt eine kurze Pause zwischen den Aufrufen, wie das usleep oben, um im Limit von 1 Nachricht pro Sekunde pro Nummer zu bleiben. Darüber antwortet die API mit 429 Too Many Requests; fange diese Antwort ab und versuche es mit kurzem Backoff erneut, statt den gesamten Batch abstürzen zu lassen.

Variiere mehr als nur den Namen

Ein paar Wege, weiter zu personalisieren, ohne Komplexität hinzuzufügen:

  • Kontext aus deinem eigenen System: Betrag, Bestellnummer, Kennzeichen, Zimmernummer: alles, was du schon in deiner Datenbank hast, gehört in den Text, nicht nur der Name.
  • Zeitbezogene Formulierung: „morgen früh“ statt eines festen Datumsformats liest sich persönlicher und verhindert, dass 200 Nachrichten buchstäblich identisch sind.
  • Kleine Variationen im Satzbau: Wechsle bei einem Teil des Batches zwischen „dein Termin ist geplant für“ und „wir erwarten dich am“. Kleine Wechsel genügen, um das Risiko durch gleichförmigen Inhalt zu senken.

Medien gehören dazu

Personalisierung endet nicht beim Text. Das Feld media_url bei /v1/messages akzeptiert einen Link auf eine Datei bis 100 MB: eine Rechnungs-PDF mit dem richtigen Betrag, ein Foto des richtigen Zimmers, einen individuell erzeugten QR-Code. Erzeuge diese Datei pro Empfänger vor dem Senden und gib die URL zusammen mit dem Text mit.

Was du nicht tun solltest

Sende keinen identischen Text an eine Liste gekaufter oder nicht eingewilligter Nummern: Das ist ohnehin verboten, und Personalisierung ändert daran nichts. Und nutze das Flag urgent bei /v1/messages nicht, um systematisch die Ruhezeiten zu umgehen; dieses Flag ist für Ausnahmen gedacht, nicht als Gewohnheit. Wie du Massenversand weiter streust, um unter dem Radar der Broadcast-Erkennung zu bleiben, steht in unserem Artikel zu Massen-Erinnerungen.

Die vollständigen Request- und Response-Schemas samt Fehlercodes findest du in der API-Referenz.

Fang heute an

Du musst nicht auf eine Meta-Freigabe warten, um zu testen. Erstelle ein kostenloses Konto, hole dir deinen API-Key und sende deine erste personalisierte Nachricht in wenigen Minuten.

Kostenlos starten: 50 Nachrichten/Monat

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