API WhatsApp et le numéro dédié : guide pour les plateformes SMS

Le numéro WhatsApp Business dédié est le numéro de téléphone enregistré sur l'API WhatsApp Business d'un compte. C'est l'identité expéditrice visible par les destinataires : c'est ce numéro qui apparaît dans WhatsApp, qui reçoit les réponses, et dont le quality rating détermine les capacités d'envoi. Pour une plateforme SMS qui intègre WhatsApp pour ses clients, le choix et la gestion de ce numéro est une décision structurante qui engage la réputation du canal.

Types de numéros compatibles avec l'API WhatsApp Business

WhatsApp accepte une variété de numéros, avec des contraintes propres à chaque type :

Type de numéro	Compatibilité	Contraintes
Numéro fixe géographique	Oui	Vérification par appel vocal (pas de SMS)
Numéro mobile	Oui	Doit ne pas être utilisé sur WhatsApp personnel
Numéro virtuel VoIP	Oui	Doit être capable de recevoir SMS ou appel vocal
Numéro courts (5 chiffres)	Non	Non supporté par WhatsApp
Numéro gratuit (0800)	Partiellement	Dépend du pays — vérifier au cas par cas

La condition la plus importante : un numéro ne peut pas être simultanément actif sur l'application WhatsApp (personnelle ou Business App) et sur l'API. La migration d'un numéro existant vers l'API supprime son historique de messages et son compte WhatsApp existant. Cette information doit être communiquée clairement à vos clients avant l'activation.

Procédure d'activation d'un numéro sur l'API

L'activation d'un numéro sur l'API WhatsApp Business passe par trois étapes :

1. Ajout du numéro au compte WABA

Via l'API Graph, appelez l'endpoint POST /{waba-id}/phone_numbers avec les paramètres du numéro (cc + phone_number) et le nom d'affichage souhaité. Ce nom sera visible dans WhatsApp pour les destinataires.

2. Vérification par code OTP

Meta envoie un code de vérification au numéro fourni, par SMS ou par appel vocal. Soumettez ce code via POST /{phone-number-id}/verify_code. Ce code est valable 10 minutes.

3. Enregistrement et activation

Une fois vérifié, appelez POST /{phone-number-id}/register pour activer le numéro. À partir de ce moment, il peut envoyer et recevoir des messages via l'API.

Avec l'embedded signup de Whakup, cette procédure est automatisée et guidée pour vos clients finals — ils n'ont pas besoin de comprendre les appels API pour activer leur numéro.

Numéro dédié vs numéro partagé : pourquoi le dédié est obligatoire

Dans l'écosystème WhatsApp Business, il n'existe pas de numéro "partagé" entre plusieurs entreprises. Chaque numéro est exclusivement associé à un seul compte WhatsApp Business Account (WABA) et donc à une seule entité légale.

C'est une différence fondamentale avec certains services SMS qui proposent des shortcodes partagés. Sur WhatsApp :

• Chaque client doit avoir son propre numéro — vous ne pouvez pas mutualiser un numéro entre plusieurs clients
• Le nom d'affichage est unique par numéro — c'est le nom visible dans WhatsApp, il doit correspondre à l'identité de l'entreprise
• Le quality rating est propre au numéro — un client qui fait de mauvaises pratiques n'impacte pas les autres numéros de votre parc

Pour une plateforme SMS, cela signifie que votre architecture multi-tenant doit prévoir un phone_number_id distinct par client. Whakup supporte nativement cette approche avec une gestion centralisée et marque blanche de l'ensemble du parc.

Pour une comparaison complète de ce que proposent les différents providers sur la gestion multi-numéros, consultez notre analyse du meilleur BSP WhatsApp en France.

Le nom d'affichage : règles de validation Meta

Le nom d'affichage (Display Name) est ce que les destinataires voient dans WhatsApp avant même de regarder le numéro. Meta valide ce nom selon des critères stricts :

• Il doit correspondre au nom légal ou commercial de l'entreprise
• Il ne peut pas contenir de termes génériques seuls ("Service Client", "SMS Pro")
• Il ne peut pas imiter des marques reconnues sans en être le détenteur
• Il doit être en rapport avec le secteur d'activité déclaré dans le compte Business

La validation prend généralement 24 à 48 heures. Un nom refusé retarde l'activation. Guidez vos clients sur le choix du nom dès le début de l'onboarding pour éviter ces délais.

Numéro vérifié (green tick)

Le badge vert sur WhatsApp (numéro vérifié par Meta) est distinct du nom d'affichage. Il s'obtient sur demande auprès de Meta, pour les marques disposant d'une présence en ligne significative. Il améliore la confiance des destinataires mais n'est pas requis pour utiliser l'API.

FAQ

Peut-on changer de numéro après activation sans perdre l'historique des conversations ?

L'historique des conversations est stocké sur les appareils des utilisateurs, pas côté serveur. Changer de numéro n'efface pas les conversations passées chez vos clients finaux. En revanche, le nouveau numéro repart en tier 1 avec un quality rating vierge — le warm-up est à recommencer.

Faut-il une carte SIM physique pour activer un numéro sur l'API ?

Non. La vérification ne nécessite qu'une capacité à recevoir un SMS ou un appel vocal. Un numéro virtuel VoIP capable de recevoir des appels entrants convient. En pratique, de nombreuses plateformes utilisent des numéros de leurs opérateurs télécoms existants.

Un client peut-il utiliser son numéro de téléphone professionnel habituel ?

Oui, à condition que ce numéro ne soit pas déjà actif sur WhatsApp. Si le collaborateur utilise ce numéro sur son WhatsApp personnel ou l'app WhatsApp Business mobile, il devra choisir entre l'app et l'API. La migration vers l'API désactivera le compte existant.

Combien de numéros peut-on associer à un seul compte WABA ?

Un compte WABA peut avoir jusqu'à 20 numéros de téléphone associés par défaut. Ce plafond peut être augmenté sur demande auprès de Meta pour les comptes à fort volume. Pour les plateformes multi-tenant où chaque client a son propre WABA, cette limite ne s'applique pas de la même façon.

---

Le numéro dédié est bien plus qu'un détail technique — c'est l'actif réputationnel de votre canal WhatsApp. Bien géré, il monte en tier et en qualité. Mal géré, il dégrade la délivrabilité de l'ensemble de vos envois. Whakup, Meta Tech Provider certifié, vous accompagne dans l'activation et la gestion de l'ensemble de votre parc de numéros. Consultez notre page API WhatsApp Business pour commencer, et notre guide complet pour approfondir les mécaniques d'intégration.