# Plateforme WhatsApp Business : Cloud API et modèles

> La plateforme WhatsApp Business envoie des messages via la Cloud API (hébergée par Meta) ou l'ancienne On-Premises API. Les messages à l'initiative de l'entreprise doivent utiliser des modèles pré-approuvés dans une catégorie (marketing, utility, authentication) ; les messages de session en format libre ne sont autorisés qu'à l'intérieur d'une fenêtre de service client de 24 heures ouverte par le dernier message de l'utilisateur. L'opt-in est obligatoire.

- URL canonique: https://www.broadnet.me/fr/reference/whatsapp-business-cloud-api
- Langue: fr
- Dernière mise à jour: 2026-07-18
- Éditeur: BroadNet (https://www.broadnet.me)

Le fonctionnement de la plateforme WhatsApp Business : Cloud API vs On-Premises API, messages modèles (HSM) vs messages de session, la fenêtre de service client de 24 heures, les catégories marketing/utility/authentication, les webhooks, les paliers de qualité des numéros et l'opt-in.

## Cloud API vs On-Premises API

La plateforme WhatsApp Business expose deux API partageant le même modèle de messagerie mais un hébergement différent. La Cloud API est hébergée par Meta : une entreprise (ou son fournisseur de solutions) appelle un endpoint REST de type Graph indexé sur un identifiant de numéro de téléphone, sans client local à exploiter. L'On-Premises API est un client conteneurisé que l'entreprise héberge elle-même, historiquement utilisé pour des raisons de résidence des données ou de latence ; Meta l'a désignée pour un retrait au profit de la Cloud API. Les deux sont régies par les mêmes règles — modèles, fenêtre de 24 heures, catégories, qualité et opt-in — de sorte que le choix est opérationnel (qui héberge) plutôt que fonctionnel.

*Cloud API vs On-Premises API*

| Propriété | Cloud API | On-Premises API |
|---|---|---|
| Hébergement | Hébergé par Meta, aucun client à exécuter | Client conteneurisé hébergé en entreprise |
| Point de terminaison | API Graph REST sur un ID de numéro de téléphone | Point de terminaison REST du client local |
| Mises à jour | Géré par Meta | L'entreprise maintient les versions client |
| Statut | Recommandé, activement développé | Voué au retrait (sunset) |
| Règles (modèles/fenêtre/qualité) | Identique | Identique |

## Messages modèles (HSM) vs messages de session

WhatsApp sépare les deux sens de la messagerie professionnelle. Une entreprise ne peut pas contacter à froid un utilisateur avec du contenu en format libre : tout message à l'initiative de l'entreprise doit être un modèle de message — historiquement appelé Highly Structured Message (HSM) — soumis à WhatsApp et approuvé au préalable, avec des espaces réservés à variables nommées et une catégorie déclarée. Une fois que l'utilisateur répond, une fenêtre de service client de 24 heures s'ouvre, durant laquelle l'entreprise peut envoyer des messages de session en format libre (texte, médias, interactif) sans modèle. En dehors de cette fenêtre, l'entreprise doit à nouveau commencer par un modèle approuvé. Cette règle du modèle d'abord est la contrainte centrale de la plateforme.

*Cloud API : envoyer un modèle utility approuvé*

```json
POST https://graph.facebook.com/v20.0/{phone-number-id}/messages
Authorization: Bearer {access-token}
{
  "messaging_product": "whatsapp",
  "to": "15551234567",
  "type": "template",
  "template": {
    "name": "order_shipped",
    "language": { "code": "en_US" },
    "components": [
      { "type": "body",
        "parameters": [ { "type": "text", "text": "4021" } ] }
    ]
  }
}
```

## La fenêtre de service client de 24 heures

La fenêtre de 24 heures est le mécanisme qui conditionne la messagerie en format libre. Elle s'ouvre (ou se rouvre) chaque fois que l'utilisateur envoie un message à l'entreprise, et dure 24 heures à compter de ce dernier message utilisateur. À l'intérieur de la fenêtre, l'entreprise peut répondre avec tout type de message autorisé — texte simple, médias, boutons interactifs ou listes — sans utiliser de modèle. Lorsque la fenêtre se referme, les envois en format libre sont rejetés et l'entreprise doit renouer le contact avec un modèle approuvé (sous réserve de la catégorie et, pour le marketing, de limites par utilisateur). La tarification à la session comme la nouvelle tarification par message dépendent toutes deux du fait qu'un envoi tombe à l'intérieur ou à l'extérieur de cette fenêtre.

## Catégories de messages : marketing, utility, authentication

Chaque modèle se voit attribuer une catégorie qui régit son usage et sa tarification. Les modèles utility se rapportent à une transaction ou à un événement de compte précis et convenu (mises à jour de commande, rappels de rendez-vous, relevés). Les modèles authentication délivrent des codes à usage unique et des vérifications, dans un format contraint. Les modèles marketing portent des promotions, des offres et des relances et sont les plus strictement encadrés — soumis à l'opt-in de l'utilisateur, aux signaux de qualité et à des limites de fréquence. WhatsApp examine le contenu du modèle au regard de la catégorie déclarée lors de l'approbation et peut le reclasser ; envoyer du contenu marketing sous une étiquette utility est une cause fréquente de rejet ou de dégradation de la qualité.

*Catégories de modèles WhatsApp*

| Catégorie | Objectif | Notes |
|---|---|---|
| Utilitaire | Mises à jour des transactions/comptes attendues par l'utilisateur | Lié à une action ou un accord spécifique |
| Authentification | Codes d'accès à usage unique, vérification | Format contraint ; axé OTP |
| Marketing | Promotions, offres, réengagement | Gouvernance stricte basée sur le consentement explicite, la qualité et la fréquence |
| Service (session) | Réponses libres dans la fenêtre de 24 heures | Aucun modèle requis ; non initié par l'entreprise |

## Webhooks : messages entrants et statut de remise

La plateforme est asynchrone et pilotée par callbacks. Une entreprise configure une URL de webhook vers laquelle WhatsApp poste deux types d'événements : les messages entrants (les réponses de l'utilisateur, médias, appuis sur boutons, localisation) et les notifications de statut des messages sortants, qui progressent de sent à delivered, read et — en cas d'échec — failed avec un code d'erreur. Les accusés de lecture et le cycle de vie du message apparaissent ici, et l'arrivée d'un événement de message entrant est précisément ce qui ouvre ou rafraîchit la fenêtre de 24 heures. Une intégration robuste accuse rapidement réception des webhooks et réconcilie le statut de remise avec son propre magasin de messages, comme une plateforme SMS réconcilie ses DLR.

*Webhook entrant : le message de l'utilisateur ouvre la fenêtre de 24 heures*

```json
{
  "entry": [{ "changes": [{ "value": {
    "messaging_product": "whatsapp",
    "messages": [{
      "from": "15551234567", "id": "wamid.HBg...",
      "timestamp": "1752796800",
      "type": "text", "text": { "body": "Where is my order?" }
    }]
  } }] }]
}
```

## Qualité des numéros, paliers et opt-in

Chaque numéro de téléphone professionnel porte une note de qualité (affichée en high/medium/low, souvent colorée en vert/jaune/rouge) dérivée de la façon dont les utilisateurs réagissent à ses messages — les blocages et les signalements la font baisser. La qualité conditionne le palier de limite de messagerie, qui plafonne le nombre d'utilisateurs uniques avec lesquels un numéro peut engager des conversations sur une fenêtre glissante de 24 heures ; les paliers montent (par exemple 250, 1K, 10K, 100K, puis illimité) à mesure que la qualité et le volume se maintiennent, et redescendent si la qualité chute. À la base de tout se trouve l'opt-in : WhatsApp exige des entreprises qu'elles obtiennent et consignent le consentement explicite de l'utilisateur, recueilli sur n'importe quel canal, avant tout envoi. Une mauvaise pratique d'opt-in se traduit rapidement par des blocages, une qualité dégradée et un palier bridé.

*Note de qualité et paliers de messagerie*

| Signal | Signification | Effet |
|---|---|---|
| Qualité : élevée (verte) | Peu de blocs/rapports | Éligible pour passer à des niveaux supérieurs |
| Qualité : moyenne (jaune) | Quelques commentaires négatifs | Sous observation ; montée en charge suspendue |
| Qualité : faible (rouge) | De nombreux blocs/rapports | Risque de rétrogradation ou de signalement |
| Niveau (250 / 1K / 10K / 100K / ∞) | Utilisateurs uniques ayant démarré par période de 24 heures | Relevé en cas de qualité et de volume soutenus |
| Opt-in | Consentement enregistré de l'utilisateur | Requis avant tout envoi initié par l'entreprise |

## Questions fréquentes

### Quelle est la différence entre la Cloud API et l'On-Premises API ?

Les deux utilisent le même modèle de messagerie WhatsApp, mais la Cloud API est hébergée par Meta (vous appelez un endpoint REST, rien à exploiter), tandis que l'On-Premises API est un client conteneurisé que vous hébergez vous-même. Meta a désigné l'On-Premises API pour un retrait au profit de la Cloud API. Les modèles, la fenêtre de 24 heures, les catégories et les règles de qualité s'appliquent de façon identique aux deux.

### Qu'est-ce qu'un modèle de message WhatsApp (HSM) ?

Un modèle — historiquement un Highly Structured Message — est un contenu pré-approuvé avec des espaces réservés à variables nommées et une catégorie déclarée. Tout message WhatsApp à l'initiative de l'entreprise doit être un modèle ; le contenu en format libre n'est autorisé qu'à l'intérieur de la fenêtre de service client de 24 heures ouverte par une réponse de l'utilisateur.

### Qu'est-ce que la fenêtre de service client de 24 heures ?

C'est la période, d'une durée de 24 heures à compter du dernier message de l'utilisateur vers l'entreprise, pendant laquelle l'entreprise peut envoyer des messages de session en format libre sans modèle. À sa fermeture, les envois en format libre sont rejetés et l'entreprise doit renouer le contact avec un modèle approuvé. Les événements de webhook entrants ouvrent ou rafraîchissent la fenêtre.

### Quelles sont les catégories de messages WhatsApp ?

Les modèles sont classés en utility (mises à jour de transaction/compte attendues par l'utilisateur), authentication (codes à usage unique et vérification), ou marketing (promotions et relances, la plus strictement encadrée). Les réponses en format libre dans la fenêtre sont des messages de service. La catégorie régit l'usage autorisé et la tarification, et WhatsApp examine le contenu au regard de la catégorie déclarée.

### Qu'est-ce qui détermine la limite de messagerie d'un numéro WhatsApp ?

Le palier de messagerie plafonne le nombre d'utilisateurs uniques avec lesquels un numéro peut engager des conversations sur une fenêtre glissante de 24 heures (par exemple 250, 1K, 10K, 100K, puis illimité). Les paliers montent avec une qualité et un volume soutenus et baissent si la qualité chute. La qualité est une note high/medium/low pilotée par les blocages et les signalements des utilisateurs.

### Ai-je besoin d'un opt-in pour envoyer des messages aux utilisateurs sur WhatsApp ?

Oui. WhatsApp exige un consentement utilisateur explicite et consigné — qui peut être recueilli sur n'importe quel canal — avant qu'une entreprise n'envoie des messages. Un opt-in faible se traduit rapidement par des blocages et des signalements, qui abaissent la note de qualité du numéro et peuvent brider ou rétrograder son palier de messagerie.

## Sources

- [WhatsApp Business Platform — Cloud API documentation](https://developers.facebook.com/docs/whatsapp/cloud-api)
- [WhatsApp — Message templates and categories](https://developers.facebook.com/docs/whatsapp/business-management-api/message-templates)
- [WhatsApp — Per-message pricing and the 24-hour window](https://developers.facebook.com/docs/whatsapp/pricing)

## Voir aussi

- [WhatsApp Business API](https://www.broadnet.me/fr/products/whatsapp-business-api)
- [RCS vs SMS vs WhatsApp](https://www.broadnet.me/fr/reference/rcs-vs-sms-vs-whatsapp-channels)
- [Cartes enrichies et messagerie interactive](https://www.broadnet.me/fr/reference/rich-cards-and-interactive-messaging)
- [Fallback de canal et orchestration](https://www.broadnet.me/fr/reference/channel-fallback-and-orchestration)
- [Omnicanal](https://www.broadnet.me/fr/products/omnichannel)
- [Développeurs](https://www.broadnet.me/fr/developers)