> ## Documentation Index > Fetch the complete documentation index at: https://docs.orbit.devotel.io/llms.txt > Use this file to discover all available pages before exploring further. # Démarrer avec la WhatsApp Business Platform > Envoyez votre premier message WhatsApp Business Platform via Orbit : connectez une WABA, faites approuver un template, envoyez-le et répondez dans la fenêtre de 24 heures. ## 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](https://docs.orbit.devotel.io/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](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md). * **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](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md). ## 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](#1-connect-a-whatsapp-business-account) — le chemin complet est dans le [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md). **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](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md). **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` : ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "type": "template", "template": { "name": "order_confirmation", "language": { "code": "en" }, "components": [ { "type": "body", "parameters": [ { "type": "text", "text": "Ada" }, { "type": "text", "text": "ORD-12345" } ] } ] } }' ``` La réponse rend un identifiant de message que vous suivez via les [webhooks de livraison](https://docs.orbit.devotel.io/webhooks/events.md) (`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 : ```bash theme={null} curl -X POST https://api.orbit.devotel.io/api/v1/messages/whatsapp \ -H "X-API-Key: dv_live_sk_..." \ -H "Content-Type: application/json" \ -d '{ "to": "+14155552671", "type": "text", "text": { "body": "Thanks for reaching out! How can we help?" } }' ``` **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. ```bash theme={null} curl "https://api.orbit.devotel.io/api/v1/messages/whatsapp/window-status?to=+14155552671&from=+18005551234" \ -H "X-API-Key: dv_live_sk_..." ``` 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 * [WABA setup guide](https://docs.orbit.devotel.io/guides/whatsapp/waba-setup.md) — le chemin complet compte, numéro et vérification. * [The 24-hour window](https://docs.orbit.devotel.io/guides/whatsapp/24h-window.md) — comment fonctionnent les fenêtres de service et le réengagement. * [WhatsApp channel reference](https://docs.orbit.devotel.io/channels/whatsapp.md) — chaque champ de l'API WhatsApp, médias et messages interactifs compris. * [WhatsApp pricing](https://docs.orbit.devotel.io/guides/whatsapp/pricing.md) — comment les conversations sont tarifées. * [Content policy](https://docs.orbit.devotel.io/compliance/whatsapp-content-policy.md) — ce que Meta approuve et rejette. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.