API WhatsApp et les templates : guide pour les intégrateurs

Les templates WhatsApp (appelés HSM — Highly Structured Messages) sont les seuls formats autorisés pour initier une conversation hors de la fenêtre de service de 24 heures. Contrairement à une API de messagerie classique, vous ne pouvez pas envoyer un message texte libre à un contact qui ne vous a pas récemment contacté : il faut obligatoirement un template approuvé par Meta. Pour un intégrateur qui construit une plateforme WhatsApp, la gestion du cycle de vie des templates est un sujet central — à la fois pour l'expérience client et pour la fiabilité de l'envoi.

Anatomie d'un template WhatsApp

Un template WhatsApp est composé de plusieurs éléments, dont certains sont obligatoires et d'autres optionnels :

Composant	Obligatoire	Description
Nom	Oui	Identifiant unique en minuscules (snake_case)
Catégorie	Oui	marketing, utility, ou authentication
Langue	Oui	Code BCP-47 (fr, en_US, ar, etc.)
Header	Non	Texte, image, vidéo, ou document
Body	Oui	Texte avec variables {{1}}, {{2}}...
Footer	Non	Texte statique
Buttons	Non	Call-to-action (URL, téléphone) ou Quick Reply

Le body peut contenir jusqu'à 1 024 caractères et jusqu'à 10 variables de personnalisation. Les variables sont indexées {{1}}, {{2}}, etc. et doivent être renseignées dans le bon ordre lors de l'envoi.

Règle critique : le contenu du template soumis à Meta doit correspondre exactement au contenu qui sera envoyé — les variables doivent avoir des valeurs d'exemple lors de la soumission pour que Meta puisse évaluer le contenu.

Cycle de vie d'un template : de la création à l'envoi

Création via API → Soumission à Meta → Révision Meta (quelques minutes à 24h)
      → APPROVED / REJECTED → Envoi possible / Correction requise

Création via l'API : un POST vers /v17.0/{waba-id}/message_templates avec le JSON de définition du template. La réponse contient l'identifiant du template et son statut initial (PENDING).

Délai de validation : Meta annonce un délai de quelques minutes pour les templates sans contenu marketing sensible. En pratique, comptez de 5 minutes à 24 heures selon la complexité du contenu et la charge des systèmes Meta. Les templates authentication sont généralement approuvés plus rapidement.

Rejet : Meta rejette les templates qui violent ses règles (contenu trompeur, appel à l'action interdit, format non conforme). En cas de rejet, le motif est fourni dans le webhook message_template_status_update. Vous devez corriger et resoumettre — un nouveau template avec le même nom dans la même langue nécessite de supprimer d'abord le template rejeté.

Gestion multi-tenant des templates : architecture à choisir

Pour une plateforme SaaS multi-clients, deux architectures sont possibles :

Architecture 1 : Templates centralisés (un seul WABA "master")

Tous les clients utilisent les mêmes templates définis sur votre WABA principal. Vous personnalisez via les variables.

• Avantage : un seul set de templates à gérer et à faire valider
• Inconvénient : vos clients ne peuvent pas créer leurs propres templates, pas de branding personnalisé dans le nom ou la structure du template
• Adapté pour : les plateformes avec des use cases standardisés (OTP, confirmations)

Architecture 2 : Templates par WABA client (multi-tenant isolé)

Chaque client a son propre WABA avec ses propres templates.

• Avantage : chaque client maîtrise ses templates, isolation complète
• Inconvénient : votre plateforme doit exposer une interface de création/gestion de templates et gérer les statuts de validation pour chaque WABA
• Adapté pour : les plateformes marketing où les clients personnalisent leurs campagnes

Whakup supporte les deux architectures via son API WhatsApp. L'API de gestion des templates est exposée par WABA, avec des webhooks de statut pour notifier votre plateforme des approbations et rejets.

Bonnes pratiques pour maximiser le taux d'approbation

D'après les règles documentées de Meta et les retours d'expérience terrain :

• Nommez les templates clairement : order_confirmation_fr est plus susceptible d'être approuvé sans friction que msg_001_v3
• Fournissez des exemples réalistes pour chaque variable. "John Doe" pour un prénom, "12345" pour une commande. Les exemples génériques ou absurdes ralentissent la validation.
• Évitez les CTA trop agressifs dans les templates marketing : "ACHETEZ MAINTENANT" en majuscules peut déclencher un rejet. "Découvrez nos offres" passe mieux.
• Respectez la catégorie déclarée : un template classé "utility" qui contient une promotion sera rejeté ou recatégorisé automatiquement en "marketing" avec facturation plus élevée.
• Testez dans un WABA de sandbox avant de soumettre en production.

Pour les règles de catégorisation détaillées, consultez notre article sur les catégories de templates WhatsApp et notre guide complet de l'API WhatsApp Business.

FAQ

Peut-on modifier un template déjà approuvé ?

Oui, partiellement. Meta autorise la modification du corps (body) d'un template approuvé via un PATCH sur l'API. Cependant, la modification relance le processus de validation. Le template redevient PENDING pendant la durée de révision — il ne peut pas être utilisé pour envoyer pendant ce délai.

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

Meta ne publie pas de limite officielle sur le nombre de templates par WABA. En pratique, des centaines de templates par WABA sont courants sans problème. La limite technique est davantage sur le nombre de soumissions simultanées que Meta peut traiter.

Les templates ont-ils une durée de validité ?

Les templates approuvés restent valides indéfiniment. Ils peuvent être suspendus automatiquement par Meta si leur taux de blocage dépasse un seuil (lié au quality rating du numéro). Un template suspendu peut être réactivé une fois la qualité du numéro améliorée.

Comment savoir si un template a été approuvé ou rejeté dans mon intégration ?

Via le webhook message_template_status_update. L'événement contient l'identifiant du template, le nouveau statut (APPROVED, REJECTED, PENDING_DELETION), et en cas de rejet, le motif (rejected_reason). Branchez ce webhook dans votre plateforme pour notifier le bon client en temps réel.

---

La gestion des templates est souvent le premier point de friction dans une intégration WhatsApp. En vous appuyant sur Whakup — Meta Tech Provider certifié, API REST + webhooks, marque blanche — vous disposez d'une interface de gestion des templates par client et d'une API de soumission normalisée. Contactez-nous pour démarrer votre intégration ou consulter la documentation technique.