Aller au contenu principal
Technique WhatsApp API 5 min de lecture

API WhatsApp et le numéro dédié : guide pour les plateformes de chatbot IA

Numéro WhatsApp Business dédié pour plateformes chatbot IA : choix du numéro, activation, migration et gestion multi-numéros. Guide complet pour éditeurs SaaS.

Le numéro dédié WhatsApp Business est l'unité de base de toute intégration API. Pour une plateforme de chatbot IA, chaque client doit opérer sur son propre numéro — la mutualisation d'un numéro entre plusieurs clients est une erreur d'architecture qui expose votre plateforme à des risques réglementaires et techniques majeurs.

Quel type de numéro utiliser pour l'API WhatsApp

L'API WhatsApp Business accepte différents types de numéros, avec des contraintes spécifiques.

Numéros fixes (géographiques et non-géographiques) : Pleinement compatibles. Un numéro fixe standard en 01/02/03/04/05/09 peut être utilisé. La vérification se fait par appel vocal (pas de SMS possible sur les fixes). Avantage : crédibilité perçue par les destinataires pour les entreprises établies.

Numéros mobiles : Compatibles. La vérification se fait par SMS. Numéros en 06/07 pour la France.

Numéros virtuels (VoIP) : Compatibles sous conditions. Le numéro doit pouvoir recevoir un SMS ou un appel vocal au moment de la vérification initiale. Certains opérateurs VoIP bloquent les SMS de vérification Meta — testez avant de déployer.

Numéros déjà utilisés sur WhatsApp (personnel ou Business App) : Compatibles mais nécessitent une migration. Le numéro sera transféré de l'application WhatsApp vers l'API, perdant l'historique de conversations et les groupes. À communiquer clairement à vos clients avant l'embedded signup.

Type Vérification Compatibilité API Recommandé
Mobile FR SMS Oui Oui
Fixe FR Appel vocal Oui Oui (entreprises)
VoIP SMS/Appel Conditionnel À tester
Déjà sur WhatsApp SMS/Appel + migration Oui Avec précautions

Gestion multi-numéros dans une plateforme chatbot SaaS

Une plateforme chatbot sérieuse doit architecturer son modèle de données autour du principe un client = un ou plusieurs numéros dédiés sur son propre WABA.

Pourquoi ne jamais mutualiser un numéro entre clients :

  • Les conversations WhatsApp s'affichent avec le numéro expéditeur : vos clients A et B recevraient des messages depuis le même numéro — confusion totale pour les utilisateurs finaux
  • Un quality score dégradé par le comportement d'un client affecte tous les autres
  • La messagerie tier s'applique par numéro : un client peut consommer toute la capacité d'envoi au détriment des autres
  • Les problèmes légaux d'un client (spam, violation RGPD) peuvent rejaillir sur votre infrastructure

Structure de données recommandée :

Client (tenant)
  └── WABA (WhatsApp Business Account)
        ├── Numéro 1 (ex: service client)
        │     ├── Messaging tier actuelle
        │     ├── Quality rating
        │     └── Templates approuvés
        └── Numéro 2 (ex: campagnes marketing)
              ├── Messaging tier actuelle
              ├── Quality rating
              └── Templates approuvés

Avantages de plusieurs numéros par client :

  • Séparation des use cases (support vs marketing) pour préserver les quality scores
  • Capacité d'envoi cumulée si les tiers montent en parallèle
  • Numéro dédié par marque pour les groupes qui opèrent plusieurs enseignes

Activer et gérer un numéro via votre plateforme

L'activation d'un numéro passe par l'embedded signup ou par l'API Graph directement (pour les partenaires ayant accès à l'API Business Management).

Étapes après réception du phone_number_id :

  1. Enregistrer le numéro : POST /{phone-number-id}/register avec le PIN de vérification à 6 chiffres
  2. Vérifier le display name : soumettre le nom commercial qui apparaîtra dans les conversations (revue Meta sous 24-48h)
  3. Activer le two-step verification : obligatoire pour sécuriser le numéro contre la reprise
  4. S'abonner aux webhooks : configurer les événements messages, message_deliveries, account_alerts
  5. Soumettre les premiers templates : sans template approuvé, le chatbot ne peut pas initier de conversation

Le numéro est opérationnel en Tier 1 (1 000 conversations/jour) dès la fin de l'enregistrement. La montée en tier démarre automatiquement avec l'activité.

FAQ

Un client peut-il apporter son propre numéro existant ?

Oui. Si votre client possède déjà un numéro d'entreprise qu'il utilise pour WhatsApp Business App, il peut le migrer vers l'API via l'embedded signup. La migration désinstalle l'accès WhatsApp Business App sur ce numéro. Le numéro conserve son nom d'affichage et son statut de vérification éventuel.

Que se passe-t-il si un client résilie votre SaaS ?

Si le client a utilisé son propre WABA (recommandé), il conserve ses numéros et peut les connecter à un autre BSP. Si votre architecture a provisionné le WABA en votre nom (déconseillé pour les numéros des clients), le transfert est plus complexe. Documentez clairement la propriété du WABA dans vos CGU.

Un numéro peut-il être utilisé simultanément par l'API et par WhatsApp Business App ?

Non. Un numéro est enregistré soit sur l'API, soit sur l'application. Impossible de faire les deux en parallèle. Le choix est exclusif et la migration de l'un vers l'autre demande une procédure de re-vérification.

Comment choisir entre un mobile et un fixe pour un chatbot B2C ?

Un numéro mobile est souvent préférable en B2C : les utilisateurs ont l'habitude de communiquer avec des mobiles sur WhatsApp, et le numéro est facilement enregistrable dans leurs contacts. Un numéro fixe est plus adapté aux entreprises qui veulent afficher un numéro cohérent avec leur ligne principale (ex: 01 XX XX XX XX pour une enseigne parisienne).


Le choix et la gestion des numéros dédiés sont des décisions d'architecture qui ont des conséquences durables sur la fiabilité de votre plateforme chatbot. Prenez-les dès la phase de conception. Explorez comment l'API WhatsApp de Whakup gère le provisioning multi-numéros et multi-tenant en marque blanche. Pour les détails sur le processus d'activation, lisez notre article sur le choix du numéro dédié WhatsApp Business et notre guide sur le Meta Tech Provider WhatsApp.

#technique api whatsapp#numéro whatsapp business#chatbot ia
Pablo Lenormand
Pablo LenormandCo-fondateur & CPO

Co-fondateur et Chief Product Officer de Whakup, Pablo conçoit les fonctionnalités qui permettent aux marques africaines de maximiser leur impact sur WhatsApp.

🚀

Prêt à passer à l'action ?

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

Démarrer l'essai gratuit