Glossaire de l'API WhatsApp Business : 30 termes à connaître

L'API WhatsApp Business a son propre vocabulaire. WABA, HSM, BSP, WAMID, embedded signup, tier de messagerie… Ces termes reviennent dans chaque documentation, chaque échange avec un fournisseur, chaque ticket support. Ce glossaire les définit de façon précise, dans le contexte de l'intégration B2B.

Les entités et acteurs de l'écosystème

Meta — L'entreprise qui possède WhatsApp et définit les règles d'accès à l'API, les politiques de templates et les conditions d'utilisation. Toute infraction peut entraîner la suspension du numéro ou du compte.

BSP (Business Solution Provider) — Ancienne dénomination des partenaires autorisés par Meta à distribuer l'accès à l'API WhatsApp. Le terme évolue vers Meta Tech Provider pour les partenaires certifiés au niveau supérieur.

Meta Tech Provider — Partenaire certifié par Meta, habilité à gérer des sous-comptes (multi-tenant), à activer l'embedded signup et à accéder à des fonctionnalités avancées de l'API. Passer par un Meta Tech Provider évite à l'éditeur ou à l'agence de passer lui-même les certifications Meta. Voir notre article sur le rôle du Meta Tech Provider WhatsApp.

WABA (WhatsApp Business Account) — Le compte WhatsApp Business d'une entreprise, attaché à un ou plusieurs numéros. Chaque client final doit avoir son propre WABA pour envoyer des messages depuis l'API.

Meta Business Manager (MBM) — La console Meta qui héberge le WABA d'une entreprise. C'est ici que les admins gèrent les numéros, les templates et les partenaires.

Phone Number ID — Identifiant unique d'un numéro WhatsApp dans l'API. À ne pas confondre avec le numéro de téléphone lui-même. Utilisé dans les appels API pour spécifier depuis quel numéro envoyer.

WABA ID (WhatsApp Business Account ID) — Identifiant du compte WABA dans le Meta Business Manager. Nécessaire pour gérer les templates et les paramètres du compte via l'API.

---

Les messages et templates

HSM (Highly Structured Message) — Terme historique pour désigner les templates de messages WhatsApp. Encore utilisé dans certaines documentations, il a été remplacé par "message template" dans la terminologie officielle Meta.

Template de message — Message pré-approuvé par Meta, utilisé pour initier une conversation ou envoyer un message en dehors de la fenêtre de service. Doit respecter les règles de contenu Meta.

Catégorie de template — Chaque template appartient à une catégorie qui détermine le tarif appliqué :

• Marketing : promotions, newsletters, campagnes. Tarif Meta : 0,0712 € pour la France.
• Utility : confirmations, rappels liés à une transaction. Tarif Meta : 0,0248 € pour la France.
• Authentication : OTP, codes de vérification. Tarif Meta identique à utility.

Paramètre de template — Variable dynamique dans un template, indiquée par {{1}}, {{2}}, etc. Remplacée au moment de l'envoi par la valeur personnalisée (prénom, numéro de commande…).

Header — Partie optionnelle en haut d'un template. Peut être un texte, une image, un document ou une vidéo.

Body — Corps principal du message template. Obligatoire, texte uniquement, 1 024 caractères maximum.

Footer — Texte court optionnel en bas du template, non personnalisable dynamiquement.

CTA Button (Call-to-Action) — Bouton interactif dans un template, permettant d'ouvrir une URL ou d'appeler un numéro de téléphone.

Quick Reply — Bouton de réponse rapide dans un template. L'utilisateur clique, une réponse prédéfinie est envoyée. Utile pour les confirmations ou les choix simples.

---

Les concepts techniques

API Cloud Meta — Version hébergée par Meta de l'API WhatsApp. L'infrastructure est gérée par Meta, ce qui simplifie le déploiement mais réduit la flexibilité. À distinguer de l'API On-Premise, dépréciée depuis 2023.

Webhook — Mécanisme par lequel l'API WhatsApp notifie votre serveur en temps réel lors d'un événement : nouveau message reçu, statut de livraison, mise à jour de template. Indispensable pour construire des flux conversationnels.

WAMID (WhatsApp Message ID) — Identifiant unique de chaque message envoyé ou reçu. Utilisé pour suivre le statut d'un message (envoyé, livré, lu) via les webhooks.

Fenêtre de service (Service Window) — Période de 24h après le dernier message d'un utilisateur, pendant laquelle l'entreprise peut répondre librement, sans template. Passé ce délai, seuls les templates approuvés peuvent être envoyés.

Conversation — Unité de facturation de Meta. Une conversation = une fenêtre de 24h d'échanges entre une entreprise et un contact. Le tarif varie selon la catégorie (marketing, utility, authentication, service).

Tier de messagerie — Limite quotidienne de conversations que peut initier un numéro. Un nouveau numéro démarre au Tier 1 (1 000 conversations/jour) et monte progressivement selon la qualité des interactions.

Quality Score — Score de qualité d'un numéro WhatsApp, calculé par Meta en fonction des signalements des utilisateurs (spam, blocages). Un mauvais score peut réduire le tier de messagerie ou suspendre le numéro.

Embedded Signup — Flux d'onboarding qui permet à un client final de connecter son WABA directement depuis l'interface d'un éditeur ou d'une agence, sans passer manuellement par le Meta Business Manager.

Multi-tenant — Architecture permettant à un Meta Tech Provider de gérer plusieurs WABAs de clients différents sous une même infrastructure API. Indispensable pour les éditeurs SaaS et agences multi-clients.

---

Les concepts commerciaux et conformité

Marque blanche — Modèle dans lequel le Meta Tech Provider reste invisible et l'éditeur expose WhatsApp sous sa propre identité commerciale.

Display Name — Nom affiché dans l'interface WhatsApp de l'utilisateur final lors de la réception d'un message. Doit être approuvé par Meta et cohérent avec la marque de l'entreprise.

OBA (Official Business Account) — Compte WhatsApp Business vérifié avec le badge vert. Renforce la confiance des destinataires. L'obtention nécessite une vérification Meta supplémentaire.

Opt-in — Consentement explicite d'un utilisateur à recevoir des messages WhatsApp de la part d'une entreprise. Obligatoire selon les conditions d'utilisation Meta et le RGPD.

Two-Step Verification (2SV) — Couche de sécurité supplémentaire sur le WABA, avec un code PIN à 6 chiffres. Fortement recommandée pour protéger un compte actif.

---

Aller plus loin

Ce vocabulaire est la base pour comprendre n'importe quelle documentation API ou échange technique avec un fournisseur. Pour une vision plus stratégique de l'écosystème, le guide complet de l'API WhatsApp Business pose le contexte de bout en bout. Pour comprendre les enjeux du build vs buy, consultez build vs buy : faut-il devenir BSP soi-même ?.

La solution Whakup Meta Tech Provider s'appuie sur l'ensemble de ces briques — REST API, webhooks, embedded signup, gestion multi-tenant — avec un hébergement en Europe et une conformité RGPD documentée. Une seule intégration pour accéder à toute la puissance de l'API WhatsApp Business.

---

FAQ

Quelle est la différence entre un BSP et un Meta Tech Provider ?

Les deux termes désignent des partenaires autorisés par Meta à distribuer l'accès à l'API WhatsApp. "Meta Tech Provider" est la dénomination actuelle pour les partenaires certifiés au niveau le plus élevé, habilités à gérer des sous-comptes multi-tenant et à activer l'embedded signup pour leurs clients.

Qu'est-ce qu'une conversation au sens de la facturation Meta ?

Une conversation est une fenêtre de 24h d'échanges entre une entreprise et un contact utilisateur. Peu importe le nombre de messages échangés dans cette fenêtre, un seul tarif de conversation s'applique. La catégorie (marketing, utility, authentication) détermine le prix.

Un template HSM peut-il être modifié après approbation ?

Non. Une fois approuvé, le contenu d'un template ne peut pas être modifié. Il faut soumettre un nouveau template. Seuls les paramètres dynamiques ({{1}}, {{2}}…) sont remplacés au moment de l'envoi.

Que se passe-t-il si le Quality Score d'un numéro descend trop bas ?

Meta peut réduire automatiquement le tier de messagerie du numéro, limitant le nombre de conversations initiables par jour. En cas de score très dégradé, le numéro peut être suspendu. Il est donc critique de surveiller les taux de blocage et de signalement.