Skip to main content

​
Note de langue

Cette version française est une traduction abrégée : la section « Frequently asked questions » n’existe qu’en anglais : /en/guides/whatsapp/getting-started. Les blocs de code, chemins d’endpoints, noms de champs API et codes d’erreur restent en anglais.

​
Démarrer avec la WhatsApp Business Platform

La WhatsApp Business Platform est l’API officielle de Meta pour envoyer et recevoir des messages WhatsApp à l’échelle — la même plateforme derrière les suivis de commande, rappels de rendez-vous et conversations support des entreprises que vous contactez déjà. Via Orbit, vous l’utilisez avec un appel REST et une clé API, sans intégrer directement la Cloud API de Meta.

​
Comment fonctionne la plateforme

Deux règles façonnent tout ce que vous envoyez :
  • Il faut un template approuvé pour ouvrir une conversation. Tout message que vous envoyez en premier — confirmation de commande, code à usage unique, avis d’expédition — doit utiliser un template relu et approuvé par Meta. Les templates existent en quatre catégories : authentication, utility, marketing et service. La catégorie détermine ce que vous payez.
  • Une réponse ouvre une fenêtre de 24 heures. Quand un client vous écrit, une fenêtre de service de 24 heures s’ouvre. Dedans, vous pouvez envoyer en forme libre — texte simple, médias, boutons interactifs. Une fois la fenêtre fermée, retour aux templates seuls. Voir The 24-hour window.

​
Avant de commencer

Il vous faut :
  • Un compte Orbit et une clé API live (Settings → API Keys). Les clés live portent le préfixe dv_live_sk_ ; gardez-les côté serveur.
  • Un WhatsApp Business Account (WABA) connecté à Orbit. Suivez l’étape 1 — le chemin complet est dans le WABA setup guide.
1

Connect a WhatsApp Business Account

Dans le dashboard Orbit, allez à Settings → Channels → WhatsApp → Connect et terminez l’inscription embarquée de Meta : choisissez votre Business Manager, créez ou sélectionnez une WABA et vérifiez un numéro de téléphone par code SMS ou vocal.Vous pouvez envoyer dès que le numéro est vérifié — pas besoin d’attendre la fin de la vérification business de Meta. D’ici là, une nouvelle WABA est plafonnée à 250 destinataires uniques par 24 heures.
2

Create and approve a template

Allez à Channels → WhatsApp → Templates → New Template et soumettez-en un :
  1. Choisissez une catégorie — authentication, utility, marketing ou service.
  2. Choisissez une langue (chaque locale est une soumission distincte).
  3. Écrivez le corps avec des variables numérotées, par ex. Hi {{1}}, your order {{2}} shipped.
  4. Soumettez. La plupart des templates sont approuvés en quelques minutes ; comptez jusqu’à 24 heures.
Gardez la catégorie honnête — un message promotionnel soumis en utility est le rejet le plus courant. Voir la content policy.
3

Send your first template message

Une fois le template approuvé, envoyez-le d’un seul POST. Référencez le template par name et language, et remplissez ses variables via components :
La réponse rend un identifiant de message que vous suivez via les webhooks de livraison (message.sent, message.delivered, message.read).
4

Reply inside the 24-hour window

Quand un client répond, la fenêtre de service de 24 heures s’ouvre et vous pouvez envoyer des messages en forme libre — sans template :
5

Check the window before you send

Pas sûr qu’un contact soit encore dans la fenêtre ? Vérifiez avant de composer un message en forme libre. Si la fenêtre est fermée, rabattez-vous sur un template.
Le pipeline d’envoi applique la même règle : un envoi en forme libre hors fenêtre est rejeté plutôt que silencieusement jeté — mais le contrôle préalable vous permet de limiter votre UI aux templates.
6

Scale beyond the starter limit

Les nouvelles WABA démarrent à 250 destinataires uniques par 24 heures. Tant que vous envoyez régulièrement à plus de destinataires en gardant une note qualité Medium ou Green, Meta monte votre palier automatiquement — à 1 000, puis 10 000, puis 100 000, puis illimité. Une note Low gèle les montées de palier.

​
Prochaines étapes