API WhatsApp et les templates : guide pour les outils de marketing automation

Un template WhatsApp (ou HSM, Highly Structured Message) est le seul format de message qu'une plateforme peut envoyer en dehors d'une fenêtre de conversation ouverte par le contact. Dans un outil de marketing automation, tous les messages initiés par la plateforme — campagnes de nurturing, relances, notifications automatiques — doivent utiliser des templates préalablement approuvés par Meta. Sans template, pas d'envoi. Comprendre leur structure, leurs catégories et leur processus de validation est donc un prérequis technique fondamental pour tout éditeur d'outil d'automation.

La structure d'un template WhatsApp

Un template est composé de plusieurs sections, toutes optionnelles sauf le corps :

Header (en-tête) :

• Texte statique ou variable (ex. : nom du contact)
• Image, vidéo ou document
• Localisation

Body (corps) : obligatoire. Texte jusqu'à 1024 caractères, avec des variables dynamiques au format {{1}}, {{2}}, etc. Ces variables sont remplies au moment de l'envoi.

Footer (pied de page) : texte court, souvent utilisé pour les mentions légales ou le nom de l'enseigne.

Buttons : jusqu'à 3 boutons par template :

• Call-to-action : appel téléphonique ou ouverture d'URL.
• Quick reply : réponse rapide prédéfinie (ex. : "Oui", "Non", "En savoir plus").
• Copy Code : copie d'un code promo ou OTP dans le presse-papier.

La combinaison header + body + footer + buttons constitue le "contenu" soumis à validation Meta. Une fois approuvé, ce contenu ne peut plus être modifié — vous devez soumettre un nouveau template.

Les catégories de templates et leur impact sur la facturation

Meta classe chaque template dans une catégorie au moment de sa création. Cette catégorie détermine le tarif de la conversation qu'il ouvre.

Catégorie	Usage	Tarif Meta (FR)	Critères Meta
Marketing	Promotions, offres, campagnes	0,0712 €/conv.	Tout message visant à générer une vente ou un engagement
Utility	Confirmations, alertes, rappels	0,0248 €/conv.	Messages transactionnels attendus par le contact
Authentication	OTP, codes de vérification	0,0248 €/conv.	Format strict, uniquement pour les codes

L'enjeu pour un outil d'automation : classer correctement ses templates dès la création. Un template utility mal rédigé (avec une formulation trop commerciale) sera reclassé en marketing par Meta lors de la validation — et facturé 3 fois plus cher.

Pour aller plus loin sur les règles de validation par catégorie, consultez notre guide détaillé sur les templates WhatsApp et leurs catégories.

Gérer le cycle de vie des templates dans un outil d'automation

Dans un outil de marketing automation, les templates ne sont pas statiques. Ils sont créés, modifiés, approuvés, parfois rejetés ou mis en pause. Votre outil doit gérer ce cycle de vie de façon transparente pour les utilisateurs.

États d'un template :

• PENDING : soumis, en attente de validation Meta (généralement 1 à 5 jours ouvrés).
• APPROVED : utilisable pour l'envoi.
• REJECTED : refusé par Meta, avec un motif. Modifiable et re-soumis.
• PAUSED : Meta a détecté des signaux négatifs (taux de blocage élevé). Envoi suspendu automatiquement.
• DISABLED : suspendu de façon permanente par Meta.

Ce que votre outil doit implémenter :

• Notification automatique au marketeur quand un template passe de PENDING à APPROVED ou REJECTED.
• Blocage des séquences d'automation qui utilisent un template PAUSED ou DISABLED.
• Interface de re-soumission avec les motifs de rejet de Meta.

Les changements d'état des templates arrivent via webhook (template_status_update). Votre système doit écouter ces événements et mettre à jour l'état en base en temps réel.

Pour l'implémentation complète des webhooks qui signalent ces changements, consultez notre article sur les webhooks WhatsApp API.

Bonnes pratiques pour des templates qui passent la validation Meta

Meta publie des règles précises sur ce qui est accepté et refusé. Voici les erreurs les plus fréquentes et comment les éviter :

Formulations à éviter (pour les templates utility) :

• "Profitez de notre offre" → trop commercial, reclassé en marketing.
• "Ne manquez pas notre promotion" → idem.
• Utilisation excessive de majuscules, emojis répétitifs → rejet pour spam.

Bonnes pratiques générales :

• Clarté dès la première ligne. Meta lit le début du body pour évaluer la catégorie.
• Mentionner le nom de l'enseigne soit dans le header, soit dans le body.
• Variables pertinentes. Chaque variable {{n}} doit avoir un exemple fourni lors de la soumission. Les exemples doivent être réalistes (pas de "XXXXX").
• Boutons avec URL statique ou dynamique. Si l'URL contient une variable (ex. : un lien de suivi personnalisé), elle doit être déclarée comme variable dynamique avec un exemple.

Pour les templates authentication :

Meta impose un format très strict. Le body doit contenir la phrase : "{{1}} est votre code de vérification." Le code ne peut pas être mis en forme différemment. Tout écart entraîne un rejet automatique.

Intégration des templates dans les séquences d'automation

Dans un workflow d'automation, un template est un nœud d'envoi. Sa sélection doit être dynamique : selon le contexte du contact (langue, étape du parcours, segment), votre outil sélectionne le bon template et injecte les bonnes variables.

Pattern recommandé pour un multivariant :

Créez plusieurs versions d'un même template (ex. : version A avec un ton direct, version B avec un ton plus conversationnel). Votre outil d'automation fait une rotation aléatoire au moment de l'envoi pour tester les performances.

Gestion des variables dynamiques :

Les variables sont passées au moment de l'appel API. Un template avec {{1}} dans le body nécessite de fournir la valeur de {{1}} dans chaque requête d'envoi. Votre mapping de données doit être fiable — un envoi avec une variable vide génère un message malformé rejeté par Meta.

Whakup expose une API REST qui abstrait la création et l'envoi de templates. En tant que Meta Tech Provider certifié, Whakup gère la liaison avec l'API Graph de Meta : vous soumettez vos templates via l'API Whakup, sans avoir à intégrer directement l'API Meta Graph de votre côté.

Tarification : 0,0088 €/message Whakup + frais Meta par conversation selon la catégorie. Pour un template marketing vers un numéro français : environ 0,08 €/conversation ; pour un template utility : environ 0,0336 €/conversation.

Découvrez comment intégrer les templates dans vos séquences d'automation via la page API WhatsApp de Whakup.

FAQ

Combien de temps prend la validation d'un template par Meta ?

En général entre 24 et 72 heures, parfois jusqu'à 5 jours ouvrés en période de forte charge. Pour un outil d'automation, anticipez ce délai dans votre workflow de création de campagnes : ne laissez pas les marketeurs soumettre un template la veille d'un envoi planifié.

Peut-on modifier un template approuvé ?

Non. Un template approuvé ne peut pas être modifié. Si vous avez besoin d'une variation, vous devez créer un nouveau template avec un nom différent et le soumettre à validation. L'ancien template reste disponible pour les envois en cours.

Un template rejeté peut-il être re-soumis ?

Oui, après modification. Meta fournit un motif de rejet (ex. : "contenu trop commercial pour catégorie utility", "variable manquante"). Corrigez le problème et re-soumettez avec un nom de template différent — Meta ne permet pas de re-soumettre exactement le même template avec le même nom.

Peut-on utiliser des emojis dans les templates ?

Oui, Meta supporte les emojis dans les templates. Mais une utilisation excessive (plus de 2-3 emojis dans un même message) augmente le risque de signalement comme spam et peut dégrader le quality rating. Utilisez-les avec parcimonie, surtout dans les templates marketing.