Format E.164 des numéros de téléphone : conversion et validation

Pourquoi les API SMS et WhatsApp exigent-elles E.164 ?

Parce que l'acheminement exige un numéro sans ambiguïté. Un numéro sans indicatif pays peut appartenir à de nombreux pays : la plateforme pourrait alors envoyer vers le mauvais marché, appliquer les mauvaises règles de sender ID et facturer le mauvais tarif. Les tarifs, l'enregistrement des sender ID et les horaires d'envoi promotionnels s'appliquent tous par pays de destination, et l'indicatif pays sert à identifier la destination.

Que dit Meta des numéros WhatsApp ?

La documentation de Meta sur les formats de numéros de téléphone des utilisateurs WhatsApp indique que les signes plus, tirets, parenthèses et espaces sont pris en charge dans les requêtes d'envoi de message, et recommande vivement d'inclure le signe plus et l'indicatif pays. Si le signe plus est absent, l'indicatif pays de l'expéditeur est ajouté au numéro, ce qui peut conduire à l'envoi d'un message à un mauvais numéro. L'exemple de Meta : pour un expéditeur en Inde (indicatif 91), (631) 555-1234 est remis à +916315551234, tandis que +1 (631) 555-1234 est remis correctement. Meta précise aussi que pour le Brésil et le Mexique, l'API Cloud peut modifier le préfixe supplémentaire présent dans certains numéros, et qualifie cela de comportement standard.

L'approche sûre : stockez du E.164 propre et envoyez exactement cela.

Et pour le SMS ?

Les API SMS attendent elles aussi le numéro international complet. Certaines exigent les chiffres sans le signe plus ; le format diffère selon les API et les protocoles : consultez donc la documentation de l'API utilisée et testez avec votre propre numéro. Voir envoyer des SMS via API et envoyer un message WhatsApp via API pour des exemples concrets.

Comment valider et normaliser les numéros en code ?

Utilisez une regex pour un contrôle rapide de la forme et une bibliothèque pour une vraie validation.

Un contrôle de forme E.164 courant :

// Plus, a non-zero first digit, then 1 to 14 more digits: 15 digits at most
const E164 = /^\+[1-9]\d{1,14}$/;

function looksLikeE164(value) {
  return E164.test(value);
}

looksLikeE164("+971501234567"); // true
looksLikeE164("0501234567");    // false: no plus or country code
looksLikeE164("+0501234567");   // false: country codes do not start with 0

La regex ne vérifie que la longueur et les caractères. Elle accepte +99999999999 alors qu'aucun numéro de ce type n'existe. Pour une vraie validation, utilisez libphonenumber, la bibliothèque open source de Google pour analyser, formater et valider les numéros de téléphone internationaux, disponible pour Java, C++ et JavaScript, avec des portages communautaires dans d'autres langages. Son README décrit isValidNumber comme la validation complète pour une région à partir des informations de longueur et de préfixe, et montre comment formater un numéro analysé en E.164.

# pip install phonenumbers  (a Python port of libphonenumber)
import phonenumbers

def to_e164(raw, default_region):
    try:
        number = phonenumbers.parse(raw, default_region)  # e.g. "AE", "SA", "GB"
    except phonenumbers.NumberParseException:
        return None
    if not phonenumbers.is_valid_number(number):
        return None
    return phonenumbers.format_number(number, phonenumbers.PhoneNumberFormat.E164)

print(to_e164("050 123 4567", "AE"))   # +971501234567 if the number is valid for the UAE
print(to_e164("+44 7700 900123", "GB"))

Les portages sont écrits par des développeurs extérieurs : vérifiez la qualité de celui que vous choisissez. Analysez avec une région par défaut tirée du pays de votre client, puis stockez le résultat E.164. Conservez aussi la saisie brute pour pouvoir la réanalyser si les règles changent.

Normalisez au point d'entrée, dans le formulaire d'inscription, l'import CRM ou l'API, pas au moment de l'envoi. Un numéro écrit de deux façons devient deux contacts qui reçoivent chacun la même campagne.

Comment corriger les numéros de téléphone dans un tableur ?

Mettez la colonne des numéros au format Texte avant de saisir ou de coller les numéros. Les problèmes courants :

Microsoft documente qu'Excel supprime les zéros initiaux et convertit les grands nombres en notation scientifique, et que les numéros saisis avant l'application du format Texte doivent être ressaisis. Lorsque vous ouvrez directement un fichier CSV, Excel applique ses formats par défaut à chaque colonne : utilisez donc l'Assistant d'importation de texte ou À partir du texte/CSV pour marquer la colonne des numéros comme texte.

Pour une liste de mobiles des Émirats arabes unis stockée sous la forme 050 123 4567 dans la colonne A, cette formule construit le E.164 sous forme de texte :

="+971"&RIGHT(SUBSTITUTE(A2," ",""),9)

Elle garde les neuf derniers chiffres après suppression des espaces : elle ne convient donc qu'aux numéros de cette forme. Copiez le résultat et collez-le en valeurs avant d'enregistrer en CSV. Le formateur de numéros convertit un numéro sans formule, et notre guide pour envoyer des SMS en masse depuis Excel ou CSV présente tout le parcours d'import.

Exemple concret : nettoyer une liste de clients

« Souq Rafiq » (fictif), un détaillant de Dubaï, exporte 8 000 contacts de trois systèmes, avec des numéros comme 0501234567, 971 50 123 4567, +971-50-123-4567 et 00971501234567.

1. L'analyste ajoute une colonne pays à partir du pays de facturation de chaque client.
2. Un script analyse chaque ligne avec le pays comme région par défaut, de sorte que les quatre formats deviennent +971501234567.
3. Les lignes qui échouent à la validation vont dans une feuille de revue au lieu d'être envoyées.
4. Les doublons sont supprimés après normalisation, ce qui fusionne les quatre formats en un seul contact.
5. Une recherche HLR signale les numéros inactifs avant la campagne. Voir la recherche HLR expliquée.
6. La colonne propre est stockée au format Texte puis importée.

C'est la normalisation préalable qui fait fonctionner la détection des doublons ; avant elle, le même client ressemblait à quatre personnes.

Quelles sont les erreurs courantes ?

• Supprimer toujours le zéro initial. Certains pays, comme l'Italie, n'ont pas de préfixe national.
• Garder le zéro et ajouter l'indicatif pays, ce qui donne +9710501234567.
• Envoyer sans le signe plus à WhatsApp, si bien que l'indicatif pays de l'expéditeur est ajouté.
• Utiliser une regex comme validation. Elle vérifie la forme, pas la validité.
• Laisser Excel traiter les numéros comme des nombres, avec perte des zéros ou passage en notation scientifique.
• Normaliser au moment de l'envoi plutôt qu'à la saisie.
• Supposer qu'un format valide signifie un numéro joignable. Les numéros portés ou déconnectés échouent quand même.
• Se fier à un tableau statique. Les plans de numérotation changent ; utilisez une bibliothèque maintenue.

Comment OmniChannels.ai vous aide

OmniChannels.ai accepte les numéros internationaux pour le SMS et WhatsApp via une seule API REST, et ses campagnes acceptent les imports Excel et CSV avec aperçu et filtrage des doublons. BroadNet propose la recherche HLR et de numéro, pour vérifier qu'un numéro bien formé est actif. Lisez la documentation de l'API SMS et celle de l'API WhatsApp pour les champs exacts des requêtes, ou parlez à notre équipe de l'onboarding.