E.164-Format für WhatsApp-API-Prüfungen: Warum lokale Formate Abfragen behindern

Dieser Artikel definiert das E.164-Format, zeigt die Fehler bei lokalen Formaten auf, die zu falschen WhatsApp-Prüfergebnissen führen, und stellt eine Normalisierungsroutine für API- und Datei-Workflows vor.

E.164 ist das internationale Nummerierungsformat der ITU: ein Ländercode gefolgt von der nationalen Rufnummer, maximal 15 Ziffern, geschrieben in kanonischer Form mit einem führenden Pluszeichen und ohne Leerzeichen, Bindestriche oder nationale Präfixe. WhatsApp-API-Prüfungen erfordern Nummern in diesem internationalen Format, da ein lokales Format wie 07700 900123 nicht erkennen lässt, zu welchem Land es gehört. Die Normalisierung jeder Nummer auf E.164 vor der Prüfung stellt sicher, dass das Ergebnis der beabsichtigten Nummer zugeordnet wird.

Was das E.164-Format ist

ITU-T Recommendation E.164 definiert den internationalen öffentlichen Telekommunikations-Nummerierungsplan. Für die praktische Datenverarbeitung hat eine E.164-Nummer drei Eigenschaften:

• Sie beginnt mit einem Ländercode von ein bis drei Ziffern, wie 1, 44, 55 oder 971.
• Sie wird mit der nationalen Rufnummer fortgesetzt, ohne das nationale Präfix (oft eine führende 0).
• Sie ist insgesamt nicht länger als 15 Ziffern, und die kanonische Schreibweise ist ein Pluszeichen gefolgt von Ziffern, zum Beispiel +447700900123.

Was E.164 weglässt, ist ebenso wichtig wie das, was es enthält: keine internationalen Vorwahlen wie 00 oder 011, keine Klammern, keine Leerzeichen, keine Durchwahlnummern.

Wie lokale Formate WhatsApp-API-Prüfungen behindern

Die meisten Seiten, die zu diesem Thema ranken, beschränken sich auf die Definition. Das praktische Problem ist, wie gewöhnliche CRM-Daten zu einer fehlerhaften Abfrage führen. Dies sind die Muster, die dies verursachen:

Metas WhatsApp user phone number format guidance zeigt das Risiko auf der Sendeseite deutlich: Ohne das Pluszeichen und den Ländercode kann der Ländercode des Business-Accounts vorangestellt werden, sodass "(631) 555-1234", gesendet von einer indischen Business-Nummer, zu +916315551234 statt zur beabsichtigten US-Nummer aufgelöst werden könnte. Dieselbe Mehrdeutigkeit gilt für jede Prüfung. Wenn die Prüfung gegen die falsche Nummer läuft, beschreibt das Ergebnis jemand anderen.

Eine Normalisierungsroutine vor der Nummernprüfung

Führen Sie diese Schritte vor jeder WhatsApp-Prüfung aus, egal ob die Nummern über die API oder in einer Datei verarbeitet werden.

1. Nummern als Text speichern. Tabellenkalkulationszellen für Zahlen entfernen das Pluszeichen und führende Nullen, und lange Werte können in wissenschaftliche Notation umgewandelt werden.
2. Land mit dem Datensatz speichern. Die Normalisierung benötigt eine Standardregion für Nummern, die im lokalen Format eingegeben wurden; übernehmen Sie diese aus dem Länderfeld des Kontakts, nicht vom Standort des Vertriebsteams.
3. Mit einer gepflegten Bibliothek parsen. Googles libphonenumber parst einen Roh-String plus eine Region in einen Ländercode und eine nationale Nummer und formatiert diese in E.164. Die Funktion isPossibleNumber ist eine reine Längenprüfung, während isValidNumber auch Präfixinformationen für die Region verwendet.
4. Fehler unter Quarantäne stellen. Werte, die nicht geparst werden können oder die Validierung nicht bestehen, gehen in eine Prüfwarteschlange statt an den Checker.
5. Nach der Normalisierung deduplizieren. "07700 900123" und "+44 7700 900123" werden erst nach diesem Schritt zur selben Nummer.

Diese Schritte beantworten eine eng gefasste Frage: Ist der String eine plausible internationale Nummer für seine Region? Ob die Nummer ein WhatsApp-Konto besitzt, ist eine separate Frage, die nur eine Registrierungsprüfung beantwortet.

Verwendung von E.164 mit der WA Lookup API und Dateien

Die WA Lookup Echtzeit-API nimmt eine übermittelte Telefonnummer im E.164-Format für POST /api/v1/check entgegen, zusammen mit dem X-API-Key-Header und dem service_type, der die WhatsApp-Registrierungsprüfung, die WhatsApp-Profilbildprüfung oder die WhatsApp-Business-Kontoprüfung auswählt. POST /api/v1/batch-check akzeptiert bis zu 100 Nummern pro Anfrage, und dieselbe Normalisierung gilt für jede Nummer darin. Befolgen Sie die aktuelle API-Dokumentation für den exakten Request-Body.

Bulk-Dateiaufträge haben ihre eigenen Formatierungsanforderungen:

• Nur TXT oder CSV, eine Nummer mit Ländercode pro Zeile.
• Die Datei sollte im Wesentlichen ein ausgewähltes Land enthalten. Wenn 10 % oder mehr der Nummern aus anderen Ländern stammen, lehnt die Vorprüfung die Datei ab; teilen Sie die Daten daher nach der Normalisierung nach Ländercode auf.
• Nummern aus Festlandchina (+86), Hongkong (+852) und Macau (+853) werden in Bulk-Dateien nicht akzeptiert; begrenzte Echtzeit-Einzelprüfungen unterstützen diese Regionen.

Häufige E.164-Fehler, die bei der Überprüfung auffallen

• Annahme, jede Nummer sei inländisch. Eine Standardregion ist ein Fallback für Eingaben im lokalen Format, keine Regel für jede Zeile.
• Entfernen des Pluszeichens zur Speicherung. Behalten Sie die kanonische Form im CRM bei; konvertieren Sie nur, wenn ein spezifisches System eine andere Darstellung erfordert.
• Beibehalten von Durchwahlnummern. Entfernen Sie Durchwahltexte wie "ext. 204" vor der Prüfung; E.164 hat keinen Platz dafür.
• Normalisierung als Erlaubnis behandeln. Eine korrekt formatierte, registrierte Nummer benötigt gemäß der WhatsApp Business Messaging Policy dennoch ein Opt-in vor der Kontaktaufnahme.
• Mischen von Formaten in einer Spalte. Eine normalisierte Spalte, die für die Prüfung und den Versand verwendet wird, verhindert, dass Ergebnisse von den Datensätzen abweichen, zu denen sie gehören.

FAQ

Wie können Teams feststellen, ob eine gespeicherte Nummer bereits im E.164-Format vorliegt?

Der Wert beginnt mit einem Pluszeichen, enthält danach nur Ziffern, hat keine nationale Null nach dem Ländercode und umfasst 15 oder weniger Ziffern. Das Parsen mit einer Bibliothek wie libphonenumber und das Zurückformatieren in E.164 sollte denselben String ergeben.

Spielt das führende Pluszeichen für WhatsApp-Prüfungen und Nachrichten eine Rolle?

Es kennzeichnet die Nummer als international. Metas Leitfaden empfiehlt, sowohl das Pluszeichen als auch den Ländercode einzuschließen, da eine Nummer ohne diese Angaben mit dem Ländercode des Absenders interpretiert werden könnte. Befolgen Sie für WA Lookup die aktuelle API-Dokumentation für den exakten String, der in der Anfrage erwartet wird.

Was sollte mit Nummern geschehen, die die Normalisierung nicht bestehen?

Senden Sie diese an eine Prüfwarteschlange mit dem ursprünglichen Wert und dem Land des Datensatzes. Das Prüfen eines mehrdeutigen oder falsch formatierten Strings verbraucht Guthaben und kann ein Ergebnis einer falschen Nummer zuordnen.

Warum benötigt eine Bulk-Datei Nummern aus einem Land?

Bulk-Aufträge werden für ein ausgewähltes Land eingereicht, und die Vorprüfung lehnt Dateien ab, bei denen 10 % oder mehr der Nummern aus anderen Ländern stammen. Die Normalisierung auf E.164 macht es einfach, einen gemischten Export nach Ländercode aufzuteilen.

Weitere Informationen

Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Workflow passen.

• Zur Produktdokumentation →
• Kontakt zum Team →