Skip to main content
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 validiert telli die Nummer gegen den Rufnummernplan des erkannten Landes und lehnt dort ungültige Nummern ab, etwa bei einer unbekannten Ländervorwahl oder einer unmöglichen Länge.

​
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

Einige Felder überspringen die tolerante Normalisierung und akzeptieren nur Nummern, die bereits mit + beginnen. Das Präfix 00 und Formen mit bloßer Ländervorwahl werden dort abgelehnt:
  • Werte benutzerdefinierter Kontakteigenschaften vom Typ phone_number (Leerzeichen und Satzzeichen sind erlaubt)
  • Die Weiterleitungsnummer eines Agenten (nur Ziffern - keine Leerzeichen oder Satzzeichen)