API WhatsApp et les templates : guide pour les logiciels RH

Un template WhatsApp (aussi appelé HSM, Highly Structured Message) est un modèle de message pré-approuvé par Meta que vous devez utiliser pour toute conversation initiée par votre logiciel. Contrairement aux emails ou aux SMS, vous ne pouvez pas envoyer un message WhatsApp libre à un utilisateur qui ne vous a pas écrit en premier : il faut passer par un template validé. Pour un logiciel RH, cette contrainte est en réalité une opportunité : des templates bien conçus garantissent une communication professionnelle, cohérente et conforme pour toutes vos communications recrutement et gestion des collaborateurs.

Les catégories de templates RH et leurs règles

Meta classe les templates en trois catégories. Le choix de la catégorie détermine le tarif Meta et les règles de contenu applicables.

UTILITY (messages transactionnels) C'est la catégorie naturelle pour la majorité des communications RH. Elle couvre tout ce qui est lié à une action préalable de l'utilisateur ou à une étape d'un processus engagé :

• Confirmation de candidature reçue.
• Convocation à un entretien (suite à une candidature).
• Rappel de formation inscrite.
• Notification de bulletin de paie disponible.
• Mise à jour du statut d'une demande RH (congés, notes de frais).

Tarif Meta pour la France : 0,0248 €/conversation — soit environ 0,0336 € tout compris avec Whakup.

MARKETING (communications promotionnelles ou non sollicitées) Cette catégorie s'applique si vous contactez un candidat ou collaborateur sans qu'il n'ait initié d'action récente :

• Campagne de recrutement proactive (sourcing).
• Annonce d'un événement emploi ou forum interne.
• Newsletter RH ou communication corporate non transactionnelle.

Tarif Meta pour la France : 0,0712 €/conversation — environ 0,08 € tout compris.

AUTHENTICATION Envoi de codes OTP pour la vérification d'identité. Utilisé si votre logiciel RH intègre une authentification ou une signature électronique par WhatsApp.

Catégorie	Cas d'usage RH typique	Tarif Meta (FR)
UTILITY	Convocation entretien, rappel formation	0,0248 €/conv
MARKETING	Sourcing proactif, événement emploi	0,0712 €/conv
AUTHENTICATION	Vérification identité, OTP connexion	0,0248 €/conv

Anatomie d'un template RH bien structuré

Un template se compose de plusieurs sections :

Header (optionnel) : texte, image, document ou vidéo. Pour une convocation d'entretien, un document PDF de confirmation en header est apprécié.

Body (obligatoire) : le texte principal du message. Vous pouvez intégrer des variables dynamiques au format {{1}}, {{2}}... qui seront remplacées lors de l'envoi (nom du candidat, poste, date, heure, lieu).

Footer (optionnel) : texte court en bas du message. Idéal pour mentionner le nom de votre entreprise ou l'instruction de désinscription.

Boutons (optionnel) : jusqu'à 3 boutons de type "réponse rapide" (texte libre prédéfini) ou "call-to-action" (lien URL ou numéro de téléphone).

Exemple de template utility pour une convocation d'entretien :

Bonjour {{1}},

Votre entretien pour le poste de {{2}} est confirmé :
- Date : {{3}}
- Heure : {{4}}
- Lieu : {{5}}

[Confirmer ma présence] [Demander un report]

Les variables {{1}} à {{5}} sont renseignées dynamiquement par votre logiciel au moment de l'envoi via l'API.

Processus de soumission et validation Meta

Avant d'utiliser un template, vous devez le soumettre à Meta pour approbation. La validation prend généralement quelques heures à quelques jours. Meta peut rejeter un template pour plusieurs raisons :

• Contenu ambigu : le message ne correspond pas à la catégorie déclarée.
• Variables mal utilisées : les variables ne peuvent pas constituer la majorité du contenu, ni être placées dans des endroits qui pourraient être mal interprétés.
• Contenu interdit : alcool, jeux d'argent, contenu politique, médicaments sans prescription.
• Mauvaise catégorie : un template marketing soumis en utility sera rejeté ou recatégorisé.

Bonnes pratiques pour un taux d'approbation élevé :

• Rédigez des templates clairs avec une utilité évidente.
• Déclarez la bonne catégorie dès la soumission.
• Testez avec un petit lot avant de lancer un template sur toute votre base.
• Prévoyez une version de backup si Meta recatégorise votre template (impact tarif).

Consultez notre guide détaillé sur les règles des templates WhatsApp marketing pour éviter les pièges courants lors de la soumission.

Gestion des templates dans un logiciel RH multi-clients

Si votre logiciel RH est utilisé par plusieurs entreprises (modèle SaaS), chaque client possède son propre WABA et ses propres templates. Les templates ne sont pas transférables entre comptes. Vous devez donc :

• Permettre à chaque client de soumettre et gérer ses templates depuis votre interface.
• Stocker les template_name et les language_code par compte pour construire correctement les appels API.
• Monitorer les statuts de templates via webhooks (message_template_status_update) pour détecter les rejets ou suspensions automatiquement.

Whakup propose une API de gestion des templates qui vous permet de créer, lister et supprimer des templates par compte depuis votre backend, sans que vos clients aient à accéder au Meta Business Manager. Pour comprendre l'ensemble de l'architecture multi-tenant, consultez le guide complet de l'API WhatsApp Business.

Sur la question de construire cette couche vous-même versus passer par un provider, l'article build vs buy API WhatsApp détaille les critères pour les éditeurs de logiciels.

FAQ

Peut-on modifier un template après approbation ?

Oui, mais la modification nécessite une nouvelle soumission à Meta et une nouvelle validation. Pendant le processus, l'ancienne version reste active. Si vous modifiez le body ou les boutons, le template repasse en statut PENDING jusqu'à la validation. Planifiez les mises à jour en dehors des périodes de campagne.

Combien de templates peut-on créer par compte WhatsApp Business ?

Meta ne publie pas de limite fixe officielle, mais en pratique les comptes peuvent en créer plusieurs centaines. Pour un logiciel RH avec des dizaines de cas d'usage différents (onboarding, paie, formation, recrutement), prévoyez un catalogue structuré et nommez vos templates de façon claire (rh_convocation_entretien_fr, rh_rappel_formation_fr...).

Les templates exppirent-ils si on ne les utilise pas ?

Meta peut désactiver des templates peu utilisés dans certaines conditions. Surveillez régulièrement les statuts de vos templates via l'API et réactivez ceux qui ont été désactivés si vous en avez encore besoin.

Peut-on utiliser le même template dans plusieurs langues ?

Oui. Un template peut être soumis en plusieurs langues (fr, en, es...) sous le même nom. Chaque langue est validée indépendamment. Lors de l'envoi, vous spécifiez le language_code dans l'appel API pour envoyer dans la bonne langue selon le profil du destinataire.

---

Les templates WhatsApp sont le point d'entrée de toute communication RH initiée par votre logiciel. Bien structurés et bien catégorisés, ils maximisent les taux de livraison, minimisent les coûts et accélèrent les processus RH. Whakup fournit l'API de gestion des templates, la documentation complète et l'hébergement EU/RGPD pour intégrer WhatsApp nativement dans votre SIRH. Accédez à l'API WhatsApp Whakup et commencez à construire vos premiers templates RH.