Créer un Template HSM WhatsApp Approuvé par Meta : Guide Étape par Étape

Les templates HSM (Highly Structured Messages) sont le format de message obligatoire pour initier une conversation avec un client sur WhatsApp API. Toute campagne, toute notification, tout message outbound passe par un template validé par Meta. Comprendre comment en créer de bons — et les faire approuver du premier coup — est une compétence clé pour tout professionnel du WhatsApp Marketing.

Qu'est-ce qu'un Template HSM et Pourquoi est-il Obligatoire ?

Un template HSM est un format de message pré-approuvé par Meta que vous devez utiliser pour initier une conversation avec un utilisateur WhatsApp. Contrairement aux messages libres (possibles pendant une fenêtre de service de 24h), les templates sont soumis à modération avant utilisation.

Cette règle existe pour plusieurs raisons : protéger les utilisateurs du spam, garantir que les entreprises ne diffusent pas de contenu inapproprié, et maintenir la qualité de l'écosystème WhatsApp. Meta modère chaque template manuellement ou via IA avant de l'approuver.

Un template approuvé peut ensuite être utilisé autant de fois que voulu (dans le respect des limites de messagerie) sans nouvelle modération, sauf si vous le modifiez.

Les 3 catégories de templates :

• Marketing : promotions, offres, newsletters, campagnes d'acquisition
• Utility : notifications transactionnelles, confirmations, rappels
• Authentication : OTP, codes de vérification, liens de connexion

Chaque catégorie a des règles légèrement différentes et un tarif Meta distinct.

Anatomie d'un Template HSM Parfait

Un template est composé de plusieurs éléments optionnels ou obligatoires :

Header (optionnel) Peut être du texte (60 caractères max), une image, un document, ou une vidéo. Le header est visible en premier et capte l'attention. Pour les templates marketing, une image pertinente améliore le taux de lecture.

Body (obligatoire) Le corps du message. C'est ici que vous écrivez votre message principal. Maximum 1024 caractères. Peut contenir des variables dynamiques {{1}}, {{2}}, etc. pour la personnalisation.

Footer (optionnel) Texte court en gris en bas du message. Souvent utilisé pour les mentions légales courtes ou les instructions de désinscription. Maximum 60 caractères.

Buttons (optionnel) Jusqu'à 3 boutons d'action :

• Quick Reply : bouton de réponse rapide (texte renvoyé à votre webhook)
• Call to Action URL : ouvre un lien URL
• Call to Action Phone : initie un appel téléphonique

Créer un Template via l'API Meta

Voici la structure JSON complète pour créer un template marketing avec image et boutons :

curl -X POST \
  "https://graph.facebook.com/v19.0/YOUR_WABA_ID/message_templates" \
  -H "Authorization: Bearer YOUR_SYSTEM_USER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "promo_soldes_ete_2026",
    "category": "MARKETING",
    "language": "fr",
    "components": [
      {
        "type": "HEADER",
        "format": "IMAGE",
        "example": {
          "header_handle": ["https://example.com/image-soldes.jpg"]
        }
      },
      {
        "type": "BODY",
        "text": "Bonjour {{1}} ! 🎉\n\nNos soldes d'\''été commencent maintenant ! Profitez de -{{2}}% sur toute notre collection avec le code **{{3}}**.\n\nValable jusqu'\''au {{4}}.",
        "example": {
          "body_text": [["Aminata", "30", "ETE2026", "31 août 2026"]]
        }
      },
      {
        "type": "FOOTER",
        "text": "Répondez STOP pour vous désabonner"
      },
      {
        "type": "BUTTONS",
        "buttons": [
          {
            "type": "URL",
            "text": "Voir les offres",
            "url": "https://boutique.exemple.com/soldes?ref=wa"
          },
          {
            "type": "QUICK_REPLY",
            "text": "En savoir plus"
          }
        ]
      }
    ]
  }'

Points critiques dans ce JSON :

• Le champ example dans BODY est obligatoire si vous utilisez des variables. Fournissez des exemples réalistes — Meta vérifie que les variables sont utilisées de façon cohérente.
• Le champ example dans HEADER (pour IMAGE/VIDEO) doit fournir une URL d'exemple. Cette URL n'est pas stockée mais sert à la modération.
• Les sauts de ligne utilisent \n dans le JSON.

Les 10 Règles de Contenu que Meta Applique

1. Pas de promesses trompeuses ou exagérées "Gagnez 1 million FCFA garantis" → Refusé. "Économisez jusqu'à 50%" → Accepté.

2. Les variables doivent être utilisées de façon cohérente Une variable {{1}} qui est un prénom dans l'exemple doit être un prénom dans toutes vos utilisations réelles. Meta vérifie la cohérence.

3. Pas de liens raccourcis (bit.ly, tinyurl) Utilisez des URLs complètes et transparentes. Les liens raccourcis sont souvent refusés car ils masquent la destination.

4. Les templates authentication doivent explicitement mentionner l'OTP "Votre code de vérification est {{1}}" → Correct. Un code numérique seul sans contexte → Refusé.

5. Les templates marketing doivent clairement identifier l'expéditeur La marque ou l'entreprise doit être identifiable dans le message ou le Display Name.

6. Pas de contenu adulte, politique, ou contrevenant aux lois Cette règle est universelle et non négociable.

7. Les boutons CTA doivent correspondre au contenu du message Un bouton "Acheter maintenant" dans un template de notification de livraison sera refusé — le CTA doit être cohérent avec l'objet du message.

8. Longueur et formatage Le texte ne doit pas être excessivement capitalisé ou surchargé de ponctuation répétée.

9. Paramètres exemples obligatoires pour les variables Si votre template contient des variables, l'exemple doit être renseigné. Un template avec {{1}} mais sans exemple dans le JSON sera rejeté.

10. Cohérence entre catégorie et contenu Un template de promotion déguisé en template Utility (pour bénéficier d'un tarif plus bas) est détecté et refusé.

Pour maximiser votre taux d'approbation, consultez notre article sur les facteurs clés d'approbation des templates et les causes de refus et corrections. Pour le contexte général des templates, lisez Templates de messages WhatsApp.

FAQ — Créer un Template HSM WhatsApp

Combien de temps prend l'approbation d'un template ? En moyenne 24 à 48 heures pour les templates en langues courantes (français, anglais). Pour les langues moins communes ou les templates avec du contenu sensible (finance, santé), comptez jusqu'à 72 heures. Soumettez vos templates au moins 3 jours avant votre date de campagne prévue.

Peut-on modifier un template déjà approuvé ? Oui, mais la modification remet le template en statut PENDING et déclenche un nouveau cycle de modération. Toutes les campagnes utilisant ce template sont suspendues pendant la révision. Pour les modifications urgentes, créez plutôt un nouveau template avec un nom différent.

Combien de templates peut-on créer par WABA ? La limite par défaut est de 250 templates par WABA. Cette limite peut être augmentée sur demande auprès de Meta si votre activité justifie un catalogue plus large. En pratique, la plupart des entreprises n'ont besoin que de 20 à 50 templates actifs simultanément.

Un template refusé peut-il être re-soumis immédiatement ? Oui, sans délai de carence. Après un refus, corrigez le problème spécifique mentionné dans la notification de refus et soumettez à nouveau. Cependant, soumettre le même template identique à l'identique après un refus n'a aucune chance de succès — apportez toujours une modification substantielle.

---

Prêt à créer vos premiers templates HSM ? Créez votre compte Whakup et utilisez notre éditeur de templates visuel qui vous guide dans la création de messages conformes aux règles Meta, avec prévisualisation en temps réel.