WhatsApp Cloud API expliquée : templates, fenêtre de 24 h, webhooks, sans jargon

Il n'est pas nécessaire d'être développeur pour comprendre WhatsApp Cloud API, mais il est utile d'en connaître cinq notions : elles expliquent pourquoi un message part, pourquoi un autre est refusé, et pourquoi votre plateforme vous demande un « template ». Les voici, sans une ligne de code.

1. Cloud API, On-Premises, BSP : les mots

Cloud API : l'API WhatsApp Business hébergée par Meta. Gratuite d'accès, c'est aujourd'hui la seule voie pour une nouvelle entreprise. « WhatsApp Business Platform » désigne la même chose.

On-Premises API : l'ancienne version, que les entreprises installaient sur leurs serveurs. Meta l'a retirée ; tout le monde est passé sur le Cloud.

BSP (Business Solution Provider, aujourd'hui « Solution Partner ») : une société agréée par Meta qui aide les entreprises à accéder à l'API. Une plateforme comme Risala peut être partenaire ou s'appuyer sur un partenaire ; pour vous, ça ne change rien à l'usage.

2. La fenêtre de 24 heures

Quand un client vous écrit, une fenêtre de 24 heures s'ouvre. Pendant cette fenêtre, vous pouvez lui envoyer n'importe quel message : texte libre, photo, document, boutons. Chaque nouveau message du client remet le compteur à 24 heures.

Hors fenêtre, vous ne pouvez envoyer qu'un template. C'est la règle qui protège les utilisateurs du spam, et c'est elle que Meta applique quand votre plateforme affiche « Fenêtre 24 h fermée ».

3. Les templates

Un template est un message pré-approuvé par Meta, avec des variables. Exemple : « Bonjour {{1}}, votre commande {{2}} est confirmée pour le {{3}}. » Meta le classe dans une catégorie :

• Marketing : promotions, nouveautés, relances commerciales.
• Utilitaire : ce que le client attend (confirmation, livraison, rendez-vous, facture).
• Authentification : codes à usage unique.

La catégorie fixe le prix (au Maroc, 0,0414 $ en marketing, 0,023 $ en utilitaire) et Meta la corrige si le contenu ne correspond pas. Les templates peuvent contenir un en-tête (image, document), des boutons (répondre, appeler, ouvrir un lien) et un pied de page. Ils sont approuvés en quelques minutes à 48 heures ; les refus viennent de variables mal utilisées, de contenus trompeurs ou d'une catégorie inadaptée.

4. Les webhooks

Un webhook est l'adresse à laquelle Meta envoie ce qui se passe sur votre numéro : chaque message reçu, chaque statut (envoyé, délivré, lu, échoué), chaque changement de qualité. Votre plateforme écoute cette adresse en permanence et réagit : afficher le message dans l'inbox, mettre à jour une campagne, déclencher l'assistant IA.

C'est pour ça qu'une plateforme doit être en ligne 24 h/24 : si le webhook ne répond pas, Meta réessaie quelques heures puis abandonne. C'est aussi pour ça que deux plateformes ne peuvent pas écouter le même numéro en même temps.

5. Les limites et la qualité

Meta attribue à chaque numéro une limite de messagerie (250, 1 000, 10 000, 100 000 ou illimité nouveaux clients par 24 h) et une note de qualité (verte, jaune, rouge) fondée sur les blocages et signalements. Les deux évoluent chaque jour ; envoyer au-delà de la limite est simplement refusé, et une qualité rouge fait baisser la limite. Une plateforme sérieuse lit ces valeurs et adapte les envois.

Ce que ça donne, concrètement

Une commande arrive sur votre boutique à 14 h.

1. Votre plateforme envoie le template « confirmation de commande » (utilitaire, 0,023 $). Une fenêtre de 24 h s'ouvre.
2. Le client répond « oui » à 14 h 10 : le webhook transmet la réponse ; la commande passe en « confirmée ».
3. À 16 h, le client demande « c'est possible de livrer samedi ? » : dans la fenêtre, un agent (ou l'IA) répond librement, sans frais.
4. Le lendemain, le colis part : nouveau template « suivi de livraison » (utilitaire), nouvelle fenêtre.

Quatre messages, deux conversations facturées, aucun risque de blocage : le client avait donné son accord en commandant.

Les autres briques utiles

• Messages interactifs : boutons de réponse, listes de choix, dans la fenêtre de 24 h.
• Catalogue et messages produit : envoyer une fiche produit avec bouton d'achat.
• Flows : formulaires dans WhatsApp (prise de rendez-vous, adresse de livraison).
• Appels : depuis 2025, l'API permet les appels vocaux sur certains marchés.
• Coexistence : garder l'application WhatsApp Business sur le téléphone tout en utilisant l'API.

Pour relier votre numéro et démarrer, suivez notre guide WhatsApp Business API au Maroc.

FAQ

Cloud API est-elle gratuite ?

L'accès l'est. Meta facture les conversations ouvertes par vos templates ; les réponses à un client qui vous écrit sont gratuites jusqu'à 1 000 conversations par mois.

Peut-on envoyer un message libre à un client qui n'a jamais écrit ?

Non. Le premier message doit être un template approuvé, et le client doit avoir donné son accord pour le recevoir (opt-in).

Combien de temps un template reste-t-il valable ?

Indéfiniment, tant qu'il n'est pas mis en pause par Meta pour cause de signalements. Un template modifié doit être ré-approuvé.

Qu'est-ce qu'un jeton d'accès (access token) ?

La clé qui autorise votre plateforme à utiliser votre numéro. Elle est générée dans Meta Business Manager et doit rester secrète ; Risala la chiffre et ne l'affiche jamais.