Aller au contenu principal
Technique WhatsApp API 6 min de lecture

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

Numéro WhatsApp Business dédié pour les CRM : comment en obtenir un, types de numéros acceptés, migration, multi-numéros et bonnes pratiques en architecture multi-tenant.

Le numéro de téléphone dédié est la clé d'entrée de toute intégration API WhatsApp Business. Chaque numéro enregistré sur l'API correspond à un point de contact unique avec une identité, un quality rating et des limites d'envoi propres. Pour les éditeurs de CRM qui gèrent plusieurs clients en architecture multi-tenant, les décisions autour des numéros — dédié par client ou mutualisé, fixe ou mobile, avec ou sans migration — ont des conséquences importantes sur l'isolation des clients, la délivrabilité et la facturation.

Types de numéros acceptés par l'API WhatsApp Business

Meta accepte plusieurs types de numéros pour l'API WhatsApp Business, avec des contraintes différentes :

Type de numéro Accepté ? Particularités
Mobile (SIM active) Oui Doit recevoir SMS ou appel vocal pour la vérification
Fixe (ligne terrestre) Oui Vérification par appel vocal uniquement
VoIP / virtuel Oui Sous conditions — certains opérateurs VoIP sont bloqués par Meta
Numéro déjà sur WhatsApp perso Migration requise Doit être libéré du compte personnel avant enregistrement
Numéro déjà sur WhatsApp Business app Migration requise Possible via le processus de migration officiel Meta

Le numéro ne doit pas être actif sur un compte WhatsApp personnel au moment de l'enregistrement. Si un client CRM souhaite utiliser le numéro de son entreprise déjà enregistré sur l'app WhatsApp Business standard, une migration est nécessaire — elle se fait sans perte de l'historique des conversations ni des contacts.

Numéro dédié vs numéro mutualisé : le choix d'architecture

En contexte CRM multi-tenant, la question centrale est : chaque client final a-t-il son propre numéro, ou partagent-ils un numéro commun ?

Numéro dédié par client (recommandé)

  • Identity distincte : chaque client communique sous son propre nom d'expéditeur et son propre numéro
  • Quality rating isolé : les pratiques d'un client n'affectent pas les autres
  • Rate limits indépendants : la montée en tier de chaque client est autonome
  • Conformité simplifiée : les données d'un client sont strictement séparées des autres
  • Inconvénient : coût d'un numéro supplémentaire par client, onboarding plus long

Numéro mutualisé (déconseillé pour des clients distincts)

  • Moins cher à déployer : un seul numéro pour plusieurs clients
  • Risque de contamination : un client qui dégrade son quality rating affecte tous les expéditeurs sur ce numéro
  • Confusion d'identité : les destinataires voient le même numéro expéditeur quel que soit le client qui envoie
  • Non conforme aux exigences Meta : Meta exige que chaque business utilise un numéro qui lui est propre

La recommandation unanime en production : un numéro dédié par client final.

Obtenir et enregistrer un numéro dédié

Via l'embedded signup (pour les nouveaux numéros)

Lors du flux d'embedded signup intégré dans votre CRM, le client peut :

  1. Saisir le numéro de téléphone qu'il souhaite utiliser
  2. Recevoir un code de vérification par SMS ou appel vocal
  3. Valider le numéro directement dans le flux

Le numéro est alors enregistré sur son WABA et prêt à l'emploi via l'API en quelques minutes.

Via l'API Graph (pour les numéros supplémentaires)

Si un client souhaite ajouter un deuxième numéro à son WABA existant (par exemple, pour une marque secondaire ou un pays différent), vous pouvez le faire programmatiquement :

POST /{WABA-ID}/phone_numbers
{
  "cc": "33",
  "phone_number": "612345678",
  "method": "SMS"
}

L'API retourne un phone_number_id que vous utilisez ensuite pour tous les appels relatifs à ce numéro (envoi de messages, consultation du quality rating, modification du profil).

Configurer le profil du numéro

Chaque numéro peut avoir un profil WhatsApp Business distinct : nom affiché, logo, description, URL du site, catégorie de business. Ces informations sont visibles par les destinataires dans l'interface WhatsApp. Exposez dans votre CRM un formulaire permettant à chaque client de configurer son profil directement depuis votre interface.

Migration d'un numéro existant

La migration permet à un client de transférer un numéro déjà utilisé sur l'app WhatsApp Business (version mobile) vers l'API WhatsApp Business. Points clés :

  • Aucune perte de données : l'historique des conversations n'est pas migré (l'API ne stocke pas l'historique), mais le numéro et son profil sont conservés
  • Délai : la migration est quasi-instantanée via l'API, sous réserve que le numéro soit libéré de l'app mobile
  • Impact utilisateurs : les contacts existants retrouvent automatiquement le même numéro dans leurs discussions
  • Impossible de revenir en arrière facilement : une fois migré sur l'API, le numéro ne peut plus être utilisé sur l'app mobile standard sans re-migration

FAQ

Un client CRM peut-il utiliser un numéro 0800 (gratuit) pour WhatsApp Business ?

Les numéros non-géographiques et numéros verts sont techniquement acceptés par Meta si l'opérateur peut les utiliser pour envoyer et recevoir des SMS ou des appels vocaux. En pratique, certains opérateurs bloquent la réception de codes de vérification sur ces numéros. Testez la faisabilité avec l'opérateur avant de promettre cette option à votre client.

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

Meta autorise jusqu'à 20 numéros par WABA par défaut. Cette limite peut être augmentée sur demande pour les comptes à fort volume. En architecture CRM où chaque client a son propre WABA, cette limite est rarement atteinte.

Que se passe-t-il si un client perd l'accès à son numéro (résiliation de ligne) ?

Si le numéro est résilié chez l'opérateur, il reste enregistré sur le WABA Meta jusqu'à sa suppression explicite via l'API ou le Business Manager. Les envois continueront à être tentés mais échoueront. Il faut supprimer le numéro du WABA et en enregistrer un nouveau. L'historique du quality rating est attaché au numéro : un nouveau numéro repart de zéro en Tier 1.

Peut-on personnaliser le nom d'expéditeur indépendamment du numéro ?

Oui. Le nom d'affichage (display name) est configuré au niveau du numéro dans le Business Manager Meta et via l'API. Il est distinct du numéro lui-même. Un client peut donc avoir un numéro opérateur standard mais afficher "Boutique Martin" comme nom d'expéditeur. Ce nom doit être approuvé par Meta et doit correspondre à l'activité déclarée dans le compte Business.


Le numéro dédié par client est la fondation d'une intégration WhatsApp robuste dans votre CRM. Il garantit l'isolation des identités, des quality ratings et des limites d'envoi — trois facteurs qui déterminent la fiabilité à long terme de vos clients sur ce canal.

Whakup, Meta Tech Provider certifié, accompagne les éditeurs de CRM dans l'enregistrement et la gestion multi-numéros via une API WhatsApp Business en marque blanche. Consultez aussi notre article sur le statut de Meta Tech Provider et notre comparatif des meilleurs BSP WhatsApp en France.

#technique api whatsapp#numéro whatsapp business#crm
Stéphane Haouzi
Stéphane HaouziHead of Growth

Head of Growth chez Whakup, Stéphane pilote la stratégie d'acquisition et les partenariats en Afrique francophone. Expert en marketing digital et expansion marché.

🚀

Prêt à passer à l'action ?

Essayez Whakup gratuitement pendant 15 jours. Aucune carte bancaire requise.

Démarrer l'essai gratuit