Templates WhatsApp : soumission, approbation Meta et suivi du statut

Un template WhatsApp est un modèle de message que Meta doit approuver avant que vous puissiez l'envoyer à un client hors de la fenêtre de service de 24 heures. Le cycle est le même chez tous les fournisseurs : vous créez le template (nom, langue, catégorie, contenu), vous le soumettez à Meta, il passe « en revue », puis Meta l'approuve ou le refuse, souvent en quelques minutes. Le statut se suit dans l'interface du fournisseur, par interrogation de son API, ou par webhook chez Meta ; un template approuvé peut encore être mis en pause ou désactivé plus tard si sa qualité se dégrade.

Ce guide détaille chaque étape, les statuts, les causes de refus les plus fréquentes et la façon de suivre le statut par API.

Qu'est-ce qu'un template WhatsApp ?

Un template (ou « modèle de message ») est composé de :

un nom technique, en minuscules, chiffres et underscores (par exemple confirmation_commande) ;
une langue (par exemple fr, en_US) ; un même nom peut exister en plusieurs langues ;
une catégorie : marketing, utilitaire ou authentification ;
un en-tête optionnel : texte, image, vidéo, document ou localisation ;
un corps avec des variables numérotées ({{1}}, {{2}}), jusqu'à 1 024 caractères ;
un pied de page optionnel, jusqu'à 60 caractères ;
des boutons optionnels : réponse rapide, lien, appel, copier le code.

La catégorie détermine le tarif facturé par Meta et les règles applicables. Elle doit refléter le contenu réel du message.

Les catégories et leurs règles

Catégorie	Usage	Exemples	Point de vigilance
Marketing	Promotion, information commerciale, relance	Soldes, nouveau produit, panier abandonné	Tarif le plus élevé ; plafonds Meta sur les messages marketing par utilisateur
Utilitaire	Suite d'une action ou d'une transaction du client	Confirmation de commande, rappel de rendez-vous, suivi de livraison	Ne doit contenir aucune offre ; sinon refus ou reclassement en marketing
Authentification	Code à usage unique	Code de connexion, vérification de numéro	Texte imposé par Meta, ni lien ni média

Meta peut reclasser un template dont la catégorie ne correspond pas au contenu, typiquement un utilitaire qui glisse une promotion. Pour les codes de vérification, voir notre guide Vérification OTP par WhatsApp.

Les statuts d'un template

Chez Meta, les principaux statuts sont :

PENDING : en revue ;
APPROVED : approuvé, utilisable ;
REJECTED : refusé, avec un motif ;
PAUSED : mis en pause temporairement par Meta à cause de retours négatifs des destinataires ;
DISABLED : désactivé après des pauses répétées ou une qualité trop basse.

Les fournisseurs ajoutent généralement un statut brouillon (draft) pour les templates créés mais pas encore soumis. Chez Whakup, les statuts exposés sont draft (brouillon), pending (en revue), approved (approuvé) et rejected (refusé).

Le délai de revue est souvent de quelques minutes. Il peut être plus long, notamment pour un premier template ou un contenu ambigu. Prévoyez une marge avant une campagne datée.

Soumettre un template : étape par étape

Choisir la catégorie en fonction du contenu, pas du tarif.
Nommer le template de façon explicite : rappel_rdv_j1, relance_panier_24h.
Rédiger le corps : clair, court, avec un nombre raisonnable de variables.
Fournir des exemples pour chaque variable (« Jean », « C-10482 »). Sans exemples, la revue est plus difficile et le refus plus probable.
Ajouter les boutons utiles, pas plus.
Soumettre et suivre le statut.
En cas de refus, lire le motif, corriger et soumettre de nouveau (ou créer une nouvelle version).

Les causes de refus les plus fréquentes

Catégorie incorrecte : contenu promotionnel déclaré en utilitaire.
Variable au tout début ou à la toute fin du corps : Meta préfère qu'une variable soit entourée de texte.
Variables collées ({{1}}{{2}}) ou numérotation non séquentielle.
Exemples manquants ou peu réalistes.
Trop de variables pour trop peu de texte : le message ressemble à un modèle vide.
Contenu interdit par les politiques commerciales de Meta (certains produits réglementés, contenus trompeurs).
Lien raccourci ou suspect dans un bouton.
Doublon d'un template existant avec le même contenu.
Fautes, formatage abusif (majuscules, ponctuation répétée).

Chez Whakup, les erreurs renvoyées par Meta sont traduites en clair dans l'interface, et l'API renvoie un code 422 à la soumission si le template n'est pas conforme aux règles Meta.

Suivre le statut d'un template par API

Le principe général

Deux approches existent chez la plupart des fournisseurs, y compris pour les API de communication programmable les plus connues :

l'interrogation (polling) : vous appelez régulièrement un endpoint qui renvoie le statut ;
la notification : la plateforme vous envoie un webhook quand le statut change. Chez Meta, l'événement s'appelle message_template_status_update.

Chez les fournisseurs orientés développeurs, la logique est la même : on crée le contenu du template, on soumet une demande d'approbation à WhatsApp, puis on consulte le statut de cette demande par API ou dans la console. Les noms d'endpoints diffèrent, le cycle reste identique.

Avec l'API Whakup

L'API REST de Whakup (offre Business) couvre le cycle complet :

Créer le template (il reste en draft) :

curl -X POST https://api.whakup.com/v1/templates \
  -H "Authorization: Bearer wk_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "confirmation_commande",
    "language": "fr",
    "category": "utility",
    "body": "Bonjour {{1}}, votre commande {{2}} est confirmée.",
    "samples": { "1": "Jean", "2": "C-10482" }
  }'

Le soumettre à Meta (il passe en pending) :

curl -X POST https://api.whakup.com/v1/templates/ID_DU_TEMPLATE/submit \
  -H "Authorization: Bearer wk_votre_cle"

Suivre le statut en filtrant la liste :

curl "https://api.whakup.com/v1/templates?status=pending" \
  -H "Authorization: Bearer wk_votre_cle"

Le filtre status accepte draft, pending, approved et rejected. Une boucle qui interroge les templates pending toutes les quelques minutes suffit dans la plupart des cas ; les webhooks Whakup ne transmettent pas, à ce jour, de changement de statut de template.

Erreurs à prévoir : 409 si le nom existe déjà dans la langue, 409 no_channel_connected si aucun numéro WhatsApp n'est connecté, 422 si le template n'est pas conforme, 502 en cas de refus de Meta lors de la soumission.

Envoyer le template une fois approuvé

Point important : chez Whakup, l'API ne permet pas d'envoyer un template en un appel direct ; POST /v1/messages envoie des messages texte. Un template approuvé s'envoie :

par une campagne, à un ou plusieurs groupes, avec les variables reliées aux champs des contacts ;
par une automatisation, par exemple déclenchée par l'ajout d'un contact à un groupe, que vous pouvez faire via l'API (POST /v1/contacts avec groups, ou POST /v1/groups/{groupe}/contacts).

Après l'approbation : la qualité du template

Un template approuvé n'est pas acquis. Meta suit sa qualité à partir des réactions des destinataires (blocages, signalements, désintérêt). Si elle se dégrade :

la note du template baisse ;
Meta peut le mettre en pause temporairement ;
en cas de pauses répétées, il peut être désactivé.

Une baisse de qualité peut aussi affecter la note du numéro. Chez Whakup, une campagne se met en pause automatiquement si un template passe en qualité basse, ce qui évite de continuer à envoyer un message que les destinataires rejettent. Voir la page délivrabilité.

Bonnes pratiques

Un template par intention : ne mélangez pas confirmation et promotion.
Préparez vos templates en avance pour les temps forts commerciaux (fêtes, soldes, Ramadan, Tabaski).
Testez sur un petit groupe avant un envoi massif.
Nommez et versionnez : promo_rentree_v2 plutôt que de modifier un template qui a déjà un historique.
Surveillez les causes d'échec après chaque envoi.

FAQ

Combien de temps prend l'approbation d'un template WhatsApp ?

Souvent quelques minutes, parfois plusieurs heures. Le délai dépend du contenu et de l'historique du compte. Prévoyez une marge avant une campagne datée.

Comment suivre le statut d'approbation d'un template par API ?

En interrogeant l'endpoint de liste des templates avec un filtre de statut (chez Whakup : GET /v1/templates?status=pending), ou par webhook quand la plateforme en propose un. Chez Meta en direct, l'événement message_template_status_update notifie les changements.

Pourquoi mon template utilitaire a-t-il été refusé ou reclassé en marketing ?

Le plus souvent parce qu'il contient un élément promotionnel : réduction, suggestion d'achat, lien vers une offre. Un utilitaire doit se limiter à une information liée à une action ou une transaction du client.

Peut-on modifier un template approuvé ?

Une modification repasse par la revue de Meta, avec des restrictions selon les cas. Il est souvent plus simple de créer une nouvelle version sous un nouveau nom.

Peut-on envoyer un template par l'API Whakup ?

Pas en un appel direct. L'API crée, soumet et liste les templates, et envoie des messages texte. L'envoi d'un template passe par une campagne ou une automatisation, que l'API peut déclencher en ajoutant un contact à un groupe.

Créer vos premiers templates

Dans Whakup, vous suivez le statut de chaque template (brouillon, en revue, approuvé, refusé) et les erreurs de Meta sont expliquées en clair. Créez votre compte : essai gratuit de 15 jours, sans carte bancaire. Pour l'intégration par API, consultez la documentation développeur.