> ## 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. # Format de numéros WhatsApp pour HubSpot > Stockez les numéros WhatsApp au format E.164 dans HubSpot, importez proprement depuis CSV ou Excel, et utilisez la formule de conversion automatique fournie. 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 1. Copiez la formule ci-dessous 2. Collez-la dans n'importe quelle cellule de votre feuille de calcul 3. Modifiez `A2` pour pointer vers votre première cellule de numéro de téléphone 4. Modifiez `"44"` selon votre code pays (voir le tableau de référence ci-dessous) 5. Modifiez `10` selon la longueur attendue du numéro de mobile pour votre pays 6. Appuyez sur Entrée, puis faites glisser vers le bas pour appliquer à toutes les lignes ### La formule ```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)))) ) ``` ### 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 : 1. **Contient `+` à l'origine** — déjà international ; on dépouille jusqu'aux chiffres et on préfixe `+` 2. **Commence par `00`** — préfixe international ; on enlève le `00` et on préfixe `+` 3. **Commence par le code pays ET le nombre de chiffres correspond** — international brut (par ex. `447700900123`) ; on préfixe `+` 4. **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 Connectez votre portail HubSpot et choisissez les propriétés que Flowella lit. Choisissez la bonne propriété téléphone lors de la configuration de Send WhatsApp Template. Les problèmes de format de téléphone sont la cause la plus courante d'échecs d'envoi. Diagnostiquez les envois individuels qui n'atteignent pas le destinataire.