> ## 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 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.

<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)
* Werte benutzerdefinierter [Kontakteigenschaften](/de/platform/contact-properties) vom Typ `phone_number`
* Empfängernummern in einer [SMS](platform/sms)- oder [WhatsApp](integrations/whatsapp)-Workflow-Aktion

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

Die [Weiterleitungsnummer](/de/deep-dives/call-transfer) 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.


## Related topics

- [Überblick](/de/integrations-overview.md)
- [Telefonnummern](/de/platform/phone-numbers.md)
- [Telefonnummern auflisten](/de/v1/endpoint/list-phone-numbers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.