Format de numéros WhatsApp pour HubSpot

Si vous utilisez HubSpot pour stocker des numéros WhatsApp destinés aux workflows Flowella, un formatage cohérent est essentiel. Les numéros mal formatés provoquent des échecs d’envoi, et le mystère du « pourquoi ce numéro manque-t-il un chiffre » est presque toujours un problème de formatage. Cette page explique le format correct, comment le vérifier dans HubSpot, comment importer proprement, et comment corriger une feuille de calcul remplie de numéros mal formatés avant l’import.

Utilisez le format E.164

Stockez tous les numéros de téléphone WhatsApp au format E.164 :

Un signe plus +
Le code pays (sans zéro de tête)
Le numéro national complet (sans le 0 de tête de préfixe)

Exemples :

Téléphone fixe au Royaume-Uni : +442079460958
Mobile au Royaume-Uni : +447700900123

Évitez les espaces, parenthèses et tirets. HubSpot affiche joliment le formatage dans l’interface utilisateur, mais les intégrations — y compris Flowella — fonctionnent mieux avec des valeurs E.164 simples.

Quelle propriété HubSpot contient le numéro WhatsApp ?

Flowella écrit les contacts découverts via WhatsApp dans une propriété dédiée — hs_whatsapp_phone_number — plutôt que dans le champ générique phone.

Scénario	Où Flowella écrit / lit
Message entrant d’un contact qui n’existe pas encore dans HubSpot	Un nouveau contact HubSpot est créé avec le numéro WhatsApp écrit dans `hs_whatsapp_phone_number`. La propriété générique `phone` reste vide.
Message entrant d’un contact qui existe déjà	Flowella recherche d’abord dans `hs_whatsapp_phone_number`, puis se rabat sur `phone` / `mobilephone` pour les contacts hérités.
Sortant depuis un workflow HubSpot	Choisissez `hs_whatsapp_phone_number` dans la liste déroulante Recipient Phone Number de toute action de workflow Flowella. Se rabattre sur `phone` fonctionne mais n’est pas recommandé pour les nouvelles automatisations.

Si vous avez des contacts existants dont le numéro WhatsApp est dans phone ou mobilephone, copiez-le vers hs_whatsapp_phone_number à l’aide d’un workflow HubSpot ou d’un import. La recherche de Flowella se rabat sur les champs hérités, mais la correspondance entrante est plus rapide et plus fiable lorsque le numéro WhatsApp est sur la propriété dédiée.

Vérifier qu’un numéro est valide dans HubSpot

Lorsque vous cliquez dans un champ téléphone sur une fiche contact (par exemple, Mobile phone number), HubSpot affiche un statut sous le champ. Vous voulez voir Validé. S’il n’affiche pas Validé :

Vérifiez que le numéro commence par + et le bon code pays
Vérifiez qu’il n’y a pas de 0 de tête après le code pays (par exemple, +4407… est incorrect — cela devrait être +447…)
Utilisez l’option Remove number formatting de HubSpot si vous avez collé une valeur mal formatée, puis réenregistrez

Une erreur fréquente dans les workflows Flowella consiste à pointer l’action vers la propriété Phone number au lieu de Mobile phone number. Vérifiez bien quelle propriété contient effectivement le numéro activé pour WhatsApp.

Conseils d’import CSV et Excel

Excel cherche à « aider » en supprimant le signe + ou en convertissant les longs numéros en notation scientifique. Empêchez cela avant l’import :

Formatez la colonne téléphone en Texte (Accueil → Format des nombres → Texte), puis collez les valeurs
Ou préfixez les valeurs par une apostrophe dans Excel : '+447700900123 — l’apostrophe force le traitement en texte et n’apparaît pas dans les données importées
Dans les fichiers CSV, entourez les valeurs de guillemets : "+447700900123"

N’importez pas de numéros contenant des espaces ou parenthèses. HubSpot peut souvent normaliser le formatage, mais des valeurs E.164 propres donnent les résultats les plus cohérents.

Formule Excel : nettoyer les numéros de téléphone au format E.164

Si vous avez une feuille de calcul remplie de numéros de téléphone dans divers formats, la formule ci-dessous les nettoiera au format E.164, prête pour l’import HubSpot. Elle gère tous les formats d’entrée courants, notamment :

Numéros locaux avec un 0 de tête (par ex. 07700 900123)
Numéros avec + et code pays (par ex. +44 7700 900123)
Préfixe international 00 (par ex. 0044 7700 900123)
Le format +44(0)7...
Tirets, points, parenthèses et autres signes de ponctuation
Numéros qui ont déjà le code pays mais sans + (par ex. 447700900123)

Cette formule nécessite Excel 365 ou Google Sheets. Elle utilise LET, TEXTJOIN et SEQUENCE, qui ne sont pas disponibles dans les versions plus anciennes d’Excel.

Comment utiliser la formule

Copiez la formule ci-dessous
Collez-la dans n’importe quelle cellule de votre feuille de calcul
Modifiez A2 pour pointer vers votre première cellule de numéro de téléphone
Modifiez "44" selon votre code pays (voir le tableau de référence ci-dessous)
Modifiez 10 selon la longueur attendue du numéro de mobile pour votre pays
Appuyez sur Entrée, puis faites glisser vers le bas pour appliquer à toutes les lignes

La formule

=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))))
)

Signification des trois variables de configuration

Variable	Que modifier
`cell`	La cellule contenant le numéro de téléphone brut — à modifier pour correspondre à votre colonne (par ex. `G2`)
`country_code`	Le code pays par défaut pour les numéros domestiques (par ex. `"44"` pour le Royaume-Uni, `"1"` pour les États-Unis)
`nsn_len`	La longueur attendue du numéro national d’abonné pour les numéros de mobile dans votre pays (par ex. `10` pour le Royaume-Uni et les États-Unis)

Fonctionnement de la formule

La formule emprunte quatre chemins différents selon ce qu’elle trouve dans l’entrée :

Contient + à l’origine — déjà international ; on dépouille jusqu’aux chiffres et on préfixe +
Commence par 00 — préfixe international ; on enlève le 00 et on préfixe +
Commence par le code pays ET le nombre de chiffres correspond — international brut (par ex. 447700900123) ; on préfixe +
Tout le reste — numéro domestique ; on enlève le 0 de tête et on préfixe + plus le code pays

Avant tout cela, la formule supprime (0) de l’entrée brute, de sorte que +44(0)7700 900123 est traité proprement.

Sortie pour numéro invalide

Les numéros qui ne passent pas la validation renvoient un message clair pour que vous puissiez les filtrer et les corriger :

Sortie	Signification
`REVIEW (not a number): hello world`	Aucun chiffre trouvé
`REVIEW (number too short): 07700`	Pas assez de chiffres pour un numéro valide
`REVIEW (number too long): 077009001234`	Trop de chiffres, possiblement un double préfixe

La validation de longueur ne s’applique qu’aux numéros domestiques (ceux sans + ni 00). Les numéros qui ont déjà un préfixe international sont transmis tels quels, car la formule ne peut pas connaître la longueur du NSN pour chaque pays.

Référence des codes pays

Pays	Code pays	Longueur NSN (mobile)	Notes
Royaume-Uni	44	10
États-Unis / Canada	1	10	Tous les pays du NANP partagent cc=1
France	33	9
Allemagne	49	11	Mobile uniquement ; les fixes varient
Espagne	34	9
Italie	39	10	Les mobiles gardent le 3 de tête
Portugal	351	9
Pays-Bas	31	9
Irlande	353	9
Grèce	30	10
Pologne	48	9
Suisse	41	9
Turquie	90	10
Inde	91	10
Australie	61	9
Japon	81	10
Chine	86	11
EAU	971	9
Arabie saoudite	966	9
Afrique du Sud	27	9
Brésil	55	11	Mobile avec 9ème chiffre
Singapour	65	8
Hong Kong	852	8

Les valeurs de longueur NSN ci-dessus sont pour les numéros de mobile. Pour un usage WhatsApp, les longueurs « mobile uniquement » sont correctes. Si vous traitez un mélange de numéros mobiles et fixes, sachez que certains pays (en particulier l’Allemagne) ont des longueurs de fixes variables.

Liste de contrôle de dépannage rapide

Si vos actions de workflow Flowella échouent à livrer les messages, parcourez cette liste :

Confirmez que la propriété HubSpot contient une valeur au format E.164 (commence par +)
Confirmez que le champ affiche le statut Validé dans HubSpot
Assurez-vous que le numéro inclut le code pays et n’a pas de 0 de tête ensuite
Assurez-vous que votre action de workflow pointe vers la bonne propriété — celle qui contient réellement le numéro activé pour WhatsApp, pas un autre champ téléphone

En rapport

Installation HubSpot

Connectez votre portail HubSpot et choisissez les propriétés que Flowella lit.

Actions de workflow

Choisissez la bonne propriété téléphone lors de la configuration de Send WhatsApp Template.

Échecs de synchronisation HubSpot

Les problèmes de format de téléphone sont la cause la plus courante d’échecs d’envoi.

Messages non livrés

Diagnostiquez les envois individuels qui n’atteignent pas le destinataire.

Premiers pas

Journal des modifications

Essentiels

Utiliser l'application

Paramètres

Configuration Meta et WhatsApp

Intégration HubSpot

Flows et campagnes

Compte et connexion

Sécurité et confidentialité

Référence API

Dépannage

Format de numéros WhatsApp pour HubSpot

Utilisez le format E.164

Quelle propriété HubSpot contient le numéro WhatsApp ?

Vérifier qu’un numéro est valide dans HubSpot

Conseils d’import CSV et Excel

Formule Excel : nettoyer les numéros de téléphone au format E.164

Comment utiliser la formule

La formule

Signification des trois variables de configuration

Fonctionnement de la formule

Sortie pour numéro invalide

Référence des codes pays

Liste de contrôle de dépannage rapide

En rapport

Installation HubSpot

Actions de workflow

Échecs de synchronisation HubSpot

Messages non livrés

​Utilisez le format E.164

​Quelle propriété HubSpot contient le numéro WhatsApp ?

​Vérifier qu’un numéro est valide dans HubSpot

​Conseils d’import CSV et Excel

​Formule Excel : nettoyer les numéros de téléphone au format E.164

​Comment utiliser la formule

​La formule

​Signification des trois variables de configuration

​Fonctionnement de la formule

​Sortie pour numéro invalide

​Référence des codes pays

​Liste de contrôle de dépannage rapide

​En rapport

Installation HubSpot

Actions de workflow

Échecs de synchronisation HubSpot

Messages non livrés

Utilisez le format E.164

Quelle propriété HubSpot contient le numéro WhatsApp ?

Vérifier qu’un numéro est valide dans HubSpot

Conseils d’import CSV et Excel

Formule Excel : nettoyer les numéros de téléphone au format E.164

Comment utiliser la formule

La formule

Signification des trois variables de configuration

Fonctionnement de la formule

Sortie pour numéro invalide

Référence des codes pays

Liste de contrôle de dépannage rapide

En rapport