Ajouter un numéro WhatsApp Business à sa plateforme : les 5 étapes

Ajouter un numéro WhatsApp Business à une plateforme, ce n'est pas simplement entrer un numéro de téléphone dans un formulaire. C'est un processus structuré en plusieurs étapes, géré par Meta, qui implique la vérification du numéro, la configuration du profil et l'établissement des webhooks. Cet article détaille les 5 étapes dans l'ordre, avec les points de blocage à anticiper.

Étape 1 — Préparer le numéro de téléphone

Tout numéro de téléphone qui peut recevoir des appels vocaux ou des SMS peut être utilisé comme numéro WhatsApp Business via l'API. Fixe ou mobile, français ou international — peu importe, à deux conditions :

• Le numéro ne doit pas déjà être actif sur WhatsApp (ni sur l'app WhatsApp personnelle, ni sur WhatsApp Business App). Si c'est le cas, il faut d'abord supprimer le compte WhatsApp associé depuis l'application.
• Le numéro doit être accessible au moment de la vérification pour recevoir un SMS ou un appel vocal de Meta.

Pour des plateformes SaaS multi-tenant, recommandez à vos clients d'utiliser un numéro dédié au canal WhatsApp (distinct du numéro de support téléphonique), afin d'éviter des conflits futurs.

Étape 2 — Connecter le compte Meta Business via l'embedded signup

C'est ici que le numéro est associé à un WhatsApp Business Account (WABA). Le flux embedded signup permet à votre client de :

1. Connecter son Business Manager Meta à votre application.
2. Créer ou sélectionner un WABA existant.
3. Entrer le numéro de téléphone à activer.
4. Déclencher la vérification du numéro.

À l'issue de ce flux, vous récupérez un phone_number_id et un waba_id, les deux identifiants dont vous aurez besoin pour toutes les opérations API ultérieures.

Si votre client n'a pas encore de Business Manager Meta, l'embedded signup lui permet d'en créer un pendant le flux — comptez 5 à 10 minutes supplémentaires.

Étape 3 — Vérifier et activer le numéro

Meta envoie un code de vérification au numéro (par SMS ou appel vocal, au choix). Ce code doit être saisi dans le flux d'embedded signup. Une fois validé, le numéro passe au statut VERIFIED dans l'API.

Points de blocage courants à cette étape :

• Le SMS de vérification est filtré comme spam par certains opérateurs. Si le SMS n'arrive pas dans les 2 minutes, basculez sur la vérification par appel vocal.
• Les numéros VoIP peuvent poser problème avec certains opérateurs. Testez avant de promettre la compatibilité à vos clients.
• Un délai d'attente s'applique entre deux tentatives de vérification du même numéro. Si votre client échoue à plusieurs reprises, il devra attendre quelques heures avant de réessayer.

Étape 4 — Configurer le profil du numéro

Avant d'envoyer le premier message, le profil WhatsApp Business du numéro doit être configuré. Ces informations sont visibles par les destinataires des messages.

Champ	Obligatoire	Détail
Display name	Oui	Nom qui s'affiche à côté du numéro
Description	Non	Texte de présentation de l'entreprise
Adresse	Non	Adresse physique
Email	Non	Email de contact
Site web	Non	URL du site
Secteur d'activité	Oui	Catégorie Meta (Retail, Finance, etc.)

Le display name est soumis à approbation Meta. Il doit correspondre au nom de l'entreprise enregistrée dans le Business Manager. Les noms trop génériques ou qui ressemblent à des marques existantes sont refusés. Comptez jusqu'à 24 heures pour la validation.

La configuration se fait via un appel POST à /{phone_number_id}/whatsapp_business_profile.

Étape 5 — Configurer les webhooks et valider l'intégration

Un numéro sans webhook configuré est un numéro sourd : vous pouvez envoyer des messages, mais vous ne recevrez ni les réponses des contacts ni les confirmations de livraison. Les webhooks sont configurés au niveau de l'app Meta (pas au niveau du numéro ou du WABA).

Votre endpoint webhook doit :

1. Répondre au challenge de vérification de Meta (requête GET avec un hub.challenge à renvoyer).
2. Valider la signature HMAC de chaque requête POST entrante.
3. Répondre 200 OK dans les 5 secondes, et traiter les événements de façon asynchrone.

Les événements à abonner pour une intégration complète : messages (messages entrants), message_status_updates (statuts de livraison), message_template_status_updates (approbations/refus de templates).

Une fois les webhooks opérationnels, envoyez un message test depuis le Business Manager Meta pour valider la chaîne complète. Pour aller plus loin sur l'implémentation des webhooks, consultez le guide d'implémentation des webhooks WhatsApp.

Pour comprendre la structure complète de l'écosystème Meta (WABA, Business Manager, Phone Number ID), référez-vous au guide complet de l'API WhatsApp Business.

FAQ

Combien de numéros peut-on ajouter par WABA ?

Par défaut, Meta limite à 20 numéros de téléphone par WABA. Cette limite peut être relevée sur demande auprès de votre Meta Tech Provider, en justifiant le volume attendu. Dans une architecture multi-tenant, chaque client aura généralement 1 à 3 numéros selon ses besoins (ex. numéro marketing + numéro support).

Peut-on ajouter un numéro sans passer par l'embedded signup ?

Oui, via l'API de gestion des numéros (POST /{WABA_ID}/phone_numbers). Cette méthode est plus adaptée aux intégrations backend-only ou aux scénarios où vous provisionnez vous-même les numéros au nom de vos clients. Elle nécessite un token avec les permissions whatsapp_business_management.

Le display name peut-il être modifié après validation ?

Oui, mais chaque modification est soumise à une nouvelle approbation Meta. Pendant la période de révision, l'ancien display name reste actif. Informez vos clients de ce délai avant qu'ils lancent une campagne avec un nouveau nom.

Faut-il un numéro par langue ou par pays pour une plateforme internationale ?

Non, le numéro n'est pas lié à une langue ou à un pays. Un même numéro peut envoyer des messages en français, arabe, anglais ou espagnol. En revanche, si vos clients ont des entités légales distinctes par pays, il peut être judicieux de dédier un numéro par entité pour des raisons de conformité et de reporting.

---

Ajouter un numéro WhatsApp Business à votre plateforme est un processus de quelques heures, à condition de bien le préparer. Les étapes sont clairement définies par Meta ; les blocages surviennent presque toujours au niveau de la vérification du numéro ou du display name. Pour connecter vos clients à l'API WhatsApp sans gérer cette complexité vous-même, découvrez la solution Whakup pour les plateformes, Meta Tech Provider certifié avec embedded signup intégré.