> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telli.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Telefonnummern-Format

> Welche Telefonnummern-Formate telli akzeptiert, wie Nummern normalisiert werden und warum alles in E.164 gespeichert wird

telli speichert Telefonnummern im internationalen Standardformat **[E.164](https://de.wikipedia.org/wiki/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:

| Eingabe            | Akzeptiert | Hinweise                                                                          |
| ------------------ | ---------- | --------------------------------------------------------------------------------- |
| `+491751234567`    | ✅          | Bereits E.164                                                                     |
| `+49 175 1234567`  | ✅          | Leerzeichen, Punkte, Bindestriche und Klammern werden ignoriert                   |
| `0049 175 1234567` | ✅          | Das internationale Präfix `00` wird zu `+` umgewandelt                            |
| `491751234567`     | ✅          | Ein fehlendes `+` wird ergänzt, wenn die Ziffern mit einer Ländervorwahl beginnen |
| `+491751234567`    | ✅          | Führende und nachgestellte Leerzeichen werden entfernt                            |
| `01751234567`      | ❌          | Nationales Format ohne Ländervorwahl - siehe unten                                |

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.

<Tip>
  Wenn du per Code integrierst, nutze eine [libphonenumber](https://github.com/google/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.
</Tip>

## Wo das gilt

Dieselbe Normalisierung und Validierung läuft auf den wichtigsten Wegen, über die Telefonnummern in telli gelangen:

* Die Kontakt-API - [v2](/de/v2/endpoint/create-contact) und [v1](/de/v1/endpoint/add-contact)
* Der [CSV-Import](/de/platform/contacts#csv-import) in der App
* Die CRM-Integrationen [HubSpot](/de/integrations/hubspot) und [Salesforce](/de/integrations/salesforce)

Nummern, die auf diesen Wegen akzeptiert werden, werden als normalisierte E.164-Nummer gespeichert - und später so in [Webhook-Payloads](/de/webhooks), 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](/de/platform/contact-properties) vom Typ `phone_number` (Leerzeichen und Satzzeichen sind erlaubt)
* Die [Weiterleitungsnummer](/de/deep-dives/call-transfer) eines Agenten (nur Ziffern - keine Leerzeichen oder Satzzeichen)