WhatsApp Cloud API : guide du débutant sur l'offre gratuite

La WhatsApp Cloud API semble intimidante, mais l'idée de base est simple : c'est le moyen, hébergé gratuitement par Meta, d'envoyer et de recevoir des messages WhatsApp depuis votre propre logiciel. Ce guide explique ce que c'est, ce qui est réellement gratuit, et comment envoyer votre premier message — sans le jargon.

Ce qu'est réellement la Cloud API

La WhatsApp Cloud API fait partie de la WhatsApp Business Platform. Au lieu de taper des messages sur un téléphone, vos systèmes les envoient et les reçoivent de façon programmatique. Meta l'héberge dans le cloud : vous n'exploitez donc aucun serveur WhatsApp vous-même — un changement majeur par rapport à l'ancienne API on-premise.

Elle permet ce que l'application gratuite WhatsApp Business ne peut pas faire :

• Confirmations de commande, mises à jour d'expédition et rappels automatisés.
• Une boîte de réception partagée où plusieurs agents gèrent les conversations depuis un seul numéro.
• Chatbots et intégrations CRM/helpdesk.
• Du marketing à grande échelle vers des utilisateurs consentants.

Si vous avez seulement besoin de recevoir des conversations depuis un lien, vous n'en avez pas besoin — un lien wa.me issu de notre générateur de liens WhatsApp gratuit suffit. La Cloud API est faite pour l'automatisation et l'échelle.

Hébergement gratuit vs messagerie gratuite — ne les confondez pas

Deux « gratuités » différentes se mélangent :

1. L'hébergement est gratuit. Contrairement à l'ancienne API on-premise, Meta héberge la Cloud API sans frais. Aucun serveur à louer.
2. La messagerie dispose d'une offre gratuite plus un usage payant. WhatsApp facture par conversation (une fenêtre de 24 heures), certaines conversations étant gratuites et d'autres payantes selon la catégorie.

Un grand changement est arrivé en 2025 : les conversations de service initiées par l'utilisateur sont devenues gratuites — lorsqu'un client vous écrit et que vous répondez dans la fenêtre de service, cela n'est généralement pas facturé. Les catégories initiées par l'entreprise comme le marketing et (dans bien des cas) l'utilitaire/authentification sont payantes. Les quotas et tarifs exacts changent et varient selon les pays : confirmez donc toujours les taux en vigueur dans la documentation tarifaire de Meta plutôt que de vous fier à un chiffre figé.

Les catégories de conversation en clair

La facturation tourne autour des catégories de conversation :

• Service — le client démarre la conversation ; vous répondez dans une fenêtre de 24 heures. Largement gratuite depuis le changement de 2025.
• Marketing — vous faites une promotion proactive (offres, lancements). Payante, et nécessite un consentement + des templates approuvés.
• Utilitaire — mises à jour transactionnelles liées à une action (commande expédiée, rappel de rendez-vous). Utilise des templates ; la tarification varie.
• Authentification — codes à usage unique et vérification. Utilise des templates.

La règle générale : les réponses de service initiées par le client sont la voie économique/gratuite ; le marketing initié par l'entreprise est la voie payante.

Messages de session vs messages template

• Dans la fenêtre de service de 24 heures (après qu'un utilisateur vous a écrit), vous pouvez envoyer des messages en format libre.
• Hors de cette fenêtre, ou pour démarrer une conversation, vous devez envoyer un message template pré-approuvé. Les templates empêchent les entreprises de spammer les utilisateurs à froid.

Ce dont vous avez besoin pour démarrer

Pour envoyer votre premier message, vous mettrez en place :

1. Un compte Meta (Facebook) Business.
2. Une application WhatsApp Business Platform dans le tableau de bord développeur de Meta.
3. Un numéro de téléphone enregistré sur la plateforme (un numéro de test est fourni pour commencer).
4. Des identifiants API — un token et l'ID de votre numéro de téléphone.

Meta fournit un numéro de test et un petit quota pour que vous puissiez expérimenter avant le passage en production.

Envoyer votre premier message (la forme générale)

Une fois configuré, l'envoi est une requête HTTP vers l'API Graph de Meta. En principe :

POST https://graph.facebook.com/v22.0/${PHONE_NUMBER_ID}/messages
Authorization: Bearer ${ACCESS_TOKEN}
Content-Type: application/json

{
  "messaging_product": "whatsapp",
  "to": "972541234567",
  "type": "text",
  "text": { "body": "Bonjour depuis la Cloud API !" }
}

Pour écrire à quelqu'un qui ne vous a pas contacté en premier, remplacez type: "text" par un message template référençant un template approuvé. Remplacez ${PHONE_NUMBER_ID} et ${ACCESS_TOKEN} par vos propres valeurs, et notez que la version de l'API (v22.0 ici) évolue avec le temps.

Recevoir des messages : les webhooks

Les messages entrants arrivent via un webhook — une URL que vous hébergez et que Meta appelle chaque fois qu'un utilisateur vous écrit. Vous vérifiez le webhook une fois, puis Meta y publie les événements de message. C'est ainsi que les bots et les boîtes de réception partagées « entendent » les clients.

Un débutant devrait-il l'utiliser ?

Posez-vous deux questions :

• Ai-je besoin d'automatisation ou d'une boîte de réception d'équipe ? Si non, restez sur l'application gratuite WhatsApp Business.
• Est-ce que j'envoie à grande échelle vers des utilisateurs consentants ? Si oui, la Cloud API est la voie conforme.

Beaucoup de petites entreprises accèdent à la Cloud API via un Business Solution Provider (comme Twilio, 360dialog ou MessageBird) ou un outil no-code, qui masque l'essentiel de l'API brute. Pour une voie no-code, voir Automatiser WhatsApp avec Zapier & Make, et pour la planification budgétaire, les tarifs de l'API WhatsApp Business.

À retenir

• L'hébergement est gratuit ; la messagerie dispose d'une offre gratuite plus des catégories payantes.
• Les conversations de service initiées par l'utilisateur sont largement gratuites depuis 2025.
• Le marketing/utilitaire/authentification utilise des templates approuvés et est généralement payant.
• Les débutants sans besoin d'automatisation n'ont pas du tout besoin de l'API — un lien wa.me couvre les conversations entrantes.

Commencez simplement avec un lien WhatsApp gratuit et passez à la Cloud API lorsque l'automatisation l'exige.