WhatsApp-Telefonnummern für HubSpot und Flowella formatieren

Wenn Sie WhatsApp-Nummern für Flowella-Workflows in HubSpot speichern, verhindert eine einheitliche Formatierung fehlgeschlagene Sendungen. Diese Seite erklärt, welches Format Sie verwenden sollten, welche Formate Flowella akzeptiert, welche HubSpot-Eigenschaft Flowella liest und wie Sie eine Tabelle mit Nummern vor dem Import bereinigen.

E.164-Format verwenden

Speichern Sie alle WhatsApp-Telefonnummern im E.164-Format, dem internationalen Standard für Telefonnummern:

Ein Pluszeichen +
Ländervorwahl (ohne führende Null)
Vollständige nationale Nummer (ohne die führende Verkehrsausscheidungsziffer 0)

Beispiele:

Britischer Festnetzanschluss: +442079460958
Britische Mobilnummer: +447700900123

Vermeiden Sie Leerzeichen, Klammern und Bindestriche. HubSpot zeigt die Formatierung in der Oberfläche ansprechend an, aber saubere E.164-Werte sind für Integrationen, einschließlich Flowella, am zuverlässigsten.

Formate, die Flowella akzeptiert

Wenn eine Workflow-Aktion eine Nachricht sendet, wandelt Flowella die gespeicherte Nummer in E.164 um. Leerzeichen, Bindestriche und Klammern werden ignoriert, aber die Ländervorwahl ist erforderlich.

Gespeicherter Wert	Was Flowella macht
`+44 7700 900123`	Sendet an `+447700900123`
`+447700900123`	Sendet an `+447700900123`
`0044 7700 900123`	Liest `00` als internationales Präfix und sendet an `+447700900123`
`447700900123`	Liest die Nummer so, als beginne sie mit einer Ländervorwahl, und sendet an `+447700900123`
`07700 900123`	Schlägt mit `CONTACT_PHONE_INVALID` fehl, da keine Ländervorwahl vorhanden ist

Flowella liest eine Nummer ohne + oder 00 so, als beginne sie mit einer Ländervorwahl. Eine nationale Nummer kann dann dem falschen Land zugeordnet werden. Zum Beispiel wird die US-Nummer (202) 555-0123, die ohne +1 gespeichert ist, als ägyptische Nummer mit +20 gelesen. Geben Sie immer die Ländervorwahl an.

Welche HubSpot-Eigenschaft enthält die WhatsApp-Nummer?

HubSpot hat eine eigene Eigenschaft für die WhatsApp-Telefonnummer, hs_whatsapp_phone_number. Flowella verwendet sie zuerst, vor den allgemeinen Eigenschaften Mobile phone number (mobilephone) und Phone number (phone).

Szenario	Was Flowella liest oder schreibt
Eingehende Nachricht von jemandem, der noch nicht in HubSpot ist	Flowella legt einen HubSpot-Kontakt mit der WhatsApp-Nummer in `hs_whatsapp_phone_number` an. Die allgemeine Eigenschaft `phone` bleibt leer. Dafür ist die Funktion CRM contacts (auto-create on new WhatsApp chat) erforderlich.
Eingehende Nachricht von einem bereits vorhandenen Kontakt	Flowella sucht zuerst in `hs_whatsapp_phone_number`, dann in `mobilephone` und dann in `phone`. Findet es einen passenden Kontakt, schreibt es die WhatsApp-Nummer in `hs_whatsapp_phone_number`, falls diese Eigenschaft leer ist oder eine andere Nummer enthält.
Send WhatsApp Template oder Send WhatsApp Message in einem HubSpot-Workflow	Flowella verwendet die Telefoneigenschaft, die Sie in der Aktion zuordnen. Ist diese Eigenschaft beim Kontakt leer, versucht es `hs_whatsapp_phone_number`, dann `mobilephone` und dann `phone`.
Send WhatsApp Reply in einem HubSpot-Workflow	Die Aktion hat kein Telefonfeld. Flowella versucht immer `hs_whatsapp_phone_number`, dann `mobilephone` und dann `phone`.

Enthält keine dieser Eigenschaften eine Nummer, schlägt die Aktion mit CONTACT_PHONE_MISSING fehl. Kann die Nummer nicht gelesen werden, schlägt sie mit CONTACT_PHONE_INVALID fehl. Siehe Fehlercodes.

Ordnen Sie in Ihren Workflow-Aktionen hs_whatsapp_phone_number zu. Wenn Ihre bestehenden Kontakte ihre WhatsApp-Nummer in phone oder mobilephone haben, kopieren Sie sie mit einem HubSpot-Workflow oder Import nach hs_whatsapp_phone_number. Flowella greift auf die anderen Eigenschaften zurück, aber die eigene Eigenschaft macht deutlich, welche Nummer für WhatsApp verwendet wird.

Prüfen, ob eine Nummer in HubSpot gültig ist

Wenn Sie in einem Kontaktdatensatz in ein Telefonfeld klicken (zum Beispiel Mobile phone number), zeigt HubSpot unter dem Eingabefeld einen Status an. Dort sollte Validated stehen. Wird nicht Validated angezeigt:

Prüfen Sie, ob die Nummer mit + und der richtigen Ländervorwahl beginnt
Prüfen Sie, ob nach der Ländervorwahl keine führende 0 steht (zum Beispiel ist +4407… falsch, verwenden Sie +447…)
Verwenden Sie die HubSpot-Option Remove number formatting, wenn Sie einen unsauberen Wert eingefügt haben, und speichern Sie dann erneut

Prüfen Sie, welche Eigenschaft tatsächlich die WhatsApp-fähige Nummer enthält, bevor Sie sie in einer Workflow-Aktion zuordnen. Die Phone number eines Kontakts ist oft ein Festnetzanschluss, während seine WhatsApp-Nummer in Mobile phone number oder hs_whatsapp_phone_number stehen kann.

Tipps für CSV- und Excel-Importe

Excel „hilft” gern, indem es das +-Zeichen entfernt oder lange Nummern in wissenschaftliche Schreibweise umwandelt. Verhindern Sie das vor dem Import:

Formatieren Sie die Telefonspalte als Text (Home → Number format → Text) und fügen Sie danach die Werte ein
Oder stellen Sie den Werten in Excel ein Apostroph voran: '+447700900123. Das Apostroph erzwingt die Behandlung als Text und erscheint nicht in den importierten Daten
Setzen Sie 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 einheitlichsten Ergebnisse.

Excel-Formel: Telefonnummern in E.164 bereinigen

Wenn Sie eine Tabelle voller Telefonnummern in unterschiedlichen Formaten haben, bereinigt die folgende Formel sie in das E.164-Format, bereit für den HubSpot-Import. Sie verarbeitet alle gängigen Eingabeformate, darunter:

Lokale Nummern mit führender 0 (z. B. 07700 900123)
Nummern mit + und Ländervorwahl (z. B. +44 7700 900123)
Internationale Vorwahl 00 (z. B. 0044 7700 900123)
Das Format +44(0)7...
Bindestriche, Punkte, Klammern und andere Satzzeichen
Nummern, die bereits die Ländervorwahl, aber kein + enthalten (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

Kopieren Sie die folgende Formel
Fügen Sie sie in eine beliebige Zelle Ihrer Tabelle ein
Ändern Sie A2 so, dass es auf die Zelle mit Ihrer ersten Telefonnummer verweist
Ändern Sie "44" in Ihre Ländervorwahl (siehe Referenztabelle unten)
Ändern Sie 10 in die erwartete Länge von Mobilnummern in Ihrem Land
Drücken Sie die Eingabetaste und ziehen Sie die Formel dann nach unten, um sie auf alle Zeilen anzuwenden

Die Formel

=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 short): "&raw,
  IF(AND(is_domestic, LEN(nsn)>nsn_len),"REVIEW (number too long): "&raw,
  intl))))
)

Was die drei Konfigurationsvariablen bedeuten

Variable	Was zu ändern ist
`cell`	Die Zelle mit der unbearbeiteten Telefonnummer. Passen Sie sie an Ihre Spalte an (z. B. `G2`)
`country_code`	Die Standard-Ländervorwahl für inländische Nummern (z. B. `"44"` für Großbritannien, `"1"` für die USA)
`nsn_len`	Die erwartete Länge der nationalen Teilnehmernummer für Mobilnummern in Ihrem Land (z. B. `10` für Großbritannien und die USA)

Wie die Formel funktioniert

Die Formel geht je nach Eingabe einen von vier Wegen:

Enthält im Original ein +: bereits international. Auf Ziffern reduzieren und + voranstellen
Beginnt mit 00: internationale Vorwahl. 00 entfernen und + voranstellen
Beginnt mit der Ländervorwahl UND die Ziffernanzahl passt: international ohne Präfix (z. B. 447700900123). + voranstellen
Alles andere: inländische Nummer. Führende 0 entfernen und + plus Ländervorwahl voranstellen

Vorher entfernt die Formel (0) aus der Eingabe, sodass +44(0)7700 900123 sauber verarbeitet wird.

Ausgabe bei ungültigen Nummern

Nummern, die die Prüfung nicht bestehen, geben eine eindeutige Meldung zurück, damit 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 ein doppeltes Präfix

Die Längenprüfung gilt nur für inländische Nummern (ohne + oder 00). Nummern, die bereits ein internationales Präfix haben, werden unverändert übernommen, da die Formel die NSN-Länge nicht für jedes Land kennen kann.

Referenz der Ländervorwahlen

Land	Ländervorwahl	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 oben angegebenen NSN-Längen gelten für Mobilnummern. Für WhatsApp sind die reinen Mobillä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.

Kurze Checkliste zur Fehlerbehebung

Wenn Ihre Flowella-Workflow-Aktionen mit CONTACT_PHONE_MISSING oder CONTACT_PHONE_INVALID fehlschlagen, gehen Sie diese Checkliste durch:

Stellen Sie sicher, dass die HubSpot-Eigenschaft einen Wert im E.164-Format enthält (beginnt mit +)
Stellen Sie sicher, dass das Feld in HubSpot den Status Validated anzeigt
Achten Sie darauf, dass die Nummer die Ländervorwahl enthält und danach keine führende 0 steht
Achten Sie darauf, dass Ihre Workflow-Aktion auf die Eigenschaft verweist, die tatsächlich die WhatsApp-fähige Nummer enthält, idealerweise hs_whatsapp_phone_number
Ist die zugeordnete Eigenschaft leer, prüfen Sie die Ausweicheigenschaften in der Reihenfolge, in der Flowella sie liest: hs_whatsapp_phone_number, mobilephone, phone

Verwandt

HubSpot verbinden

Verbinden Sie Ihr HubSpot-Konto und prüfen Sie Ihre Funktionen.

Workflow-Aktionen

Die richtige Telefoneigenschaft beim Konfigurieren von Send WhatsApp Template auswählen.

HubSpot-Synchronisierungsfehler

Probleme mit dem Telefonformat sind die häufigste Ursache für fehlgeschlagene Sendungen.

Nachrichten nicht zugestellt

Einzelne Sendungen diagnostizieren, die den Empfänger nicht erreichen.

Erste Schritte

Grundlagen

App nutzen

Einstellungen

Meta- und WhatsApp-Einrichtung

HubSpot-Integration

Flows und Kampagnen

API-Referenz

Fehlerbehebung

Änderungsprotokoll

WhatsApp-Telefonnummern für HubSpot und Flowella formatieren

E.164-Format verwenden

Formate, die Flowella akzeptiert

Welche HubSpot-Eigenschaft enthält die WhatsApp-Nummer?

Prüfen, ob eine Nummer in HubSpot gültig ist

Tipps für CSV- und Excel-Importe

Excel-Formel: Telefonnummern in E.164 bereinigen

So verwenden Sie die Formel

Die Formel

Was die drei Konfigurationsvariablen bedeuten

Wie die Formel funktioniert

Ausgabe bei ungültigen Nummern

Referenz der Ländervorwahlen

Kurze Checkliste zur Fehlerbehebung

Verwandt

HubSpot verbinden

Workflow-Aktionen

HubSpot-Synchronisierungsfehler

Nachrichten nicht zugestellt

​E.164-Format verwenden

​Formate, die Flowella akzeptiert

​Welche HubSpot-Eigenschaft enthält die WhatsApp-Nummer?

​Prüfen, ob eine Nummer in HubSpot gültig ist

​Tipps für CSV- und Excel-Importe

​Excel-Formel: Telefonnummern in E.164 bereinigen

​So verwenden Sie die Formel

​Die Formel

​Was die drei Konfigurationsvariablen bedeuten

​Wie die Formel funktioniert

​Ausgabe bei ungültigen Nummern

​Referenz der Ländervorwahlen

​Kurze Checkliste zur Fehlerbehebung

​Verwandt

HubSpot verbinden

Workflow-Aktionen

HubSpot-Synchronisierungsfehler

Nachrichten nicht zugestellt

E.164-Format verwenden

Formate, die Flowella akzeptiert

Welche HubSpot-Eigenschaft enthält die WhatsApp-Nummer?

Prüfen, ob eine Nummer in HubSpot gültig ist

Tipps für CSV- und Excel-Importe

Excel-Formel: Telefonnummern in E.164 bereinigen

So verwenden Sie die Formel

Die Formel

Was die drei Konfigurationsvariablen bedeuten

Wie die Formel funktioniert

Ausgabe bei ungültigen Nummern

Referenz der Ländervorwahlen

Kurze Checkliste zur Fehlerbehebung

Verwandt