
Depuis 2022, Meta a officiellement annoncé la fin de vie de l'API On-Premise WhatsApp Business au profit de son API Cloud. Pourtant, nombreuses sont les entreprises qui utilisent encore l'ancienne API via des BSP qui maintiennent des infrastructures on-premise. Ce guide compare les deux approches, clarifie ce que "migration vers le Cloud" implique concrètement, et vous aide à comprendre pourquoi cette transition est inévitable.
L'Historique : Comment Sont Nées Ces Deux APIs
L'API On-Premise (ancienne génération) Lancée en 2018, l'API On-Premise WhatsApp fonctionnait selon un modèle "self-hosted" : Meta fournissait un conteneur Docker que les BSP devaient déployer sur leur propre infrastructure. L'entreprise (ou son BSP) gérait les serveurs, la scalabilité, les mises à jour, et la haute disponibilité.
Ce modèle avait des avantages à l'époque : contrôle total sur l'infrastructure, données sur des serveurs maîtrisés, personnalisation possible. Mais il avait des inconvénients majeurs : coût d'infrastructure élevé, complexité opérationnelle, et délais dans la mise à disposition des nouvelles fonctionnalités Meta.
L'API Cloud Meta (nouvelle génération) Lancée en 2022 et maintenant l'API officielle de référence, l'API Cloud délègue toute l'infrastructure à Meta. Plus besoin de serveur Docker, plus de gestion de mise à jour : vous appelez simplement les endpoints REST de Meta et Meta gère le reste.
Meta a officiellement annoncé en 2023 que l'API On-Premise serait dépréciée en 2024, puis la date a été repoussée. En 2025-2026, la plupart des BSP ont migré ou sont en cours de migration vers le Cloud.
Comparaison Technique Côte à Côte
| Critère | API On-Premise | API Cloud Meta |
|---|---|---|
| Infrastructure | Serveurs BSP/client | Serveurs Meta (cloud) |
| Coût infrastructure | Élevé (serveurs, ops) | Inclus (coût Meta/conversation) |
| Latence | Variable (dépend du serveur BSP) | Faible et cohérente |
| Nouvelles fonctionnalités | Délai de mise à jour | Accès immédiat |
| Scalabilité | Manuelle (ajouter des serveurs) | Automatique (Meta scale) |
| Disponibilité | Dépend de l'infra BSP | 99.99% (SLA Meta) |
| Données stockées | Chez BSP/client | Chez Meta (cloud) |
| Conformité RGPD | Maîtrisée | Nécessite DPA avec Meta |
| Support API | Via BSP uniquement | Via BSP + support Meta direct |
| Fonctionnalités avancées | Limitées | Complètes (Flows, Catalog, etc.) |
Fonctionnalités Exclusives à l'API Cloud
L'API Cloud n'est pas seulement une migration infrastructure — elle apporte des fonctionnalités qui n'existent pas (et n'existeront jamais) en On-Premise :
WhatsApp Flows : Formulaires interactifs nativement dans WhatsApp, permettant de collecter des informations, prendre des rendez-vous, ou faire des commandes sans quitter l'application. Exclusif Cloud.
WhatsApp Catalog : Partage de catalogues produits directement dans WhatsApp avec pages produits, prix, et bouton d'achat. Exclusif Cloud.
Messages réactifs enrichis : Formats de messages interactifs avancés (liste menus à 10 items, boutons à 3 options, etc.) avec une meilleure rendu. Améliorations continues exclusives Cloud.
Messagerie AI intégrée : Les futures intégrations IA de Meta (Llama, Meta AI) seront disponibles exclusivement via l'API Cloud.
Différences sur les Appels API
Concrètement, les endpoints sont différents entre les deux APIs :
# API On-Premise (ancienne)
# Base URL chez le BSP ou sur votre serveur
POST https://waba.votrebsp.com/v1/messages
Authorization: Bearer YOUR_TOKEN
{
"to": "33612345678",
"type": "text",
"text": { "body": "Bonjour !" }
}
# API Cloud Meta (nouvelle)
# Base URL chez Meta
POST https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/messages
Authorization: Bearer YOUR_SYSTEM_USER_TOKEN
{
"messaging_product": "whatsapp",
"to": "+33612345678",
"type": "text",
"text": { "body": "Bonjour !" }
}
Différences notables :
- Le format du numéro destinataire inclut le "+" dans l'API Cloud
- Le champ
messaging_product: "whatsapp"est requis dans l'API Cloud - L'URL de base est chez Meta (graph.facebook.com) et non chez votre BSP
- L'authentification utilise un System User Token Meta, pas un token BSP propriétaire
Implications pour la Migration
Si vous êtes encore sur l'API On-Premise (directement ou via un BSP qui maintient cette infrastructure), voici ce que la migration vers le Cloud implique :
Ce qui change pour vos développeurs :
- Mise à jour des URLs de base dans votre code
- Adaptation du format des requêtes (voir ci-dessus)
- Gestion des tokens Meta directement (plus de token BSP propriétaire)
- Configuration des webhooks directement chez Meta
Ce qui ne change pas :
- Votre numéro WhatsApp reste le même
- Vos templates approuvés sont migrés automatiquement
- Vos contacts et conversations (en cours) ne sont pas impactés
- Votre WABA reste le même
La procédure de migration :
- Créer (ou récupérer) votre application Meta
- Récupérer vos Phone Number IDs et WABA ID
- Créer un System User Token
- Mettre à jour votre code (URLs, format requêtes, authentification)
- Reconfigurer vos webhooks chez Meta (pas chez le BSP)
- Tester en parallèle avant de couper l'ancienne infrastructure
Pour la configuration de votre BSP lors d'une migration, consultez notre guide Choisir son BSP WhatsApp. L'aspect sans-développeur de l'API Cloud est couvert dans WhatsApp Business API sans développeur. Pour le contexte complet, lisez le guide WhatsApp Business API.
Cas Particulier : La Conformité des Données
La principale objection à la migration vers l'API Cloud concerne la localisation des données. Sur l'API On-Premise, vos messages transitaient et étaient éventuellement stockés sur des serveurs que vous ou votre BSP contrôliez. Avec l'API Cloud, les données transitent par l'infrastructure Meta aux États-Unis.
Pour les entreprises soumises au RGPD :
- Meta signe un Data Processing Agreement (DPA) avec les BSP et les entreprises utilisant l'API Cloud
- Les transferts UE → USA sont encadrés par le EU-US Data Privacy Framework (DPF) depuis 2023
- Les messages WhatsApp sont chiffrés de bout en bout — Meta ne peut pas les lire
Pour les entreprises africaines soumises à des réglementations locales (APDP en Côte d'Ivoire, CDP au Sénégal, etc.), vérifiez avec votre conseil juridique si des exigences de localisation des données s'appliquent.
FAQ — API Cloud vs API On-Premise WhatsApp
L'API On-Premise est-elle définitivement arrêtée ? Meta a annoncé la fin de vie de l'API On-Premise mais a repoussé la date plusieurs fois. En 2026, la migration est fortement recommandée mais l'ancienne API peut encore fonctionner via certains BSP. Cependant, Meta n'y développe plus de nouvelles fonctionnalités et le support diminue progressivement.
Nos templates doivent-ils être re-soumis lors de la migration ? Non. Vos templates approuvés sont associés à votre WABA, pas à l'infrastructure API. Ils restent valides et disponibles après migration vers l'API Cloud, sans nouvelle soumission nécessaire.
La migration vers le Cloud change-t-elle le coût par message ? Le modèle de facturation Meta reste le même (par conversation, 24h). En revanche, certains BSP on-premise facturaient séparément l'hébergement infrastructure. Cette ligne de coût disparaît avec le Cloud.
Peut-on rester sur l'API On-Premise si on le souhaite absolument ? Si votre BSP maintient encore une infrastructure on-premise, oui. Mais Meta n'y ajoute plus de fonctionnalités, et les BSP migrent progressivement. Il est préférable d'anticiper la migration maintenant plutôt que d'être forcé de le faire dans l'urgence.
Vous souhaitez migrer vers l'API Cloud Meta dans les meilleures conditions ? Créez votre compte Whakup — notre infrastructure est nativement sur l'API Cloud Meta et notre équipe vous accompagne dans la migration de votre configuration existante.

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 gratuitArticles similaires
Checklist Déploiement WhatsApp API : 30 Points de Contrôle avant de Lancer
La checklist complète des 30 points à vérifier avant de lancer votre API WhatsApp Business en production. De la configuration technique aux templates en passant par la conformité et le monitoring.
Créer un Template HSM WhatsApp Approuvé par Meta : Guide Étape par Étape
Guide complet pour créer des templates HSM WhatsApp qui passent la modération Meta du premier coup. Structure, règles de contenu, exemples concrets et conseils d'optimisation.
Display Name WhatsApp Business : Règles, Validation et Optimisation pour votre Marque
Tout savoir sur le Display Name WhatsApp Business : règles de validation Meta, bonnes pratiques, causes de rejet et stratégies pour optimiser le nom affiché de votre marque sur WhatsApp.