400 invalid_recipient vermeiden: Telefonnummern prüfen
Eine Antwort 400 invalid_recipient wirkt wie eine Kleinigkeit – ein fehlgeschlagener Versand, mit korrigierter Nummer erneut versuchen, weiter. Aber jeder abgelehnte Versand erhöht auch den Risikowert deines Accounts, und stammen die falschen Nummern aus einem unsauberen Import (ein CRM-Export, eine von Hand getippte Tabelle), kannst du in einem einzigen Batch-Job Dutzende davon ansammeln, ohne es zu merken. Die Lösung ist günstig: Prüfe das Nummernformat in deinem eigenen Code, bevor die Nummer die API überhaupt erreicht.
Was TextMeFlow genau verlangt
Die Anti-Spam-Pipeline erzwingt bei jedem to-Feld ein striktes E.164-Format. Nur eine Form wird akzeptiert:
+32472932208– gültig: Ländervorwahl, keine Leerzeichen, keine führende Null, keine Trennzeichen.0472932208– ungültig: Ländervorwahl fehlt.32472932208– ungültig: das führende+fehlt.+32-472-93-22-08– ungültig: Bindestriche sind nicht erlaubt.
Kurzwahlnummern, Premium-Rufnummern und gebührenfreie Bereiche werden unabhängig vom Format sofort abgelehnt – WhatsApp Web läuft auf diesen Nummerntypen nicht, es gibt also nichts, womit man auf der anderen Seite koppeln könnte. Jede Nummer, die diese Prüfungen nicht besteht, kommt von POST /v1/messages als 400 invalid_recipient zurück und erhöht deinen Risikowert jedes Mal um +10 (siehe die Aufschlüsselung des Risikowerts, wie sich diese Zahl in Richtung Sperrung aufsummiert).
Vor dem API-Aufruf prüfen, nicht danach
Der günstigste Ort, eine fehlerhafte Nummer abzufangen, ist der Moment, in dem sie in dein System gelangt – ein Anmeldeformular, ein CSV-Import, ein CRM-Sync – und nicht erst beim Versand. Ein einfacher regulärer Ausdruck erkennt die große Mehrheit der Formatfehler:
// Node.js
const E164_RE = /^\+[1-9]\d{7,14}$/;
function isValidE164(phone) {
return typeof phone === 'string' && E164_RE.test(phone.trim());
}
function normalizeToE164(raw, defaultCountryCode) {
const digits = raw.replace(/[^\d+]/g, '');
if (digits.startsWith('+')) return digits;
if (digits.startsWith('00')) return '+' + digits.slice(2);
if (digits.startsWith('0')) return `+${defaultCountryCode}${digits.slice(1)}`;
return `+${defaultCountryCode}${digits}`;
}
<?php
function isValidE164(string $phone): bool
{
return (bool) preg_match('/^\+[1-9]\d{7,14}$/', trim($phone));
}
function normalizeToE164(string $raw, string $defaultCountryCode): string
{
$digits = preg_replace('/[^\d+]/', '', $raw);
if (str_starts_with($digits, '+')) {
return $digits;
}
if (str_starts_with($digits, '00')) {
return '+' . substr($digits, 2);
}
if (str_starts_with($digits, '0')) {
return '+' . $defaultCountryCode . substr($digits, 1);
}
return '+' . $defaultCountryCode . $digits;
}
Der Normalisierer behandelt die beiden häufigsten Unordnungen aus der Praxis – eine nationale Nummer mit führender Null (0472932208) und die internationale Vorwahl statt + (0032472932208) –, kann aber keine Ländervorwahl erraten, die nie in den Daten stand. Speichere das Land überall, wo du Nummern erhebst, zusammen mit der Rohnummer (ein Länder-Dropdown neben einem Telefonfeld ist den zusätzlichen Klick wert), und lehne alles, was übrig bleibt, als nicht auflösbar ab, statt weiter zu raten.
Nicht einfach überspringen – protokollieren und melden
Fällt eine Zeile bei einem Batch-Import durch die Validierung, widerstehe der Versuchung, sie stillschweigend zu verwerfen. Sammle die abgelehnten Zeilen und mach sie sichtbar:
const results = contacts.map((c) => ({
...c,
e164: isValidE164(c.phone) ? c.phone : normalizeToE164(c.phone, defaultCc),
}));
const rejected = results.filter((r) => !isValidE164(r.e164));
if (rejected.length) {
console.warn(`${rejected.length} contacts could not be normalized to E.164`, rejected);
}
Diese Logzeile sagt dir, dass der CRM-Export ein Datenqualitätsproblem hat, bevor er dein Risikowert-Budget aufbraucht, ein 400 nach dem anderen.
Mit Opt-out-Prüfungen kombinieren
Das Nummernformat ist nur die Hälfte der Vorabprüfung. Hat ein Empfänger früher STOP geantwortet, lehnt TextMeFlow den Versand mit recipient_opted_out ab und schlägt +50 auf deinen Risikowert auf – das Fünffache der Strafe für eine falsche Nummer. Abonniere das opt_out-Webhook-Ereignis und führe lokal eine Tabelle der abgemeldeten Empfänger, damit dein eigener Code sie überspringen kann, bevor ein Versand versucht wird, statt sich jedes Mal darauf zu verlassen, dass die API es im Nachhinein abfängt.
Das Muster
Zwei günstige Prüfungen, ausgeführt vor jedem POST /v1/messages: Ist das eine wohlgeformte E.164-Nummer, und hat sich dieser Empfänger abgemeldet. Beide dauern lokal Mikrosekunden und kosten nichts; beide ersparen dir einen Risikowert-Anstieg und einen nutzlosen API-Roundtrip, wenn sie etwas abfangen. Für alles, was du nicht auflösen kannst – eine Nummer ohne Ländervorwahl und ohne Möglichkeit, eine zu erraten –, gib den Fall an einen Menschen weiter, statt ihn zu senden und aufs Beste zu hoffen.
Willst du die Validierungsfehler selbst sehen, bevor du das in Produktion nimmst? Melde dich für den kostenlosen Tarif an – 50 Nachrichten im Monat, keine Karte nötig – und sende absichtlich eine falsch formatierte Nummer, um die genaue Form der Antwort 400 invalid_recipient zu sehen.
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