E.164-Telefonnummernformat: Umwandeln und Validieren

Warum brauchen SMS- und WhatsApp-APIs E.164?

Weil das Routing eine eindeutige Nummer voraussetzt. Eine Nummer ohne Ländervorwahl kann zu vielen Ländern gehören, sodass die Plattform an den falschen Markt senden, die falschen Sender-ID-Regeln anwenden und den falschen Tarif berechnen könnte. Tarife, Sender-ID-Registrierung und Versandzeiten für Werbung gelten jeweils je Zielland, und über die Ländervorwahl wird das Ziel erkannt.

Was sagt Meta zu WhatsApp-Nummern?

Metas Dokumentation zu den Telefonnummernformaten von WhatsApp-Nutzern besagt, dass Pluszeichen, Bindestriche, Klammern und Leerzeichen in Sendeanfragen unterstützt werden, und empfiehlt dringend, das Pluszeichen und die Ländervorwahl anzugeben. Fehlt das Pluszeichen, wird die Ländervorwahl des Absenders der Nummer vorangestellt, wodurch eine Nachricht an eine falsche Nummer gehen kann. Metas Beispiel: Für einen Absender in Indien (Vorwahl 91) wird (631) 555-1234 an +916315551234 zugestellt, während +1 (631) 555-1234 korrekt zugestellt wird. Meta merkt zudem an, dass die Cloud API für Brasilien und Mexiko das zusätzliche Präfix in manchen Nummern ändern kann, und nennt das Standardverhalten.

Der sichere Weg: sauberes E.164 speichern und genau das senden.

Und bei SMS?

Auch SMS-APIs erwarten die vollständige internationale Nummer. Einige verlangen die Ziffern ohne Pluszeichen; das Format unterscheidet sich zwischen APIs und Protokollen, lesen Sie daher die Dokumentation der verwendeten API und testen Sie mit Ihrer eigenen Nummer. Funktionierende Beispiele finden Sie unter SMS per API senden und WhatsApp-Nachricht per API senden.

Wie validiere und normalisiere ich Nummern im Code?

Nutzen Sie einen Regex für eine schnelle Formprüfung und eine Bibliothek für die echte Validierung.

Eine gängige E.164-Formprüfung:

// Plus, a non-zero first digit, then 1 to 14 more digits: 15 digits at most
const E164 = /^\+[1-9]\d{1,14}$/;

function looksLikeE164(value) {
  return E164.test(value);
}

looksLikeE164("+971501234567"); // true
looksLikeE164("0501234567");    // false: no plus or country code
looksLikeE164("+0501234567");   // false: country codes do not start with 0

Der Regex prüft nur Länge und Zeichen. Er akzeptiert +99999999999, obwohl es keine solche Nummer gibt. Für echte Validierung nutzen Sie Googles Open-Source-Bibliothek libphonenumber, eine Bibliothek zum Parsen, Formatieren und Validieren internationaler Telefonnummern, verfügbar für Java, C++ und JavaScript, mit Community-Portierungen in anderen Sprachen. Ihre README beschreibt isValidNumber als vollständige Validierung für eine Region anhand von Längen- und Präfixinformationen und zeigt, wie eine geparste Nummer als E.164 formatiert wird.

# pip install phonenumbers  (a Python port of libphonenumber)
import phonenumbers

def to_e164(raw, default_region):
    try:
        number = phonenumbers.parse(raw, default_region)  # e.g. "AE", "SA", "GB"
    except phonenumbers.NumberParseException:
        return None
    if not phonenumbers.is_valid_number(number):
        return None
    return phonenumbers.format_number(number, phonenumbers.PhoneNumberFormat.E164)

print(to_e164("050 123 4567", "AE"))   # +971501234567 if the number is valid for the UAE
print(to_e164("+44 7700 900123", "GB"))

Portierungen stammen von externen Entwicklern, prüfen Sie daher die Qualität der gewählten. Parsen Sie mit einer Standardregion aus dem Land Ihres Kunden und speichern Sie dann das E.164-Ergebnis. Bewahren Sie auch die Roheingabe auf, damit Sie bei geänderten Regeln neu parsen können.

Normalisieren Sie bei der Eingabe, im Anmeldeformular, beim CRM-Import oder in der API, nicht erst beim Senden. Eine Nummer in zwei Schreibweisen wird zu zwei Kontakten, die dieselbe Kampagne jeweils erhalten.

Wie korrigiere ich Telefonnummern in einer Tabelle?

Formatieren Sie die Telefonspalte als Text, bevor Sie Nummern eingeben oder einfügen. Die häufigsten Probleme:

Microsoft dokumentiert, dass Excel führende Nullen entfernt und große Zahlen in wissenschaftliche Notation umwandelt und dass vor dem Textformat eingegebene Zahlen erneut eingegeben werden müssen. Beim direkten Öffnen einer CSV-Datei wendet Excel auf jede Spalte seine Standardformate an, nutzen Sie daher den Textimport-Assistenten oder „Aus Text/CSV“, um die Telefonspalte als Text zu markieren.

Für eine Liste von VAE-Mobilnummern, die als 050 123 4567 in Spalte A stehen, baut diese Formel E.164 als Text auf:

="+971"&RIGHT(SUBSTITUTE(A2," ",""),9)

Sie behält nach dem Entfernen der Leerzeichen die letzten neun Ziffern und passt daher nur auf Nummern dieser Form. Kopieren Sie das Ergebnis und fügen Sie es als Werte ein, bevor Sie als CSV speichern. Der Telefonnummern-Formatierer wandelt eine Nummer ohne Formel um, und unser Leitfaden zum Senden von Massen-SMS aus Excel oder CSV zeigt den kompletten Upload-Ablauf.

Praxisbeispiel: eine Kundenliste bereinigen

„Souq Rafiq“ (synthetisch), ein Händler in Dubai, exportiert 8.000 Kontakte aus drei Systemen mit Nummern wie 0501234567, 971 50 123 4567, +971-50-123-4567 und 00971501234567.

1. Der Analyst ergänzt eine Länderspalte aus dem Rechnungsland jedes Kunden.
2. Ein Skript parst jede Zeile mit dem Land als Standardregion, sodass alle vier Formate zu +971501234567 werden.
3. Zeilen, die die Validierung nicht bestehen, landen in einer Prüftabelle, statt gesendet zu werden.
4. Duplikate werden nach der Normalisierung entfernt, wodurch die vier Formate zu einem Kontakt zusammenfallen.
5. Ein HLR-Lookup markiert vor der Kampagne inaktive Nummern. Siehe HLR-Lookup erklärt.
6. Die bereinigte Spalte wird als Text gespeichert und hochgeladen.

Erst die Normalisierung lässt die Duplikatprüfung funktionieren; davor sah derselbe Kunde wie vier Personen aus.

Welche typischen Fehler gibt es?

• Die führende Null immer entfernen. Manche Länder, etwa Italien, haben keine Verkehrsausscheidungsziffer.
• Die Null behalten und die Ländervorwahl ergänzen, was +9710501234567 ergibt.
• Ohne Pluszeichen an WhatsApp senden, sodass die Ländervorwahl des Absenders ergänzt wird.
• Einen Regex als Validierung nutzen. Er prüft die Form, nicht die Gültigkeit.
• Excel Telefonnummern als Zahlen behandeln lassen und Nullen verlieren oder auf wissenschaftliche Notation umschalten.
• Beim Senden normalisieren statt bei der Eingabe.
• Aus einem gültigen Format auf eine erreichbare Nummer schließen. Portierte oder getrennte Nummern schlagen trotzdem fehl.
• Einer statischen Tabelle vertrauen. Nummernpläne ändern sich; nutzen Sie eine gepflegte Bibliothek.

So unterstützt OmniChannels.ai

OmniChannels.ai akzeptiert internationale Nummern für SMS und WhatsApp über eine REST-API, und die Kampagnen nehmen Excel- und CSV-Uploads mit Vorschau und Duplikatfilterung entgegen. BroadNet bietet HLR- und Nummern-Lookup, damit Sie prüfen können, ob eine korrekt formatierte Nummer aktiv ist. Die genauen Anfragefelder finden Sie in den SMS-API-Dokumenten und WhatsApp-API-Dokumenten, oder sprechen Sie mit unserem Team über das Onboarding.