L'API WhatsApp Cloud expliquée
L'API WhatsApp Cloud est la version de l'API de la WhatsApp Business Platform que Meta héberge pour vous. Votre logiciel envoie des messages par requêtes HTTPS et reçoit les réponses et les statuts de distribution par webhook. Meta a mis fin à l'ancienne API On-Premises le 23 octobre 2025 ; les entreprises utilisent donc désormais la Cloud API.
Par Mousa Alhelo, fondateur, E-SAFQA · Mis à jour · 7 min de lecture · Comment nous rédigeons et testons ces guides
Qu'est-ce que l'API WhatsApp Cloud ?
L'API WhatsApp Cloud est l'interface hébergée par Meta pour la WhatsApp Business Platform. Un développeur, ou un fournisseur qui construit l'intégration pour vous, l'appelle en HTTPS via la Graph API de Meta pour envoyer des messages texte, des médias et des messages interactifs depuis un numéro de téléphone professionnel. Les réponses et les mises à jour de statut des messages reviennent vers une URL de webhook que vous contrôlez. Vous n'exploitez aucun serveur WhatsApp vous-même, ce qui explique que le blog de Meta pour les développeurs la décrive comme la Cloud API, hébergée par Meta.
C'est un produit pour développeurs, pas une application. Il n'y a ni boîte de réception ni tableau de bord tant que vous ou un fournisseur n'en construisez pas, et c'est pourquoi beaucoup de boutiques rencontrent la Cloud API par l'intermédiaire d'un Business Solution Provider ou d'une application bâtie dessus.
Qu'est-il arrivé à l'API On-Premises ?
Avant la Cloud API, une entreprise pouvait héberger le client On-Premises de WhatsApp sur ses propres serveurs. Meta l'a retiré par étapes, et sa page d'arrêt donne les dates ci-dessous (vérifiées en octobre 2026).
- Si un fournisseur ou une ancienne intégration parle encore d'hébergement On-Premises, demandez s'il a été migré vers la Cloud API.
| Date | Ce qui a changé |
|---|---|
| 9 janvier 2024 | Les nouvelles fonctionnalités n'arrivent plus que sur la Cloud API. Le client On-Premises ne reçoit que des correctifs de bogues et de sécurité. |
| 1er juillet 2024 | Les nouveaux numéros de téléphone professionnels ne peuvent être enregistrés que pour la Cloud API. Tenter d'en enregistrer un pour On-Premises renvoie le code d'erreur 1005. |
| 23 octobre 2025 | La dernière version On-Premises a expiré. Elle ne peut plus envoyer de messages, et les messages vers ou depuis les numéros encore enregistrés dessus ne sont pas distribués. |
Que faut-il pour commencer à utiliser la Cloud API ?
Le guide de démarrage de Meta liste les prérequis en octobre 2026 : un compte Facebook ou un compte Meta géré, l'inscription comme développeur, un portefeuille d'entreprise (business portfolio) et un appareil compatible WhatsApp pour les messages de test. Voici les principales étapes.
- Créez une application Meta avec le cas d'usage WhatsApp dans le tableau de bord des applications Meta, et rattachez-y votre portefeuille d'entreprise.
- Connectez un compte WhatsApp et un compte de messagerie (Messaging account). La documentation récente de Meta emploie ces deux termes ; le compte de messagerie contient vos modèles de message et vos informations de facturation, et votre ancien identifiant WABA l'identifie désormais.
- Envoyez un message de test depuis le numéro de test avec un jeton d'accès temporaire.
- Configurez un webhook pour que les mises à jour de statut et les réponses des clients arrivent sur votre serveur.
- Créez un utilisateur système et un jeton d'accès permanent avec les autorisations whatsapp_business_messaging et whatsapp_business_management.
- Enregistrez votre propre numéro de téléphone professionnel et donnez-lui un nom d'affichage. Un numéro déjà utilisé sur WhatsApp doit d'abord être supprimé, sauf si vous l'intégrez grâce à la fonction de coexistence de Meta pour les utilisateurs de l'application WhatsApp Business.
Comment fonctionnent les messages et les limites sur la Cloud API ?
Meta indique trois façons de faire passer la limite de départ de 250 à 2 000 : vérifier votre entreprise, la faire vérifier par un partenaire, ou distribuer 2 000 messages modèles de bonne qualité en 30 jours. Les paliers supérieurs de 10 000, 100 000 et illimité se débloquent automatiquement à mesure que votre qualité et votre usage progressent.
| Règle | Ce que Meta documente |
|---|---|
| Consentement (opt-in) | Vous ne pouvez écrire qu'aux personnes qui ont accepté de recevoir des messages de votre entreprise. |
| Fenêtre de service client | Lorsqu'un client vous écrit, une fenêtre de 24 heures s'ouvre et se renouvelle à chaque nouveau message du client. À l'intérieur, vous pouvez envoyer des messages de service en texte libre. |
| Messages modèles | En dehors de la fenêtre, vous ne pouvez envoyer que des modèles préapprouvés des catégories marketing, utilitaire (utility) ou authentification. |
| Limite de messagerie | Le nombre de clients uniques que vous pouvez contacter hors fenêtre de service sur 24 heures glissantes est fixé par portefeuille d'entreprise. Les nouveaux portefeuilles démarrent à 250. |
| Débit | Un numéro de téléphone professionnel envoie par défaut jusqu'à 80 messages par seconde, et vous pouvez demander plus. |
Combien coûte l'API WhatsApp Cloud ?
Meta facture chaque message distribué. Depuis le 1er juillet 2025, la tarification se fait au message et non plus à la conversation, et le tarif dépend de la catégorie du message (marketing, utilitaire, authentification ou service) et de l'indicatif du pays du destinataire. L'Arabie saoudite fait partie des marchés nommés dans la grille tarifaire de Meta : les messages vers des numéros +966 sont donc facturés à leur propre tarif (voir /fr/blog/whatsapp-api-saudi-arabia-pricing). Meta ne facture pas les messages que les clients envoient à une entreprise.
Depuis le 1er octobre 2026, les réponses de service dans la fenêtre de 24 heures sont elles aussi facturées. La page tarifaire de Meta indique une franchise gratuite de 1 000 messages de service par numéro de téléphone professionnel et par mois. Les fournisseurs ajoutent leurs propres frais de plateforme, qui ne figurent pas dans la grille de Meta. Pour les tarifs actuels et un exemple chiffré, consultez notre guide des prix à /fr/blog/whatsapp-business-api-pricing-explained.
Cloud API, application WhatsApp Business ou application par appareil connecté ?
| Cloud API | Application WhatsApp Business | Application par appareil connecté (WhatsApp Pilot) | |
|---|---|---|---|
| Qui construit l'expérience | Un développeur ou un fournisseur | WhatsApp, sous forme d'application gratuite | WhatsApp Pilot, une application Shopify d'E-SAFQA |
| Numéro | Un numéro professionnel enregistré auprès de l'API | Votre numéro dans l'application | Votre propre numéro, connecté par code QR |
| Frais par message de Meta | Oui, par message distribué | Aucun | Aucun |
| Modèles | Obligatoires hors de la fenêtre de 24 heures | Non utilisés | Texte libre que vous modifiez dans l'application |
| Statut distribué et lu | Remonté par webhook | Affiché dans l'application | Non disponible avec un appareil connecté |
| Idéal pour | Gros volumes, campagnes, plusieurs agents, chatbots | Une personne qui répond aux discussions | Une boutique qui envoie des messages de commande depuis son propre numéro |
Une boutique Shopify a-t-elle besoin de la Cloud API ?
Pas toujours. Si vous avez besoin de gros volumes, de modèles approuvés, du statut distribué et lu ou d'un chatbot, la Cloud API est la bonne base, en général via un fournisseur. Si une seule boutique veut surtout des confirmations de commande, des avis d'expédition et des rappels fondés sur le consentement depuis le numéro WhatsApp que ses clients connaissent déjà, une application par appareil connecté est plus simple.
WhatsApp Pilot, une application Shopify d'E-SAFQA, connecte votre propre numéro WhatsApp comme appareil connecté en scannant un code QR. Il n'y a pas d'API WhatsApp Business ni de frais par message de Meta ; Pro coûte USD 15 tous les 30 jours. La contrepartie : les accusés de distribution et de lecture ne sont pas disponibles. Les détails sont sur /fr/how-it-works/whatsapp-connection.
Questions fréquentes
Qu'est-ce que l'API WhatsApp Cloud ?
C'est l'API hébergée par Meta pour la WhatsApp Business Platform. Un logiciel lui envoie des messages en HTTPS et reçoit les réponses et les mises à jour de statut par webhook, sans exploiter ses propres serveurs WhatsApp.
L'API WhatsApp Cloud est-elle gratuite ?
Non. Meta facture chaque message distribué selon la catégorie et le pays, et les fournisseurs ajoutent des frais de plateforme. Depuis le 1er octobre 2026, les réponses de service sont facturées elles aussi, après une franchise gratuite de 1 000 par numéro de téléphone et par mois.
Qu'est-il arrivé à l'API On-Premises ?
Meta a cessé d'ajouter des fonctionnalités en janvier 2024, fermé les nouvelles inscriptions le 1er juillet 2024 et mis fin à la prise en charge le 23 octobre 2025. Les numéros professionnels fonctionnent désormais sur la Cloud API.
Puis-je utiliser la Cloud API et l'application WhatsApp Business sur un même numéro ?
Seulement grâce à la fonction de coexistence de Meta, configurée lors de l'intégration. Sinon, un numéro déjà utilisé sur WhatsApp doit être supprimé avant de pouvoir être enregistré pour la Cloud API.
Faut-il une vérification d'entreprise pour utiliser la Cloud API ?
Vous pouvez commencer sans. Meta présente la vérification comme un moyen de faire passer votre limite de messagerie de 250 à 2 000 clients par jour, et le statut de compte professionnel officiel (Official Business Account) l'exige.
Prêt à mettre WhatsApp au service de votre boutique ?
Commencez avec le widget gratuit. Passez à Pro pour les messages de commande et d'expédition, la récupération de paniers, les codes d'achat répété, le bouton WhatsApp produit intelligent, les alertes de retour en stock et Product Demand.