Formater les numéros WhatsApp pour HubSpot et Flowella

Si vous stockez des numéros WhatsApp dans HubSpot pour les workflows Flowella, un formatage cohérent évite les échecs d’envoi. Cette page explique le format à utiliser, les formats acceptés par Flowella, la propriété HubSpot lue par Flowella, et comment nettoyer une feuille de calcul de numéros avant de l’importer.

Utiliser le format E.164

Stockez tous les numéros de téléphone WhatsApp au format E.164, la norme internationale des numéros de téléphone :

Un signe plus +
L’indicatif pays (sans zéro initial)
Le numéro national complet (sans le 0 initial de préfixe national)

Exemples :

Fixe au Royaume-Uni : +442079460958
Mobile au Royaume-Uni : +447700900123

Évitez les espaces, les parenthèses et les tirets. HubSpot affiche joliment le formatage dans l’interface, mais des valeurs E.164 propres sont les plus fiables pour les intégrations, y compris Flowella.

Formats acceptés par Flowella

Lorsqu’une action de workflow envoie un message, Flowella convertit le numéro stocké au format E.164. Il ignore les espaces, les tirets et les parenthèses, mais il a besoin de l’indicatif pays.

Valeur stockée	Ce que fait Flowella
`+44 7700 900123`	Envoie à `+447700900123`
`+447700900123`	Envoie à `+447700900123`
`0044 7700 900123`	Lit `00` comme préfixe international et envoie à `+447700900123`
`447700900123`	Considère que le numéro commence par un indicatif pays et envoie à `+447700900123`
`07700 900123`	Échoue avec `CONTACT_PHONE_INVALID`, car il n’y a pas d’indicatif pays

Flowella lit un numéro sans + ni 00 comme s’il commençait par un indicatif pays. Un numéro national peut alors correspondre au mauvais pays. Par exemple, le numéro américain (202) 555-0123 stocké sans +1 est lu comme un numéro égyptien commençant par +20. Incluez toujours l’indicatif pays.

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

HubSpot dispose d’une propriété dédiée au numéro de téléphone WhatsApp, hs_whatsapp_phone_number. Flowella l’utilise en premier, avant les propriétés génériques Mobile phone number (mobilephone) et Phone number (phone).

Scénario	Ce que Flowella lit ou écrit
Message entrant d’une personne qui n’est pas encore dans HubSpot	Flowella crée un contact HubSpot avec le numéro WhatsApp dans `hs_whatsapp_phone_number`. La propriété générique `phone` reste vide. Cela nécessite la fonctionnalité CRM contacts (auto-create on new WhatsApp chat).
Message entrant d’un contact qui existe déjà	Flowella recherche d’abord dans `hs_whatsapp_phone_number`, puis dans `mobilephone`, puis dans `phone`. Lorsqu’il trouve un contact correspondant, il écrit le numéro WhatsApp dans `hs_whatsapp_phone_number` si cette propriété est vide ou contient un autre numéro.
Send WhatsApp Template ou Send WhatsApp Message dans un workflow HubSpot	Flowella utilise la propriété de téléphone que vous mappez dans l’action. Si cette propriété est vide sur le contact, il essaie `hs_whatsapp_phone_number`, puis `mobilephone`, puis `phone`.
Send WhatsApp Reply dans un workflow HubSpot	L’action n’a pas de champ de téléphone. Flowella essaie toujours `hs_whatsapp_phone_number`, puis `mobilephone`, puis `phone`.

Si aucune de ces propriétés ne contient de numéro, l’action échoue avec CONTACT_PHONE_MISSING. Si le numéro ne peut pas être lu, elle échoue avec CONTACT_PHONE_INVALID. Consultez Codes d’erreur.

Mappez hs_whatsapp_phone_number dans vos actions de workflow. Si vos contacts existants ont leur numéro WhatsApp dans phone ou mobilephone, copiez-le dans hs_whatsapp_phone_number avec un workflow ou un import HubSpot. Flowella se rabat sur les autres propriétés, mais la propriété dédiée indique clairement quel numéro est utilisé pour WhatsApp.

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

Lorsque vous cliquez dans un champ de téléphone sur une fiche de contact (par exemple, Mobile phone number), HubSpot affiche un statut sous le champ. Il doit indiquer Validated. S’il n’indique pas Validated :

Vérifiez que le numéro commence par + et le bon indicatif pays
Vérifiez qu’il n’y a pas de 0 initial après l’indicatif pays (par exemple, +4407… est incorrect, utilisez +447…)
Utilisez l’option Remove number formatting de HubSpot si vous avez collé une valeur désordonnée, puis enregistrez de nouveau

Vérifiez quelle propriété contient réellement le numéro compatible WhatsApp avant de la mapper dans une action de workflow. Le champ Phone number d’un contact est souvent une ligne fixe, alors que son numéro WhatsApp peut se trouver dans Mobile phone number ou hs_whatsapp_phone_number.

Conseils pour l’import CSV et Excel

Excel “aide” en supprimant le signe + ou en convertissant les nombres longs en notation scientifique. Évitez cela avant l’import :

Formatez la colonne de téléphone en Text (Home → Number format → Text), puis collez les valeurs
Ou préfixez les valeurs d’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, placez les valeurs entre guillemets : "+447700900123"

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

Formule Excel : convertir 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 différents formats, la formule ci-dessous les convertit au format E.164, prêts pour l’import dans HubSpot. Elle gère tous les formats d’entrée courants, notamment :

Les numéros locaux avec un 0 initial (par exemple 07700 900123)
Les numéros avec + et indicatif pays (par exemple +44 7700 900123)
Le préfixe international 00 (par exemple 0044 7700 900123)
Le format +44(0)7...
Les tirets, points, parenthèses et autres signes de ponctuation
Les numéros qui ont déjà l’indicatif pays mais pas de + (par exemple 447700900123)

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

Comment utiliser la formule

Copiez la formule ci-dessous
Collez-la dans n’importe quelle cellule de votre feuille de calcul
Remplacez A2 par la cellule de votre premier numéro de téléphone
Remplacez "44" par votre indicatif pays (consultez le tableau de référence ci-dessous)
Remplacez 10 par la longueur attendue des numéros mobiles de votre pays
Appuyez sur Entrée, puis faites glisser vers le bas pour appliquer la formule à 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	Ce qu’il faut modifier
`cell`	La cellule contenant le numéro de téléphone brut. Modifiez-la pour qu’elle corresponde à votre colonne (par exemple `G2`)
`country_code`	L’indicatif pays par défaut pour les numéros nationaux (par exemple `"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 mobiles de votre pays (par exemple `10` pour le Royaume-Uni et les États-Unis)

Fonctionnement de la formule

La formule suit quatre chemins différents selon ce qu’elle trouve dans la valeur d’entrée :

Contient + dans l’original : déjà international. Ne garde que les chiffres et ajoute + au début
Commence par 00 : préfixe international. Supprime le 00 et ajoute + au début
Commence par l’indicatif pays ET le nombre de chiffres correspond : international sans préfixe (par exemple 447700900123). Ajoute + au début
Tout le reste : numéro national. Supprime le 0 initial et ajoute + suivi de l’indicatif pays

Avant tout cela, la formule supprime (0) de la valeur brute, ce qui permet de traiter proprement +44(0)7700 900123.

Résultat pour les numéros invalides

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

Résultat	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, peut-être un double préfixe

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

Référence des indicatifs pays

Pays	Indicatif pays	Longueur du NSN (mobile)	Remarques
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 conservent le 3 initial
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
Émirats arabes unis	971	9
Arabie saoudite	966	9
Afrique du Sud	27	9
Brésil	55	11	Mobile avec 9e chiffre
Singapour	65	8
Hong Kong	852	8

Les longueurs de NSN ci-dessus concernent les numéros mobiles. Pour WhatsApp, les longueurs des mobiles sont les bonnes. Si vous traitez un mélange de numéros mobiles et fixes, sachez que certains pays (notamment l’Allemagne) ont des numéros fixes de longueur variable.

Liste de vérification rapide

Si vos actions de workflow Flowella échouent avec CONTACT_PHONE_MISSING ou CONTACT_PHONE_INVALID, parcourez cette liste :

Vérifiez que la propriété HubSpot contient une valeur au format E.164 (commençant par +)
Vérifiez que le champ affiche le statut Validated dans HubSpot
Assurez-vous que le numéro inclut l’indicatif pays et n’a pas de 0 initial après celui-ci
Assurez-vous que votre action de workflow pointe vers la propriété qui contient réellement le numéro compatible WhatsApp, idéalement hs_whatsapp_phone_number
Si la propriété mappée est vide, vérifiez les propriétés de repli dans l’ordre où Flowella les lit : hs_whatsapp_phone_number, mobilephone, phone

Pages associées

Connecter HubSpot

Connectez votre compte HubSpot et vérifiez vos fonctionnalités.

Actions de workflow

Choisissez la bonne propriété de 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 fréquente des échecs d’envoi.

Messages non délivrés

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

Premiers pas

Essentiels

Utiliser l'application

Paramètres

Configuration Meta et WhatsApp

Intégration HubSpot

Flows et campagnes

Référence API

Dépannage

Journal des modifications

Formater les numéros WhatsApp pour HubSpot et Flowella

Utiliser le format E.164

Formats acceptés par Flowella

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

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

Conseils pour l’import CSV et Excel

Formule Excel : convertir 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

Résultat pour les numéros invalides

Référence des indicatifs pays

Liste de vérification rapide

Pages associées

Connecter HubSpot

Actions de workflow

Échecs de synchronisation HubSpot

Messages non délivrés

​Utiliser le format E.164

​Formats acceptés par Flowella

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

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

​Conseils pour l’import CSV et Excel

​Formule Excel : convertir 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

​Résultat pour les numéros invalides

​Référence des indicatifs pays

​Liste de vérification rapide

​Pages associées

Connecter HubSpot

Actions de workflow

Échecs de synchronisation HubSpot

Messages non délivrés

Utiliser le format E.164

Formats acceptés par Flowella

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

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

Conseils pour l’import CSV et Excel

Formule Excel : convertir 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

Résultat pour les numéros invalides

Référence des indicatifs pays

Liste de vérification rapide

Pages associées