Zum Hauptinhalt springen
telli speichert Telefonnummern im internationalen Standardformat E.164: ein +, die Ländervorwahl und die Rufnummer, ohne Leerzeichen, Satzzeichen oder nationale Verkehrsausscheidungsziffer - zum Beispiel +4915112345678 oder +14155552671. Nummern, die die Validierung durchlaufen, werden in diese Form normalisiert und so in API-Antworten, Webhook-Payloads und Exporten zurückgegeben. Du musst Nummern aber nicht exakt in E.164 übermitteln. Jeder Weg, über den Kontakte in telli gelangen - die Kontakt-API, der CSV-Import und die CRM-Integrationen - führt Nummern durch dieselbe Normalisierung und Validierung und speichert anschließend das E.164-Ergebnis.

​
Akzeptierte Eingabeformate

Am Beispiel einer deutschen Mobilnummer: Diese Eingaben werden alle zu +491751234567 normalisiert: Nach der Normalisierung prüft telli, ob die Ländervorwahl bekannt ist und die Nummer eine für dieses Land mögliche Länge hat, und lehnt alles andere ab. Ob die Nummer im Rufnummernplan des Landes tatsächlich vergeben ist, wird nicht geprüft.

​
Warum nationale Formate abgelehnt werden

Eine Nummer wie 01751234567 ist mehrdeutig: Ohne Ländervorwahl kann telli nicht erkennen, ob es sich um eine deutsche, österreichische oder andere Nummer handelt. Ein angenommenes Standardland würde manche Nummern stillschweigend in gültig aussehende, aber falsche internationale Nummern verwandeln - und Anrufe würden die falsche Person erreichen. Deshalb müssen Nummern einen expliziten Länderkontext tragen. Wandle nationale Nummern auf deiner Seite in E.164 um, bevor du sie übermittelst. Für deutsche Nummern ist das eine einfache Transformation: Ersetze die führende 0 durch +49 (01751234567 → +491751234567). Die Regel unterscheidet sich jedoch je nach Land - italienische Nummern behalten zum Beispiel ihre führende Null nach +39 -, nutze also für alles über ein einzelnes bekanntes Land hinaus eine Bibliothek statt einer selbstgebauten Regel.
Wenn du per Code integrierst, nutze eine libphonenumber-Portierung für deine Sprache, um Nummern zu parsen und in E.164 zu formatieren - Portierungen gibt es für JavaScript, Python, Java, PHP und die meisten anderen Ökosysteme.

​
Wo das gilt

Dieselbe Normalisierung und Validierung läuft auf den wichtigsten Wegen, über die Telefonnummern in telli gelangen: Nummern, die auf diesen Wegen akzeptiert werden, werden als normalisierte E.164-Nummer gespeichert - und später so in Webhook-Payloads, API-Antworten und Exporten zurückgegeben.

​
Felder, die striktes E.164 erfordern

Die Weiterleitungsnummer eines Agenten überspringt die tolerante Normalisierung und akzeptiert nur eine Nummer, die bereits mit + beginnt - nur Ziffern, keine Leerzeichen oder Satzzeichen. Das Präfix 00 und Formen mit bloßer Ländervorwahl werden dort abgelehnt.