> ## Documentation Index > Fetch the complete documentation index at: https://knowledge.flowella.io/llms.txt > Use this file to discover all available pages before exploring further. # WhatsApp-Telefonnummernformatierung für HubSpot und Flowella > So formatieren Sie Telefonnummern in HubSpot für WhatsApp: E.164-Format, Ländervorwahlen, häufige Fehlerquellen und empfohlene Eigenschaftseinstellungen. Wenn Sie HubSpot verwenden, um WhatsApp-Nummern für Flowella-Workflows zu speichern, ist eine konsistente Formatierung unerlässlich. Nummern im falschen Format führen zu fehlgeschlagenen Sendungen, und das Rätsel „Warum fehlt dieser Nummer eine Ziffer" ist fast immer ein Formatierungsproblem. Diese Seite erklärt das richtige Format, wie Sie es in HubSpot überprüfen, wie Sie sauber importieren und wie Sie eine Tabelle voller unsauberer Nummern vor dem Import korrigieren. ## E.164-Format verwenden Speichern Sie alle WhatsApp-Telefonnummern im **E.164-Format**: * Ein Pluszeichen `+` * Landesvorwahl (ohne führende Null) * Vollständige nationale Nummer (ohne die führende Verkehrsausscheidungsziffer `0`) **Beispiele:** * UK-Festnetz: `+442079460958` * UK-Mobilnummer: `+447700900123` Vermeiden Sie Leerzeichen, Klammern und Bindestriche. HubSpot zeigt die Formatierung in der Benutzeroberfläche schön an, aber Integrationen — einschließlich Flowella — funktionieren am besten mit reinen E.164-Werten. ## Welche HubSpot-Eigenschaft enthält die WhatsApp-Nummer? Flowella schreibt über WhatsApp entdeckte Kontakte in eine dedizierte Eigenschaft — **`hs_whatsapp_phone_number`** — anstatt in das generische `phone`-Feld. | Szenario | Wo Flowella schreibt / liest | | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Eingehende Nachricht von einem Kontakt, der noch nicht in HubSpot existiert | Es wird ein neuer HubSpot-Kontakt erstellt, wobei die WhatsApp-Nummer in `hs_whatsapp_phone_number` geschrieben wird. Die generische `phone`-Eigenschaft bleibt leer. | | Eingehende Nachricht von einem bereits existierenden Kontakt | Flowella sucht **zuerst** in `hs_whatsapp_phone_number` und greift dann für Legacy-Kontakte auf `phone` / `mobilephone` zurück. | | Ausgehend aus einem HubSpot-Workflow | Wählen Sie `hs_whatsapp_phone_number` im Dropdown **Recipient Phone Number** jeder Flowella-Workflow-Aktion. Der Fallback auf `phone` funktioniert, wird aber für neue Automatisierungen nicht empfohlen. | Wenn Sie bestehende Kontakte haben, deren WhatsApp-Nummer in `phone` oder `mobilephone` steht, kopieren Sie sie mit einem HubSpot-Workflow oder einem Import in `hs_whatsapp_phone_number`. Die Suche von Flowella greift auf die Legacy-Felder zurück, aber **das Eingangs-Matching ist schneller und zuverlässiger, wenn die WhatsApp-Nummer in der dedizierten Eigenschaft steht**. ## Überprüfen, dass eine Nummer in HubSpot gültig ist Wenn Sie in einem Kontaktdatensatz auf ein Telefonfeld klicken (zum Beispiel **Mobiltelefonnummer**), zeigt HubSpot unter dem Eingabefeld einen Status an. Dieser sollte **Validated** lauten. Wenn er nicht Validated anzeigt: * Überprüfen Sie, dass die Nummer mit `+` und der richtigen Landesvorwahl beginnt * Überprüfen Sie, dass **keine führende `0` nach der Landesvorwahl** steht (z. B. ist `+4407…` falsch — es sollte `+447…` sein) * Verwenden Sie die HubSpot-Option **Remove number formatting**, wenn Sie einen unsauberen Wert eingefügt haben, und speichern Sie erneut Ein häufiger Fehler in Flowella-Workflows ist, die Aktion auf die Eigenschaft **Phone number** statt **Mobile phone number** zu richten. Überprüfen Sie nochmals, welche Eigenschaft tatsächlich die WhatsApp-fähige Nummer enthält. ## CSV- und Excel-Importtipps Excel wird „helfen", indem es das `+`-Zeichen entfernt oder lange Nummern in wissenschaftliche Schreibweise umwandelt. Verhindern Sie das vor dem Import: * Formatieren Sie die Telefonspalte als **Text** (Start → Zahlenformat → Text) und fügen Sie *danach* die Werte ein * Oder stellen Sie den Werten in Excel ein Apostroph voran: `'+447700900123` — der Apostroph erzwingt die Textbehandlung und erscheint nicht in den importierten Daten * Setzen Sie die Werte in CSV-Dateien in Anführungszeichen: `"+447700900123"` Importieren Sie keine Nummern mit Leerzeichen oder Klammern. HubSpot kann die Formatierung oft normalisieren, aber saubere E.164-Werte liefern die konsistentesten Ergebnisse. ## Excel-Formel: Telefonnummern auf E.164 bereinigen Wenn Sie eine Tabelle voller Telefonnummern in verschiedenen Formaten haben, bereinigt die folgende Formel sie in das E.164-Format, bereit für den HubSpot-Import. Sie verarbeitet alle gängigen Eingabeformate, einschließlich: * Lokale Nummern mit führender `0` (z. B. `07700 900123`) * Nummern mit `+` und Landesvorwahl (z. B. `+44 7700 900123`) * Internationale Wählvorwahl `00` (z. B. `0044 7700 900123`) * Das Format `+44(0)7...` * Bindestriche, Punkte, Klammern und andere Satzzeichen * Nummern, die bereits die Landesvorwahl, aber kein `+` haben (z. B. `447700900123`) Diese Formel erfordert **Excel 365 oder Google Sheets**. Sie verwendet `LET`, `TEXTJOIN` und `SEQUENCE`, die in älteren Excel-Versionen nicht verfügbar sind. ### So verwenden Sie die Formel 1. Kopieren Sie die untenstehende Formel 2. Fügen Sie sie in eine beliebige Zelle Ihrer Tabelle ein 3. Ändern Sie `A2`, sodass es auf Ihre erste Telefonnummern-Zelle zeigt 4. Ändern Sie `"44"` in Ihre Landesvorwahl (siehe Referenztabelle unten) 5. Ändern Sie `10` in die erwartete Länge der Mobilnummer für Ihr Land 6. Drücken Sie Enter und ziehen Sie nach unten, um die Formel auf alle Zeilen anzuwenden ### Die Formel ```excel theme={null} =LET( cell, A2, country_code, "44", nsn_len, 10, raw, TRIM(cell&""), clean, SUBSTITUTE(raw,"(0)",""), digits, TEXTJOIN("",,IFERROR(MID(clean,SEQUENCE(LEN(clean)),1)*1,"")), has_plus, ISNUMBER(FIND("+",raw)), has_00, LEFT(digits,2)="00", p, LEN(country_code), starts_cc, AND(LEFT(digits,p)=country_code, LEN(digits)=p+nsn_len), nsn, IF(has_plus, digits, IF(has_00, MID(digits,3,999), IF(starts_cc, MID(digits,p+1,999), IF(LEFT(digits,1)="0", MID(digits,2,999), digits)))), intl, IF(has_plus, "+"&digits, IF(has_00, "+"&MID(digits,3,999), IF(starts_cc, "+"&digits, "+"&country_code&nsn))), is_domestic, AND(NOT(has_plus), NOT(has_00), NOT(starts_cc)), IF(raw="","", IF(digits="","REVIEW (not a number): "&raw, IF(AND(is_domestic, LEN(nsn)nsn_len),"REVIEW (number too long): "&raw, intl)))) ) ``` ### Was die drei Konfigurationsvariablen bedeuten | Variable | Was geändert werden muss | | -------------- | -------------------------------------------------------------------------------------------------------------- | | `cell` | Die Zelle, die die rohe Telefonnummer enthält — passen Sie sie an Ihre Spalte an (z. B. `G2`) | | `country_code` | Die Standard-Landesvorwahl für inländische Nummern (z. B. `"44"` für UK, `"1"` für USA) | | `nsn_len` | Die erwartete Länge der nationalen Teilnehmernummer für Mobilnummern in Ihrem Land (z. B. `10` für UK und USA) | ### Wie die Formel funktioniert Die Formel nimmt vier verschiedene Pfade, je nachdem, was sie in der Eingabe findet: 1. **`+` im Original** — bereits international; auf Ziffern reduzieren und `+` voranstellen 2. **Beginnt mit `00`** — internationale Wählvorwahl; `00` entfernen und `+` voranstellen 3. **Beginnt mit der Landesvorwahl UND die Ziffernanzahl stimmt** — nacktes internationales Format (z. B. `447700900123`); `+` voranstellen 4. **Alles andere** — inländische Nummer; führende `0` entfernen und `+` plus Landesvorwahl voranstellen Vor all dem entfernt die Formel `(0)` aus der rohen Eingabe, sodass `+44(0)7700 900123` sauber verarbeitet wird. ### Ausgabe bei ungültigen Nummern Nummern, die die Validierung nicht bestehen, geben eine klare Meldung zurück, sodass Sie sie filtern und korrigieren können: | Ausgabe | Bedeutung | | ---------------------------------------- | ------------------------------------------------------ | | `REVIEW (not a number): hello world` | Überhaupt keine Ziffern gefunden | | `REVIEW (number too short): 07700` | Nicht genügend Ziffern für eine gültige Nummer | | `REVIEW (number too long): 077009001234` | Zu viele Ziffern, möglicherweise eine doppelte Vorwahl | Die Längenvalidierung gilt nur für inländische Nummern (solche ohne `+` oder `00`). Nummern, die bereits eine internationale Vorwahl haben, werden unverändert durchgereicht, da die Formel die NSN-Länge nicht für jedes Land kennen kann. ## Landesvorwahl-Referenz | Land | Landesvorwahl | NSN-Länge (mobil) | Hinweise | | ---------------------- | ------------- | ----------------- | ------------------------------------ | | Vereinigtes Königreich | 44 | 10 | | | USA / Kanada | 1 | 10 | Alle NANP-Länder teilen sich cc=1 | | Frankreich | 33 | 9 | | | Deutschland | 49 | 11 | Nur Mobil; Festnetz variiert | | Spanien | 34 | 9 | | | Italien | 39 | 10 | Mobilnummern behalten die führende 3 | | Portugal | 351 | 9 | | | Niederlande | 31 | 9 | | | Irland | 353 | 9 | | | Griechenland | 30 | 10 | | | Polen | 48 | 9 | | | Schweiz | 41 | 9 | | | Türkei | 90 | 10 | | | Indien | 91 | 10 | | | Australien | 61 | 9 | | | Japan | 81 | 10 | | | China | 86 | 11 | | | VAE | 971 | 9 | | | Saudi-Arabien | 966 | 9 | | | Südafrika | 27 | 9 | | | Brasilien | 55 | 11 | Mobil mit 9. Ziffer | | Singapur | 65 | 8 | | | Hongkong | 852 | 8 | | Die obigen NSN-Längen gelten für Mobilnummern. Für die WhatsApp-Nutzung sind die reinen Mobil-Längen korrekt. Wenn Sie eine Mischung aus Mobil- und Festnetznummern verarbeiten, beachten Sie, dass einige Länder (insbesondere Deutschland) Festnetznummern mit variabler Länge haben. ## Schnell-Checkliste zur Fehlersuche Wenn Ihre Flowella-Workflow-Aktionen keine Nachrichten zustellen können, arbeiten Sie diese Checkliste durch: * Bestätigen Sie, dass die HubSpot-Eigenschaft einen Wert im **E.164-Format** enthält (beginnt mit `+`) * Bestätigen Sie, dass das Feld in HubSpot den Status **Validated** zeigt * Stellen Sie sicher, dass die Nummer die Landesvorwahl enthält und **keine führende `0`** danach hat * Stellen Sie sicher, dass Ihre Workflow-Aktion auf die richtige Eigenschaft zeigt — diejenige, die tatsächlich die WhatsApp-fähige Nummer enthält, nicht ein anderes Telefonfeld ## Verwandt Verbinden Sie Ihr HubSpot-Portal und wählen Sie, welche Eigenschaften Flowella liest. Wählen Sie die richtige Telefon-Eigenschaft beim Konfigurieren von WhatsApp-Vorlage senden. Telefonformat-Probleme sind die häufigste Ursache für fehlgeschlagene Sendungen. Diagnostizieren Sie einzelne Sendungen, die den Empfänger nicht erreichen.