API WhatsApp et les templates : guide pour les plateformes de chatbot IA

Les templates WhatsApp — appelés HSM (Highly Structured Messages) dans la documentation Meta — sont les messages pré-approuvés que les entreprises doivent utiliser pour initier une conversation avec un contact. Pour une plateforme de chatbot IA, les templates jouent un rôle précis : ils déclenchent le premier contact ou relancent une conversation expirée, après quoi le chatbot peut répondre librement pendant 24 heures. Comprendre cette mécanique est indispensable pour concevoir des flux conversationnels cohérents.

Pourquoi les chatbots IA ont besoin des templates

Un chatbot WhatsApp IA ne peut pas envoyer le premier message à un contact de façon libre — Meta l'interdit. Il doit utiliser un template approuvé. Voici la logique :

• Hors fenêtre de service : le contact n'a pas envoyé de message dans les dernières 24 heures. L'entreprise ne peut envoyer que des templates approuvés.
• Dans la fenêtre de service : le contact a envoyé un message dans les dernières 24 heures. L'entreprise peut répondre librement avec des messages non-template — c'est la zone de liberté du chatbot IA.

Pour un chatbot IA, la séquence type est :

1. Template d'initiation (ou de relance) → ouvre la fenêtre de 24h.
2. Messages libres du chatbot → le LLM répond librement pendant 24h.
3. Si le contact répond → la fenêtre se prolonge (ou se renouvelle).
4. Après 24h sans réponse → retour au template pour relancer.

Ce n'est pas une contrainte technique secondaire : c'est ce qui structure les workflows de votre plateforme de chatbot.

Les catégories de templates et leur impact sur les flux IA

Meta distingue trois catégories de templates, chacune avec des règles différentes :

Catégorie	Usage	Coût conversation (FR)	Liberté de contenu
Marketing	Promotions, relances, campagnes	~0,08 €	Élevée (sous conditions)
Utility	Confirmations, rappels, alertes	~0,0336 €	Modérée (contextuel)
Authentication	OTP, codes de vérification	Tarif Meta variable	Très encadrée

Pour un chatbot IA, les templates utility sont souvent les plus pertinents pour les relances conversationnelles (rappel de rendez-vous, suivi de commande, relance d'un échange interrompu). Les templates marketing servent à initier de nouvelles séquences promotionnelles.

Erreur fréquente : utiliser un template marketing pour relancer un échange de service. Meta peut rejeter le template ou le recatégoriser, et le coût est plus élevé.

Construire des templates adaptés aux chatbots IA

Un template WhatsApp se compose de plusieurs sections :

• Header (optionnel) : texte, image, vidéo ou document.
• Body (obligatoire) : texte avec variables {{1}}, {{2}}, etc.
• Footer (optionnel) : texte statique.
• Buttons (optionnel) : jusqu'à 3 boutons (call-to-action ou quick reply).

Pour les chatbots IA, les boutons quick reply sont particulièrement puissants : ils permettent de proposer des choix prédéfinis au contact avant même que la fenêtre de service soit ouverte.

Exemple de structure pour un chatbot de support :

Header : Bonjour {{1}} 👋
Body : Vous avez récemment contacté notre support. 
       Pouvons-nous vous aider à finaliser votre demande ?
Buttons :
  [Oui, j'ai besoin d'aide]
  [Non, c'est résolu]
  [Parler à un agent]

Quand le contact clique "Oui, j'ai besoin d'aide", un événement button_reply arrive sur votre webhook avec l'id du bouton. Le chatbot IA peut alors prendre le relais avec des messages libres.

Règles d'approbation à respecter :

• Pas de variables dans le header pour les templates marketing.
• Le body ne peut pas être entièrement composé de variables (Meta rejette les templates "vides de sens").
• Les boutons call-to-action doivent pointer vers des URLs valides et accessibles.
• Pas de contenu sensible, trompeur ou contraire aux politiques Meta.

Pour une vue détaillée des règles par catégorie, consultez notre guide sur les templates WhatsApp et leurs catégories.

Intégrer les templates dans votre plateforme de chatbot

Votre plateforme de chatbot IA doit gérer le cycle de vie complet des templates :

Création et soumission :

• Interface visuelle pour construire les templates (body, variables, boutons).
• Soumission automatique à Meta via l'API Graph (/whatsapp_message_templates).
• Affichage du statut d'approbation en temps réel (webhook message_template_status_update).

Gestion des refus :

• Afficher le motif de refus Meta (trop promotionnel, variable manquante, lien invalide…).
• Permettre la modification et la re-soumission directement dans l'interface.
• Conseiller le client sur les modifications à apporter.

Versionnement :

• Quand un template approuvé est modifié, Meta crée une nouvelle version soumise à ré-approbation.
• L'ancienne version reste active jusqu'à approbation de la nouvelle.
• Votre plateforme doit gérer ce cycle sans interrompre les campagnes en cours.

Utilisation dans les workflows chatbot :

• Permettre la sélection d'un template approuvé comme déclencheur d'un flux conversationnel.
• Mapper les variables du template aux données du contact (prénom, numéro de commande, etc.).
• Logger l'utilisation de chaque template pour le reporting (combien de fois utilisé, taux de réponse).

Notre API WhatsApp pour plateformes de chatbot expose un endpoint de gestion des templates avec synchronisation automatique des statuts Meta. Découvrez aussi notre guide complet de l'API WhatsApp Business et notre analyse build vs buy pour évaluer le coût de développer cette couche vous-même.

FAQ

Un chatbot IA peut-il envoyer des messages entièrement générés par LLM sans template ?

Oui, mais uniquement dans la fenêtre de service de 24 heures, c'est-à-dire après que le contact a envoyé un message. En dehors de cette fenêtre, seuls des templates approuvés par Meta peuvent être envoyés. Un chatbot 100% libre n'est possible que sur un flux entrant (le contact initie toujours la conversation).

Combien de temps prend l'approbation d'un template par Meta ?

En moyenne, les templates sont approuvés en quelques heures à 24 heures pour les templates utility et authentication. Les templates marketing peuvent prendre jusqu'à 48 heures lors de la première soumission. Un template refusé puis resoumis après correction peut être approuvé plus rapidement si les corrections sont claires.

Peut-on utiliser des emojis et du markdown dans les templates ?

Les emojis sont autorisés dans les templates WhatsApp. Le markdown est limité : le gras (*texte*) et l'italique (_texte_) fonctionnent dans le body. Les titres H1/H2 ne sont pas supportés. Les listes à puces ne sont pas du markdown standard WhatsApp — utilisez des tirets ou des emojis comme puces.

Que se passe-t-il si un template approuvé est utilisé pour du contenu non conforme à la catégorie ?

Meta peut rétrograder le template vers une catégorie plus restrictive (et plus chère) lors d'une révision. Dans les cas graves, Meta peut suspendre le template ou émettre un avertissement sur le compte. Les plateformes de chatbot doivent s'assurer que le contenu dynamique injecté dans les variables reste cohérent avec la catégorie approuvée.

---

Les templates sont le point d'entrée de toute conversation WhatsApp initiée par une entreprise. Pour un chatbot IA, bien les concevoir et bien les gérer, c'est garantir que les conversations démarrent du bon pied. Whakup gère la soumission, le suivi et la synchronisation des templates pour les plateformes partenaires. Contactez notre équipe pour intégrer notre API.