API WhatsApp et les templates : guide pour les plateformes SMS

Un template WhatsApp (officiellement appelé HSM pour Highly Structured Message) est un modèle de message pré-approuvé par Meta, obligatoire pour tout message initié par l'entreprise en dehors d'une fenêtre de conversation active. Pour une plateforme SMS qui ajoute WhatsApp à son portefeuille, les templates sont l'équivalent des messages MT (Mobile Terminated) avec une couche de validation éditoriale supplémentaire : Meta doit approuver chaque modèle avant son utilisation.

Structure d'un template WhatsApp

Un template se compose de plusieurs sections, toutes optionnelles sauf le body :

• Header : titre du message. Peut être du texte (60 caractères max), une image, un document PDF, une vidéo ou une localisation géographique.
• Body : corps du message (1 024 caractères max). C'est la section obligatoire. Les variables de personnalisation s'écrivent {{1}}, {{2}}, etc.
• Footer : texte de bas de page (60 caractères max), souvent utilisé pour le nom de la marque ou une mention légale.
• Buttons : jusqu'à 3 boutons d'action. Deux types : CTA (lien URL ou appel téléphonique) et Quick Reply (réponse prédéfinie cliquable).

Exemple de template "confirmation de commande" :

Header : [image du logo ou texte "Votre commande"]
Body : Bonjour {{1}}, votre commande #{{2}} a bien été confirmée. 
       Livraison prévue le {{3}}. Merci pour votre achat !
Footer : [Nom de la marque]
Buttons : [Suivre ma commande] → URL dynamique
          [Contacter le support] → Quick Reply

Les catégories de templates et leur impact tarifaire

Meta classe chaque template dans une catégorie lors de la soumission. Cette catégorie détermine le tarif de la conversation ouverte et les règles éditoriales applicables :

Catégorie	Usage typique	Restrictions éditoriales	Coût conv. FR
Marketing	Promos, newsletters, relances, upsell	Contenu commercial, opt-in requis	~0,08 €
Utility	Confirmations, alertes, statuts	Doit être lié à une action du contact	~0,0336 €
Authentication	OTP, codes de vérification	Format strict, expiration obligatoire	~0,0336 €

Le choix de catégorie n'est pas libre : Meta peut recatégoriser un template soumis en Marketing s'il juge que le contenu est promotionnel, même si vous l'avez soumis en Utility. Cette recatégorisation peut doubler le coût de la conversation. Il est donc crucial de rédiger les templates Utility de façon strictement transactionnelle, sans aucun élément promotionnel.

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

Processus d'approbation Meta : délais et rejets courants

La soumission d'un template se fait via l'API Graph (POST /{waba-id}/message_templates) ou depuis le Meta Business Manager. Meta évalue chaque template et retourne l'un des statuts suivants :

• APPROVED : le template peut être utilisé immédiatement.
• PENDING : en cours d'évaluation (en général moins de 24h, parfois quelques minutes).
• REJECTED : refusé. Un code de rejet et une raison sont fournis.

Les causes de rejet les plus fréquentes :

• Contenu qui enfreint les politiques commerciales WhatsApp (alcool, jeux d'argent, armes, etc.).
• Template marketing soumis en Utility (recatégorisation forcée ou rejet).
• Variables mal formatées ou contenu ambigu.
• Lien URL dans le body sans bouton dédié.
• Texte qui induit une urgence artificielle ("Offre valable seulement les 10 prochaines minutes").

Une fois rejeté, un template peut être modifié et resoumis. Mais un template rejeté plusieurs fois pour le même motif peut entraîner une restriction sur le WABA.

Gestion des templates dans une plateforme SMS multi-clients

Pour une plateforme SMS qui gère des dizaines de clients, chacun avec ses propres templates, l'architecture de gestion doit être robuste :

Bibliothèque de templates par client. Chaque client dispose de ses propres templates, attachés à son WABA. Deux clients différents ne partagent pas de templates. Votre plateforme doit exposer une interface de création, prévisualisation, soumission et suivi des templates par tenant.

Suivi du statut de validation. Le webhook template_status_update notifie les changements de statut en temps réel. Intégrez ces événements pour alerter le client dès qu'un template est approuvé ou rejeté, sans qu'il ait à surveiller le Business Manager.

Gestion des variables et de la personnalisation. Lors de l'envoi, chaque variable {{n}} du template doit être remplacée par une valeur. Votre moteur d'envoi doit valider que toutes les variables sont présentes et non vides avant de soumettre le message à l'API. Un message envoyé avec une variable manquante est rejeté par Meta avec une erreur 131009.

Versioning des templates. Un template approuvé peut être modifié, mais la modification repasse par validation. Si votre client veut tester une variante, il doit créer un nouveau template avec un nom différent. Encouragez une convention de nommage claire (confirmation_commande_v1, confirmation_commande_v2).

Pour aller plus loin sur les règles de rédaction des templates marketing, consultez notre article sur les templates WhatsApp marketing et les règles Meta.

FAQ

Combien de templates peut-on créer par WABA ?

Par défaut, un WABA peut contenir jusqu'à 250 templates approuvés. Ce plafond peut être augmenté sur demande auprès du BSP pour les comptes à fort volume. Les templates rejetés ou supprimés libèrent des slots.

Un template approuvé peut-il être désactivé par Meta après utilisation ?

Oui. Si un template génère un taux de signalement élevé (bouton "Signaler" des destinataires), Meta peut le désactiver automatiquement, même s'il était approuvé. C'est l'équivalent du quality rating appliqué au niveau du template. Le template passe alors en statut PAUSED ou DISABLED. Il faut le modifier pour réduire les signalements avant de pouvoir le ré-activer.

Les templates WhatsApp sont-ils différents des messages SMS en termes de rédaction ?

Oui, sur plusieurs points. Les templates WhatsApp supportent le rich media (images, documents, boutons), ne sont pas limités à 160 caractères, et sont évalués éditorialement par Meta. En contrepartie, ils ne peuvent pas être envoyés sans approbation préalable. La rédaction doit être plus soignée que pour le SMS.

Peut-on créer des templates en plusieurs langues ?

Oui. Chaque template est associé à une langue lors de la création. Il est possible de créer plusieurs variantes d'un même template dans des langues différentes — elles sont traitées comme des templates distincts dans l'API mais peuvent partager le même nom avec des codes langue différents. Utile pour les plateformes SMS qui envoient à des audiences internationales.

---

Les templates WhatsApp sont le point d'entrée de tout envoi initié par l'entreprise. Les maîtriser, c'est garantir des campagnes délivrées, correctement catégorisées et sans friction pour vos clients. Whakup fournit l'API REST, les webhooks de statut template et le support éditorial pour accélérer les validations. Découvrez l'ensemble de notre offre sur la page API WhatsApp Business et consultez notre guide complet API WhatsApp Business pour l'architecture complète.