Gérer plusieurs numéros WhatsApp Business via une seule API

Gérer plusieurs numéros WhatsApp Business depuis une seule API signifie orchestrer plusieurs numéros de téléphone actifs — chacun avec son propre WABA (WhatsApp Business Account), ses templates et ses tiers d'envoi — via un point d'entrée API unique. C'est l'architecture fondamentale pour tout éditeur SaaS ou agence qui opère des dizaines ou des centaines de clients, sans multiplier les intégrations ni les relations directes avec Meta.

Pourquoi un numéro par client, pas un numéro partagé

La tentation d'utiliser un numéro unique pour tous vos clients est compréhensible à petite échelle. Mais cette approche crée des problèmes structurels dès que le volume augmente.

Quality rating contaminé. Le quality rating est lié au numéro, pas au client. Si l'un de vos clients envoie des campagnes mal ciblées qui génèrent des blocages, la dégradation du score pénalise l'ensemble des envois transitant par ce numéro — y compris les autres clients.

Tiers d'envoi limité. Un seul numéro en Tier 3 permet 100 000 contacts uniques par 24h. Avec 10 clients actifs envoyant chacun 20 000 messages par jour, vous saturez le tier dès le deuxième client.

Conformité et isolation des données. Un numéro unique implique un WABA unique. Les templates, les logs et les données de consentement sont mélangés. Impossible de respecter l'isolation contractuelle que vos clients attendent.

Identité de marque. Chaque client doit apparaître dans WhatsApp avec son propre nom (Display Name). Ce n'est possible que si chaque client a son propre numéro et son propre profil Business.

Architecture multi-numéros avec Whakup

Whakup propose nativement une architecture multi-tenant où chaque client de votre plateforme dispose de son propre WABA et de son propre numéro, gérés depuis votre dashboard et votre API sans aucune interaction directe avec Meta.

Le schéma est le suivant :

Votre plateforme SaaS
        ↓
  API Whakup (endpoint unique)
        ↓
  ┌─────┬─────┬─────┐
  WABA1 WABA2 WABA3  ← un par client
  Num1  Num2  Num3

Chaque WABA est indépendant : quality rating isolé, tier d'envoi indépendant, templates distincts, logs séparés. Un problème chez le client A n'affecte pas le client B.

Onboarding d'un nouveau numéro client : le rôle de l'embedded signup

L'embedded signup est le mécanisme Meta qui permet à votre client de connecter son numéro WhatsApp à votre plateforme sans quitter votre interface. Le flux se déroule en moins de 5 minutes :

1. Le client clique "Connecter WhatsApp" dans votre dashboard.
2. Une fenêtre OAuth Meta s'ouvre dans l'interface.
3. Le client se connecte à son compte Meta Business, renseigne le numéro et accepte les CGU WhatsApp Business.
4. Whakup reçoit automatiquement les tokens d'accès et configure le WABA.
5. Le numéro est prêt à envoyer des messages.

Pas besoin que votre client crée une application Meta, comprenne les API Graph, ou signe des accords BSP. Whakup étant Meta Tech Provider certifié, il n'a pas non plus besoin de passer les certifications Meta lui-même — ce qui est souvent le frein principal à l'adoption directe.

Pour comprendre en détail le mécanisme d'embedded signup, consultez notre article sur l'embedded signup WhatsApp et l'onboarding simplifié.

Gestion des templates à l'échelle multi-clients

Chaque WABA dispose de sa propre bibliothèque de templates. Sur une plateforme avec 50 clients, gérer 50 bibliothèques distinctes manuellement est intenable. La bonne pratique est de construire une bibliothèque de templates mutualisés dans votre système, avec une couche de propagation automatique.

Template propagation pattern :

1. Un template "master" est créé et validé dans votre système.
2. Lors de l'onboarding d'un nouveau client, votre système soumet automatiquement les templates pertinents à son WABA via l'API.
3. L'approbation Meta est gérée asynchroniquement. Votre système surveille les statuts via webhooks.
4. Dès qu'un template est approuvé pour un WABA, il est marqué actif pour ce client.

Cette approche garantit que tous vos clients ont accès aux mêmes templates sans intervention manuelle.

Routage des envois et isolation des logs

L'API Whakup accepte dans chaque requête d'envoi un identifiant de numéro source (phone_number_id). Votre plateforme route chaque envoi vers le bon numéro client en incluant cet identifiant.

{
  "messaging_product": "whatsapp",
  "to": "33XXXXXXXXX",
  "type": "template",
  "template": { "name": "order_confirmation", "language": { "code": "fr" } }
}

Les logs d'envoi, les statuts de livraison et les webhooks associés sont isolés par phone_number_id, ce qui permet d'afficher dans votre dashboard les métriques propres à chaque client sans traitement de données croisées.

Comparatif : numéro partagé vs multi-numéros

Critère	Numéro partagé	Multi-numéros
Isolation du quality rating	Non	Oui
Capacité d'envoi totale	Limitée à 1 tier	Cumulée par numéro
Identité de marque par client	Non	Oui
Conformité RGPD (isolation données)	Difficile	Naturelle
Complexité d'onboarding	Simple	Gérée par embedded signup
Scalabilité	Bloquante	Linéaire

L'API WhatsApp pour éditeurs et agences Whakup est conçue pour cette architecture. Pas de sur-mesure requis : la gestion multi-numéros est le mode de fonctionnement par défaut, accessible dès le premier compte.

Pour comprendre l'impact tarifaire de cette architecture (coûts par numéro, frais Meta, modèle Whakup), consultez notre article détaillé sur les prix de l'API WhatsApp Business en 2026.

FAQ

Y a-t-il une limite au nombre de numéros gérables dans un seul compte Whakup ?

Non. L'architecture Whakup est pensée pour les éditeurs à fort volume. Le nombre de WABA et de numéros gérables depuis un seul compte partenaire n'est pas plafonné. Des limites techniques peuvent s'appliquer selon les conditions contractuelles Meta pour les très grands volumes — à discuter directement avec l'équipe Whakup.

Chaque numéro doit-il passer par une vérification Meta ?

Oui. Chaque numéro doit être vérifié via un code OTP envoyé par Meta (SMS ou appel vocal). Cette vérification est intégrée dans le flux d'embedded signup — votre client la réalise sans sortir de votre interface. La vérification prend généralement moins de 2 minutes.

Peut-on migrer un numéro WhatsApp Business existant vers l'architecture multi-numéros Whakup ?

Oui, sous conditions. Le numéro ne doit pas être simultanément actif sur un autre BSP. La migration implique une procédure de transfert de numéro qui supprime temporairement l'accès WhatsApp pendant la période de transition (généralement quelques heures). Pour les détails, consultez notre article sur la migration d'un numéro WhatsApp existant vers l'API Business.

Les templates sont-ils partagés entre les numéros d'un même WABA ?

Oui. Les templates sont liés au WABA, pas au numéro. Si un client a plusieurs numéros dans le même WABA (par exemple, un numéro de service client et un numéro de notifications), ils partagent la même bibliothèque de templates. Si vous souhaitez des bibliothèques distinctes, créez un WABA par périmètre fonctionnel.

---

La gestion multi-numéros est la fondation architecturale de toute plateforme WhatsApp sérieuse. Elle garantit l'isolation des risques, la scalabilité des envois et l'identité de marque pour chaque client. Pour déployer cette architecture sans intégration Meta directe, découvrez la solution Whakup Meta Tech Provider certifiée et ses capacités multi-tenant natives.