API WhatsApp et le numéro dédié : guide pour les intégrateurs

Le numéro WhatsApp Business dédié est le point d'ancrage de toute intégration API WhatsApp : c'est l'identité visible de votre client sur la plateforme, le vecteur de son quality rating et la clé de voûte de sa capacité d'envoi. Pour un intégrateur gérant plusieurs clients, la gestion des numéros est une compétence opérationnelle à part entière. Choisir, enregistrer, maintenir et éventuellement migrer un numéro sans interruption de service demande une connaissance précise des contraintes Meta.

Quels numéros sont éligibles à l'API WhatsApp Business

Meta impose des critères précis sur les numéros acceptés pour l'API WhatsApp Business. Tous les numéros ne sont pas utilisables.

Types de numéros acceptés :

• Numéros fixes (lignes terrestres) — condition : pouvoir recevoir un appel vocal pour la vérification OTP.
• Numéros mobiles — condition : ne pas être actuellement actif sur l'application WhatsApp grand public.
• Numéros de téléphonie IP (VoIP) — acceptés dans certains pays, mais la vérification par SMS n'est pas disponible (vérification vocale uniquement).
• Numéros virtuels (numéros 0800, 08XX en France) — acceptés si Meta les reconnaît comme des numéros de contact valides.

Types de numéros refusés :

• Numéros déjà enregistrés sur WhatsApp personnel (doit être supprimé du compte personnel d'abord).
• Numéros partagés entre plusieurs entités (un numéro = un WABA uniquement).
• Numéros de téléconférence ou de masse.

Recommandations pratiques pour vos clients :

• Privilégiez un numéro fixe professionnel : stable, facile à vérifier, pas de risque de conflit avec WhatsApp personnel.
• Si votre client utilise déjà son numéro mobile sur WhatsApp personnel, prévoyez l'acquisition d'un numéro dédié business avant de commencer l'intégration.
• Documentez systématiquement le numéro utilisé, le WABA associé et le propriétaire légal — ces informations seront demandées en cas de support Meta.

Le processus d'enregistrement d'un numéro

L'enregistrement d'un numéro sur l'API WhatsApp Business suit un processus en plusieurs étapes qui peut être entièrement automatisé dans votre flux d'onboarding client via l'embedded signup.

Étapes du processus :

1. Saisie du numéro dans le flux embedded signup ou via l'API Graph (POST /v18.0/{phone-number-id}/register).
2. Vérification de disponibilité : Meta vérifie que le numéro n'est pas déjà enregistré sur un WABA ou l'application WhatsApp.
3. Envoi du code OTP : Meta envoie un SMS ou passe un appel vocal avec un code à 6 chiffres.
4. Validation du code : votre système (ou votre client via l'interface) saisit le code pour valider l'enregistrement.
5. Activation : le numéro est en statut "Connected" et peut envoyer des messages.

Points d'attention sur la vérification OTP :

• Le code OTP expire après 10 minutes. Si votre client n'est pas disponible immédiatement, planifiez le flux pour qu'il soit présent au moment de la vérification.
• En cas d'échec répété (3 tentatives), Meta impose un délai de blocage croissant. Informez vos clients à l'avance.
• Pour les numéros VoIP, seule la vérification vocale est disponible. Vérifiez que votre client peut recevoir un appel entrant sur ce numéro.

Pour comprendre comment l'embedded signup intègre ce processus dans un flux client fluide, lisez notre guide sur l'embedded signup WhatsApp pour les intégrateurs.

Gestion multi-numéros sur un WABA

Un WABA (WhatsApp Business Account) peut héberger plusieurs numéros de téléphone. Cette fonctionnalité est précieuse pour les intégrateurs dans deux scénarios :

Scénario 1 : Augmenter le débit d'envoi. Chaque numéro dispose de son propre tier de messaging indépendant. Un client en Tier 1 (1 000 conversations/24h) qui a besoin d'envoyer 3 000 messages peut utiliser 3 numéros en parallèle. La répartition doit éviter les doublons (un même destinataire ne doit pas recevoir le même message depuis deux numéros différents).

Scénario 2 : Séparer les usages. Un client peut vouloir un numéro dédié au support (messaging entrant) et un numéro dédié aux campagnes marketing (messaging sortant). Cette séparation protège le quality rating du numéro de support des risques liés aux campagnes.

Contraintes à connaître :

• Chaque numéro enregistré sur un WABA est visible dans le même Business Manager Meta.
• Les templates WhatsApp sont partagés au niveau du WABA : un template approuvé est utilisable par tous les numéros du même WABA.
• Le quality rating est individuel par numéro, pas par WABA.

Pour structurer votre architecture multi-numéros, l'API WhatsApp de Whakup supporte nativement le multi-numéros et le multi-tenant avec isolation complète entre clients.

Portabilité et migration de numéro

La portabilité d'un numéro WhatsApp Business est possible, mais elle implique une interruption de service temporaire. Voici les deux cas principaux.

Migration entre WABAs (changement de BSP) : Si un client veut migrer son numéro d'un BSP vers un autre (par exemple, vers Whakup), le processus implique :

1. Désenregistrement du numéro depuis le WABA source.
2. Transfert ou re-création du WABA de destination.
3. Ré-enregistrement du numéro sur le nouveau WABA avec vérification OTP.

Conséquences : le quality rating et le tier de messaging sont conservés. L'historique des conversations (côté Meta) n'est pas accessible via l'API, mais vos logs internes restent disponibles. L'interruption est généralement de quelques minutes à quelques heures.

Migration vers un autre numéro (changement de numéro) : Si un client change de numéro de téléphone, le nouveau numéro repart de Tier 1 avec un quality rating vierge. Il n'est pas possible de transférer le tier ou l'historique d'un numéro à un autre. Planifiez le "warm-up" du nouveau numéro plusieurs semaines avant d'y basculer le trafic complet.

Pour comparer les options de BSP et leur gestion des migrations, notre analyse sur le meilleur BSP WhatsApp en France vous donnera les critères clés.

FAQ

Peut-on utiliser un numéro WhatsApp Business sans SIM physique ?

Oui. Meta accepte les numéros VoIP et les numéros virtuels, à condition de pouvoir recevoir un appel ou un SMS de vérification au moment de l'enregistrement. Beaucoup d'entreprises utilisent des numéros issus de plateformes de téléphonie cloud (Aircall, Ringover, etc.). Vérifiez simplement que la plateforme VoIP de votre client supporte bien les SMS ou appels entrants au moment de l'activation.

Le numéro WhatsApp Business doit-il appartenir à l'entreprise légalement ?

Meta recommande que le numéro soit associé à l'entité légale qui possède le WABA. En pratique, Meta ne vérifie pas automatiquement la propriété légale du numéro lors de l'enregistrement. En revanche, en cas de litige ou d'audit, l'absence de lien entre le numéro et l'entité légale peut compliquer la procédure de réactivation. Conseillez à vos clients de domicilier le numéro professionnel sur leur ligne d'entreprise.

Que se passe-t-il si le numéro d'un client expire ou est résilié par son opérateur ?

Si le numéro est résilié, le statut du numéro sur le WABA passe en "Disconnected". Le numéro peut être réassigné par l'opérateur à un tiers, créant un risque de sécurité. Surveillez le statut des numéros via l'API (endpoint GET /{phone-number-id}) et alertez vos clients si un numéro passe en statut anormal.

Combien de numéros peut-on enregistrer sur un seul WABA ?

Meta ne fixe pas de limite officielle publique sur le nombre de numéros par WABA. En pratique, les partenaires BSP gèrent des WABA avec plusieurs dizaines de numéros sans problème. Pour des architectures très larges (centaines de numéros), il est recommandé de contacter Meta directement ou de passer par un Meta Tech Provider certifié pour valider l'architecture cible.

---

La gestion des numéros dédiés est une responsabilité que vos clients vous délèguent pleinement. Une erreur d'enregistrement ou une migration mal planifiée peut interrompre leurs communications pendant plusieurs heures. Whakup accompagne ses partenaires sur toutes les étapes — enregistrement, warm-up, migration et monitoring — avec des outils intégrés dans l'API. Découvrez notre offre API WhatsApp pour intégrateurs.