Migration BSP WhatsApp : les 7 étapes clés sans downtime

Changer de BSP (Business Solution Provider) WhatsApp est souvent perçu comme un projet à haut risque : perte du numéro, blocage des templates, interruption des OTP. La réalité est plus rassurante à condition de suivre une méthode rigoureuse. Voici les 7 étapes clés pour migrer votre WhatsApp Business API sans downtime, adaptées au contexte marocain.

Étape 1 : cartographier l'existant

Avant tout, dresser un inventaire précis :

• Numéro WhatsApp actuel et statut vérifié (Green Tick, Blue Tick le cas échéant).
• Liste complète des templates approuvés, avec leurs catégories, langues et variables.
• Volume mensuel de messages par catégorie (Authentication, Utility, Marketing, Service).
• Intégrations en place : CRM, ERP, webhooks, Zapier, chatbot.
• Fournisseurs auxiliaires : SMS Failback, envoi email, agrégateur.

Cette cartographie devient le référentiel qui garantit qu'aucune brique ne sera oubliée dans la migration.

Étape 2 : choisir le nouveau BSP

Critères à évaluer :

• Certification Meta et présence dans le répertoire Business Partners.
• Support technique local francophone ou arabophone, disponible pendant les horaires marocains.
• Tarification transparente en MAD et prix par message documentés.
• Fonctionnalités clés : SMS Failback intégré, gestion des flows, chatbot, reporting.
• SLA contractuel et procédure de sortie tout aussi claire que l'entrée.

Étape 3 : préparer le compte cible

Sur le nouveau BSP, préparer en amont :

• Vérification Meta Business (si compte différent) avec RC, patente, pièce d'identité.
• Création de l'environnement technique : clés API, webhooks, comptes utilisateurs.
• Recréation des templates à l'identique, avec exactement les mêmes noms, langues et variables. Meta approuvera généralement en 24 heures.
• Environnement de test avec un numéro secondaire pour valider les parcours avant bascule.

Étape 4 : orchestrer le transfert du numéro

C'est l'étape la plus sensible. WhatsApp permet le migrate phone number entre WABAs sans perdre les templates ni la note qualité, mais impose plusieurs conditions :

• Désactiver la vérification en deux étapes sur l'ancien BSP juste avant la migration.
• Coordonner la fenêtre de bascule entre les deux prestataires, idéalement en heures creuses (nuit ou week-end).
• Prévoir une communication interne : équipes support et marketing informées de la fenêtre.

La bascule effective prend en général quelques minutes, mais les tests post-migration peuvent occuper plusieurs heures.

Étape 5 : réactiver les intégrations

Une fois le numéro sur le nouveau BSP :

1. Repointer les webhooks entrants du CRM ou de l'ERP vers la nouvelle URL BSP.
2. Remplacer les clés API et tokens dans tous les scripts d'envoi (backend, Zapier, Make).
3. Vérifier le fonctionnement du SMS Failback avec l'agrégateur IAM, Orange, Inwi.
4. Relancer les tests fonctionnels : OTP, notification de commande, réponse support.

Étape 6 : bascule progressive

Plutôt qu'un big bang, il est prudent de basculer par lots :

• Jour 1 : messages internes et tests contrôlés.
• Jour 2-3 : 10 % du trafic réel, monitoring intensif.
• Jour 4-7 : montée progressive à 100 %, avec possibilité de rollback rapide.

Cette approche permet d'identifier tôt un souci de configuration ou de performance sans impacter l'ensemble des clients.

Étape 7 : clôturer l'ancien BSP

Une fois la migration stabilisée sur 15 à 30 jours :

• Récupérer l'historique complet des messages depuis l'ancien BSP (export CSV ou API).
• Résilier proprement le contrat, en respectant le préavis contractuel.
• Supprimer les clés API obsolètes des serveurs et outils tiers.
• Archiver la documentation de migration pour audit conformité réglementaire éventuel.

Erreurs classiques à éviter

• Négliger la sauvegarde des templates avant migration : leur recréation manuelle est fastidieuse.
• Migrer en pleine campagne marketing ou en période de pic OTP.
• Oublier de désactiver la 2FA sur l'ancien BSP, ce qui bloque le migrate.
• Ne pas prévoir de plan de rollback documenté.

Conclusion

Une migration BSP WhatsApp bien préparée se déroule sans downtime perceptible pour les clients et sans perte de la note qualité du numéro. Le vrai risque n'est pas technique, il est organisationnel : sous-estimer la coordination entre les deux prestataires, oublier une intégration ou lancer la bascule au mauvais moment. Avec un planning rigoureux et un pilote unique côté client, l'opération devient un exercice contrôlé plutôt qu'un saut dans le vide.