API WhatsApp et les templates : guide pour les plateformes emailing

Pour une plateforme emailing qui intègre WhatsApp comme canal supplémentaire, les templates sont l'équivalent des blocs de contenu email : ils définissent le format, le contenu approuvé et les règles d'envoi. Mais contrairement à l'email où vous avez une liberté totale sur le contenu des campagnes, tout message WhatsApp proactif doit passer par un template préalablement approuvé par Meta. Comprendre ce mécanisme est indispensable pour construire une expérience utilisateur fluide dans votre plateforme et éviter les blocages d'approbation.

Qu'est-ce qu'un template WhatsApp et quand est-il obligatoire

Un template WhatsApp (appelé Message Template dans l'API) est un format de message pré-approuvé par Meta. Il est obligatoire dans deux situations :

1. Vous initiez une conversation avec un utilisateur qui n'a pas écrit en premier dans les dernières 24 heures.
2. La fenêtre de session de 24h est fermée : même si l'utilisateur a initié la conversation, au-delà de 24h sans activité, tout nouveau message sortant doit être un template.

En dehors de ces cas, dans une fenêtre de session active (moins de 24h depuis le dernier message entrant), vous pouvez envoyer des messages libres sans template.

Pour une plateforme emailing, le cas d'usage principal est l'envoi proactif (newsletters WhatsApp, notifications transactionnelles, relances) : tous ces envois nécessitent des templates approuvés.

Les trois catégories de templates et leur impact sur les coûts

Meta a structuré les templates en trois catégories. Cette classification est déterminée à l'approbation et impacte directement le tarif facturable.

Catégorie	Usage	Coût Meta (FR)	Coût total Whakup (FR)
Marketing	Promotions, offres, newsletters	0,0712 €/conversation	~0,08 €/conversation
Utility	Notifications transactionnelles, rappels	0,0248 €/conversation	~0,0336 €/conversation
Authentication	OTP, vérification d'identité	< 0,0248 €/conversation	< 0,0336 €/conversation

Le tarif Meta s'applique par conversation de 24h, pas par message. Si vous envoyez 3 messages dans une fenêtre de 24h, vous payez une seule conversation. C'est une différence fondamentale avec le coût par message du SMS.

La classification correcte de vos templates est donc un levier économique direct. Un template de confirmation de commande mal classé en "marketing" coûte 3 fois plus cher qu'en "utility". Consultez le guide des catégories de templates WhatsApp pour maîtriser les critères de classification.

Structure technique d'un template WhatsApp

Un template se compose de plusieurs sections optionnelles, mais le body est obligatoire :

Header (optionnel) : texte, image, document ou vidéo
Body (obligatoire) : texte avec variables {{1}}, {{2}}, etc.
Footer (optionnel) : texte informatif (ex: "Pour vous désabonner, répondez STOP")
Buttons (optionnel) : CTA (URL, appel téléphonique) ou Quick Reply

Exemple de template utility pour une confirmation de commande :

Header: Votre commande est confirmée
Body: Bonjour {{1}}, votre commande #{{2}} d'un montant de {{3}} € a bien été enregistrée. 
      Livraison prévue le {{4}}.
Footer: Répondez STOP pour ne plus recevoir de notifications
Buttons: [Suivre ma commande] → https://votresite.com/suivi/{{5}}

Les variables ({{1}}, {{2}}...) sont renseignées dynamiquement à l'envoi via l'API. Chaque variable doit avoir un exemple de valeur fourni lors de la soumission à Meta.

Pour le détail des paramètres d'appel API, référez-vous au guide complet de l'API WhatsApp Business.

Processus d'approbation Meta et délais

L'approbation d'un template passe par le Meta Business Manager ou via l'API de gestion des templates. Les délais et règles :

• Délai standard : 24 à 48h en automatique pour la majorité des templates bien formulés.
• Refus courants : contenu trop vague, manque d'exemple de variables, formulations ambiguës entre utility et marketing, promesses non vérifiables.
• Statuts : PENDING → APPROVED ou REJECTED → relecture manuelle possible.

Bonnes pratiques pour maximiser le taux d'approbation :

• Soyez explicite sur le contexte transactionnel pour les templates utility ("Suite à votre achat du [date]…").
• Fournissez des exemples de variables réalistes, pas des placeholders génériques.
• Évitez les formulations promotionnelles dans un template destiné à être classé utility.
• Testez avec un numéro de sandbox avant de soumettre en production.

Pour les plateformes multi-clients, chaque client final possède son propre compte WhatsApp Business et doit soumettre ses propres templates. La gestion centralisée des templates pour tous les clients est une fonctionnalité clé à implémenter dans votre backoffice.

Intégration des templates dans une plateforme emailing

Pour exposer la création de templates WhatsApp à vos utilisateurs finaux dans l'interface de votre plateforme, voici les points d'intégration API à couvrir :

Création de template : POST /v1/configs/templates avec le contenu, la catégorie et les exemples de variables.

Vérification du statut : GET /v1/configs/templates/{template_name} — à poller ou à gérer via webhook de mise à jour de statut.

Envoi d'un message avec template : POST /v1/messages avec le nom du template et les valeurs des variables dynamiques.

Suppression d'un template : DELETE /v1/configs/templates/{template_name} — nécessaire si un template approuvé doit être modifié (il faut supprimer et recréer).

Un template approuvé ne peut pas être modifié. Toute modification nécessite la création d'un nouveau template avec un nom différent et une nouvelle soumission à l'approbation.

Pour les plateformes qui passent par l'API WhatsApp Business de Whakup, la gestion des templates est intégrée dans l'API REST, avec un endpoint de suivi de statut d'approbation.

Gestion de la bibliothèque de templates à l'échelle

Une plateforme emailing gérant des dizaines de clients finaux doit prévoir une organisation rigoureuse des templates :

• Convention de nommage : préfixez les noms par client ou par cas d'usage (client_a_confirmation_commande, client_b_alerte_livraison). Les noms de templates sont uniques par compte WhatsApp Business.
• Versioning : quand un template doit évoluer, créez une nouvelle version avec un suffixe (_v2) plutôt que de supprimer l'ancien en production.
• Monitoring de qualité : Meta suit les taux de signalement de chaque template. Un template trop souvent marqué comme spam peut être désactivé. Monitorez ces métriques dans votre backoffice.
• Traduction : un template peut avoir plusieurs langues approuvées séparément. Gérez les locales comme des entités distinctes.

Pour une analyse complète des coûts avant de dimensionner votre infrastructure, consultez la page prix de l'API WhatsApp Business en 2026.

FAQ

Combien de templates peut-on avoir par compte WhatsApp Business ?

Meta impose une limite de 250 templates par compte WhatsApp Business pour les comptes récents. Cette limite augmente avec le temps et le volume d'envoi. Pour les plateformes gérant de nombreux cas d'usage, prévoyez une stratégie de gestion du cycle de vie des templates (archivage des templates inutilisés).

Peut-on modifier une variable dans un template approuvé sans repasser par l'approbation ?

Non, le contenu textuel d'un template approuvé est figé. Seules les valeurs des variables sont renseignées dynamiquement à l'envoi. Toute modification du texte fixe, des boutons ou de la structure nécessite une nouvelle soumission à l'approbation.

Comment gérer un template refusé par Meta ?

Lisez le motif de refus dans le Business Manager. Les raisons les plus fréquentes sont : contenu trop vague, absence d'exemple de variable, contenu potentiellement trompeur. Reformulez en restant factuel et contextuel, refournissez des exemples précis et resoumettez. En cas de refus répété sans explication claire, une demande de review manuelle est possible.

Les templates WhatsApp peuvent-ils contenir des images ou des boutons ?

Oui. Le header d'un template peut contenir une image, un document ou une vidéo. Les boutons peuvent être de type "URL" (redirection vers une page web), "Appel téléphonique" ou "Réponse rapide" (déclenchement d'un flux chatbot). Ces éléments enrichis doivent être inclus dans la soumission initiale et sont soumis à l'approbation de Meta.

---

La gestion des templates WhatsApp est le cœur technique du canal pour une plateforme emailing. Whakup, Meta Tech Provider certifié, vous donne accès à l'API WhatsApp Business avec une gestion intégrée des templates, un suivi des statuts d'approbation et un support à la conformité Meta. Pas de certification à passer : vous activez le canal et créez vos templates directement.