Behebung von Fehlern bei der Meldung 'Phone Number Must Be in E.164 Format'

Korrigieren Sie fehlende Ländervorwahlen, Pluszeichen und nationale Präfixe, bevor Sie eine Nummer für die Telegram-Registrierungsprüfung einreichen.

Ein Fehler mit der Meldung „phone number must be in E.164 format“ bedeutet, dass der übermittelte Wert eine Telefonnummer im internationalen Format benötigt, bevor eine Telegram-Registrierungsprüfung durchgeführt werden kann. Beginnen Sie mit der korrekten Ländervorwahl und der nationalen Rufnummer, fügen Sie das führende Pluszeichen hinzu und entfernen Sie Anzeigezeichen sowie nationale Vorwahlen, die nicht in das internationale Format gehören. Validieren Sie den transformierten Wert anhand des Quelldatensatzes, bevor Sie ihn erneut einreichen; eine syntaktisch korrekte, aber inhaltlich falsche Nummer ist dennoch eine fehlerhafte Eingabe.

Was die E.164-Anforderung prüft

E.164 ist der internationale Nummerierungsplan, der von der International Telecommunication Union veröffentlicht wurde. In der täglichen Anwendung beginnt die Darstellung mit einem Pluszeichen, gefolgt von der Ländervorwahl und der nationalen Rufnummer. Das Pluszeichen repräsentiert den internationalen Wählkontext; Leerzeichen, Klammern und Bindestriche können die Lesbarkeit für Menschen verbessern, sind jedoch nicht Teil des kompakten Wertes, den eine Prüf-API erwartet.

Ein Formatierungsfehler tritt vor einer aussagekräftigen Registrierungsantwort auf. Er sollte nicht als „Nicht registriert“ auf Telegram protokolliert werden. Die Telegram-Registrierungsprüfung für einzelne Nummern in Echtzeit von TG Validator erfordert die übermittelte Telefonnummer im E.164-Format. Sobald die Eingabe akzeptiert wurde, bezieht sich ein festgestelltes Ergebnis auf die Präsenz eines Telegram-Kontos für diese Nummer zum Zeitpunkt der Prüfung. Die Formatprüfung selbst sagt nichts über die Kontopräsenz, Identität, Inhaberschaft oder Kontaktberechtigung aus.

Verwenden Sie den ursprünglichen Quellenwert zusammen mit dem bekannten Land. Raten Sie keine Ländervorwahl aus den ersten Ziffern einer unvollständigen Nummer oder aus dem Land in der Postanschrift eines Kontakts. Eine nationale Nummer ist nur in ihrem Nummerierungskontext aussagekräftig. Wenn das Land unbekannt ist, halten Sie den Datensatz für eine Datenüberprüfung zurück, anstatt stillschweigend eine plausibel aussehende internationale Nummer zu erstellen.

Diagnose der häufigsten Eingabefehler

Beginnen Sie mit der Überprüfung der exakten Zeichenfolge, die an die Prüfung gesendet wurde, nicht nur der Art und Weise, wie eine Tabellenkalkulation sie anzeigt. Ein fehlendes Pluszeichen ist häufig, wenn ein Feld als Zahl gespeichert wurde. Dasselbe gilt für Leerzeichen, Klammern und Bindestriche, die von einer für Menschen lesbaren Visitenkarte kopiert wurden. Einige Quellen behalten ein nationales Präfix bei, das nach dem Hinzufügen der Ländervorwahl weggelassen werden sollte. Andere Quellen enthalten bereits die Ländervorwahl, sodass ein erneutes Voranstellen zu einer Duplizierung führt.

Der Twilio E.164 error guide veranschaulicht eine häufige Anforderung auf Dienstseite für dieselbe kompakte Form. Er definiert nicht das Registrierungsergebnis von TG Validator. Für eine länderspezifische Transformation konsultieren Sie maßgebliche Nummerierungsrichtlinien; eine allgemeine Regel wie „entferne jede Null“ ist unsicher, da eine Null Teil der nationalen Rufnummer sein kann.

Normalisierung in einer kontrollierten Sequenz

Bewahren Sie zuerst den Rohwert in einem separaten Feld auf. Weisen Sie zweitens ein vertrauenswürdiges Land oder eine Nummerierungsregion aus dem Quelldatensatz zu. Entfernen Sie drittens nur Anzeigezeichen wie Leerzeichen, Bindestriche und Klammern; verwerfen Sie Ziffern nicht einfach, weil sie ungewöhnlich aussehen. Entscheiden Sie viertens, ob der Wert bereits ein Pluszeichen und eine Ländervorwahl enthält. Wenden Sie fünftens, falls es sich um ein nationales Format handelt, die relevante Regel für die Umwandlung von national zu international an, einschließlich der Frage, ob ein Präfix entfernt werden muss. Prüfen Sie abschließend, ob die Ausgabe mit einem Pluszeichen beginnt, die beabsichtigten Ziffern enthält und keine Durchwahl im übermittelten Wert eingebettet ist.

Beispielsweise kann eine britische Nummer im nationalen Format eine führende 0 haben, die bei Inlandsgesprächen verwendet wird. In einer internationalen Darstellung ist die britische Ländervorwahl +44 und diese nationale 0 wird im Allgemeinen weggelassen. Die Transformation muss auf einer verifizierten britischen Nummer basieren; dies ist keine universelle Regel für alle Länder. Die ITU-Definition eines nationalen Präfixes erklärt, warum sich die nationale Wählzeichenfolge und eine internationale Nummer unterscheiden können. Halten Sie den Quellenwert und den transformierten Wert nebeneinander, damit ein Prüfer einen versehentlichen Verlust von Ziffern erkennen kann.

Verwenden Sie nicht allein einen Regex-Abgleich als endgültige Qualitätskontrolle. Ein Regex kann offensichtliche Satzzeichen oder ein fehlendes Pluszeichen erkennen, aber er kann nicht bestimmen, ob das Land korrekt ist oder ob eine lokale Nummerierungsregel ordnungsgemäß angewendet wurde. Ein länderspezifischer Parser kann helfen, dennoch muss der Quelldatensatz des Teams überprüft werden, wenn Informationen zu Land oder Inhaberschaft unsicher sind.

Überprüfung der Speicherung in Tabellenkalkulationen oder CRM

Excel und ähnliche Tools können Telefonnummern stillschweigend verändern, wenn eine Spalte als numerisch behandelt wird. Microsoft empfiehlt, Zellen vor der Eingabe als Text zu formatieren, da Telefonnummern Identifikatoren und keine Mengen für arithmetische Berechnungen sind. Ein visuell korrektes benutzerdefiniertes Format ändert möglicherweise nur die Anzeige und lässt den zugrunde liegenden Wert unverändert. Wenn eine führende Ziffer verloren ging, bevor die Zelle als Text formatiert wurde, wird eine nachträgliche Formatänderung diese nicht rekonstruieren.

Bevor Sie eine Stapelverarbeitung senden, exportieren Sie ein kleines Muster und untersuchen Sie die Rohdatei (TXT oder CSV) in einem Texteditor. Bestätigen Sie die erste und letzte Zeile, einige Einträge mit nationalen Präfixen und einige internationale Einträge. Zählen Sie die Ziffern in den Quellen- und transformierten Werten für diese Stichproben. Wenn eine Zeile eine Durchwahl enthält, bewahren Sie diese in einem separaten CRM-Feld auf; sie ist nicht die übermittelte Telefonnummer für eine Telegram-Registrierungsprüfung.

Wenn die Quelle ein Formular ist, erfassen Sie Land und Telefonnummer nach Möglichkeit in unterschiedlichen, validierten Feldern. Wenn es sich um eine alte Liste handelt, markieren Sie unsichere Zeilen zur Überprüfung, anstatt eine pauschale Konvertierung anzuwenden, die Tausende von Nummern falsch verändern könnte. Dies ist besonders wichtig, wenn eine Liste mehrere Länder enthält.

Erneute Einreichung nach der Fehlerbehebung

Verwenden Sie für einen einzelnen Datensatz das Dashboard „Single Check“ von TG Validator oder die REST-Registrierungsprüfung in Echtzeit nach der Normalisierung. Die REST-Einzelprüfung erfolgt über den dokumentierten Pfad POST /api/v1/check. Eine abgeschlossene Prüfung liefert das Registrierungsergebnis in derselben Anfragesitzung. Eine unentschiedene Prüfung ist ein separates Ergebnis mit einem geschäftlichen Code ungleich Null; sie sollte nicht als Formatfehler oder als negatives Registrierungsergebnis neu klassifiziert werden.

Für eine kleine Menge kann die Echtzeit-Stapelverarbeitung bis zu 100 Nummern über die API prüfen, und der „Realtime Batch Check“ im Dashboard kann bis zu 500 eingefügte Nummern akzeptieren. Eine wesentlich größere vorbereitete Liste folgt dem separaten asynchronen Workflow für Massendateien mit TXT- oder CSV-Eingabe, Aufgabenüberwachung und Ergebnis-Download. Lesen Sie die aktuelle TG Validator API-Dokumentation, bevor Sie einen Weg oder Details zur Kodierung der Anfrage auswählen. Diese Workflows unterscheiden sich, profitieren jedoch alle von demselben quellenerhaltenden Normalisierungsprozess.

Protokollieren Sie nach einer Korrektur, welcher Datensatz geändert wurde und warum. Wenn eine vorherige Prüfung die falsche Nummer verwendet hat, bearbeiten Sie dieses historische Ergebnis nicht so, als ob es sich auf die korrigierte Nummer bezöge. Führen Sie eine neue Prüfung für den korrigierten Wert durch und bewahren Sie einen klaren Prüfpfad auf. Das Ziel ist ein Ergebnis für die beabsichtigte Nummer, nicht bloß das Verschwinden eines Eingabefehlers.

FAQ

Wie können Teams ein fehlendes Pluszeichen bei einem E.164-Fehler beheben?

Bestätigen Sie die Quellnummer und das Land, und erstellen Sie dann den internationalen Wert mit einem führenden Pluszeichen und der korrekten Ländervorwahl. Fügen Sie einem unsicheren Datensatz keine geratene Vorwahl hinzu.

Sollten Teams jede führende Null aus Telefonnummern entfernen?

Nein. Wenden Sie die Nummerierungsregel des spezifischen Landes an. Ein nationales Präfix kann international weggelassen werden, aber andere Nullen können bedeutungsvolle Ziffern sein.

Was sollte mit einem Datensatz geschehen, der nach der Normalisierung immer noch fehlschlägt?

Behalten Sie die Roh- und transformierten Werte bei, überprüfen Sie das Land und die Quelldaten und leiten Sie den Datensatz zur Überprüfung weiter. Ein Formatfehler ist kein Telegram-Registrierungsergebnis.

Mehr erfahren

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

• Produktdokumentation ansehen →
• Mit dem Team sprechen →