Migrer son Numéro WhatsApp Existant vers l'API Business : Étapes et Précautions

Votre entreprise utilise déjà WhatsApp Business App avec un numéro que vos clients connaissent. Migrer ce numéro vers l'API WhatsApp Business est la meilleure façon de conserver votre capital de contacts tout en passant à une infrastructure professionnelle scalable. Mais cette migration comporte des risques si elle est mal préparée. Ce guide vous donne toutes les étapes et précautions pour réussir sans perdre de données ni de disponibilité.

Ce que la Migration Implique Réellement

Avant de se lancer, il faut comprendre ce que signifie concrètement "migrer" vers l'API WhatsApp Business. Vous changez de couche technologique : vous passez d'une application installée sur un smartphone à une API cloud pilotée par code ou par un BSP comme Whakup.

Ce qui est préservé après migration :

• Votre numéro de téléphone (les clients gardent votre contact)
• Votre display name si vous le reproduisez à l'identique
• La notoriété de votre numéro (score de qualité initial préservé)

Ce qui est perdu définitivement :

• L'historique complet de vos conversations
• Les messages en attente dans la file d'envoi
• Les paramètres de l'application WhatsApp Business (heures d'ouverture, réponses auto configurées dans l'app)
• Les groupes WhatsApp auxquels votre numéro appartient

Ce qui change dans l'expérience utilisateur :

• Le badge "Business" peut évoluer selon votre niveau de vérification Meta
• Les messages arrivent désormais via l'infrastructure API (légèrement différent visuellement selon le BSP)
• Vous ne pouvez plus utiliser l'application smartphone sur ce numéro

Cette liste n'est pas là pour vous décourager, mais pour vous permettre de préparer la migration en connaissance de cause, notamment en communiquant aux clients concernés si des interruptions temporaires sont prévues.

Prérequis à Vérifier Avant la Migration

La migration est techniquement bloquée si ces prérequis ne sont pas remplis. Vérifiez chacun avant de commencer :

Prérequis Meta :

• Compte Meta Business Manager créé et vérifié (voir vérification compte Meta Business)
• Compte WABA (WhatsApp Business Account) créé
• App Meta créée et configurée

Prérequis liés au numéro :

• Le numéro doit pouvoir recevoir un SMS ou un appel vocal pour la vérification
• Si le numéro est sur une SIM, vous devez avoir physiquement accès à cette SIM (ou pouvoir la rediriger vers un autre appareil)
• Le numéro ne doit pas être actif sur un autre WABA

Prérequis opérationnels :

• Avoir identifié une plage de maintenance (la migration crée une interruption de service de quelques minutes à quelques heures)
• Avoir informé votre équipe support de la migration
• Avoir sauvegardé toutes les données importantes de l'application actuelle

Procédure de Migration Détaillée

Voici les étapes précises de la migration, dans l'ordre à respecter impérativement :

Étape 1 — Sauvegarder les données de l'app existante

1. Dans WhatsApp Business App : Paramètres > Chats > Sauvegarde des chats
2. Exportez manuellement les conversations critiques (option "Exporter la discussion" sur chaque chat important)
3. Notez tous les paramètres configurés dans l'app : message d'absence, message d'accueil, réponses rapides, catalogue produits
4. Exportez le catalogue produits si vous en avez un (Paramètres > Outils Business > Catalogue)

Étape 2 — Désactiver Two-Step Verification dans l'app Si vous avez activé la vérification en deux étapes dans WhatsApp Business App, désactivez-la avant la migration : Paramètres > Compte > Vérification en deux étapes > Désactiver

Cette étape est critique : si vous migrez avec le PIN de vérification actif, vous devrez le fournir lors de l'enregistrement API — si vous l'avez oublié, la migration est bloquée.

Étape 3 — Supprimer le compte WhatsApp Business App

1. Paramètres > Compte > Supprimer mon compte
2. Saisissez votre numéro de téléphone pour confirmer
3. Confirmez la suppression — cette action est irréversible

A ce stade, votre numéro n'est plus actif sur aucun compte WhatsApp.

Étape 4 — Enregistrement sur l'API WhatsApp Business

Via cURL ou votre BSP, lancez l'enregistrement du numéro :

# Lancer la vérification OTP (SMS ou appel vocal)
curl -X POST \
  "https://graph.facebook.com/v19.0/YOUR_PHONE_NUMBER_ID/request_code" \
  -H "Authorization: Bearer YOUR_SYSTEM_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code_method": "SMS",
    "language": "fr"
  }'

# Une fois le code reçu, l'enregistrer
curl -X POST \
  "https://graph.facebook.com/v19.0/YOUR_PHONE_NUMBER_ID/verify_code" \
  -H "Authorization: Bearer YOUR_SYSTEM_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "123456"
  }'

Étape 5 — Configurer le profil business Renseignez le display name, la description, le logo, l'adresse et le site web via l'API ou l'interface de votre BSP. Reproduisez fidèlement les informations de votre profil précédent.

Étape 6 — Configurer le Two-Step Verification sur l'API Réactivez la vérification en deux étapes avec un nouveau PIN que vous consignerez en lieu sûr. Voir notre article sur la vérification en deux étapes pour la procédure API.

Étape 7 — Tester et valider Envoyez un message test à votre propre numéro de téléphone. Vérifiez que les webhooks reçoivent bien les événements. Validez le fonctionnement bout-en-bout avant d'annoncer la reprise de service.

Gestion de la Continuité de Service

La migration crée inévitablement une fenêtre d'indisponibilité. Pour la minimiser :

Communiquez en amont : Si vous avez des clients actifs sur ce numéro WhatsApp, envoyez un message de prévention 24 à 48 heures avant ("Notre service WhatsApp sera temporairement indisponible le [date] de [heure] à [heure] pour maintenance.").

Planifiez en dehors des heures de pointe : Choisissez une plage de faible activité — nuit ou week-end selon votre secteur.

Préparez un numéro de secours : Ayez un numéro de contact alternatif (email, autre canal) à communiquer si la migration prenait plus de temps que prévu.

Prévoyez un plan B : Si la migration échoue (numéro bloqué, OTP non reçu), sachez que vous pouvez recréer le compte WhatsApp Business App sur un autre appareil avec le même numéro en attendant de relancer la procédure.

Pour plus de détails sur le choix du numéro optimal avant migration, consultez notre article Numéro dédié WhatsApp Business API, et notre guide principal WhatsApp Business API.

FAQ — Migration Numéro WhatsApp vers l'API

Peut-on migrer sans supprimer le compte WhatsApp existant ? Non. Meta n'autorise pas un numéro à être simultanément actif sur WhatsApp Business App et l'API WhatsApp Business. La suppression du compte existant est une étape obligatoire avant l'enregistrement API.

Mes contacts vont-ils perdre mon numéro après la migration ? Non. Votre numéro reste identique. Vos contacts qui l'ont enregistré dans leur téléphone peuvent toujours vous envoyer des messages. Ils verront simplement que votre profil business a été mis à jour.

Que se passe-t-il si je ne reçois pas le SMS de vérification OTP ? Si le SMS n'arrive pas dans les 5 minutes, relancez la procédure avec l'option "appel vocal" ("code_method": "VOICE"). Si votre numéro est en itinérance ou à l'étranger, l'appel vocal est souvent plus fiable que le SMS.

Combien de temps prend la migration en pratique ? La procédure technique prend entre 30 minutes et 2 heures. La principale variable est le délai de réception de l'OTP et le délai d'approbation Meta du display name (quelques heures à 24 heures). Prévoyez une fenêtre de maintenance de 4 heures pour être serein.

---

Vous migrez votre numéro et souhaitez un accompagnement expert ? Créez votre compte Whakup — notre équipe technique vous guide à travers chaque étape de la migration pour garantir une transition sans interruption de service.