---
title: "Envoyer votre premier message WhatsApp"
description: "Créez une clé Bird API, envoyez un message basé sur un modèle WhatsApp préapprouvé vers votre téléphone sans connecter de numéro, puis vérifiez son statut de distribution."
canonical: "https://bird.com/fr-fr/documentation/get-started/send-your-first-whatsapp"
---

# Envoyer votre premier message WhatsApp

Envoyez un message WhatsApp vers votre propre téléphone avec Bird WhatsApp, puis relisez le message pour confirmer sa distribution. Les envois à l’initiative de l’entreprise utilisent un modèle préapprouvé. Ce guide de démarrage envoie depuis le catalogue de modèles gérés de Bird (comme `bird_delivery_update` ou `bird_otp`), qui utilise un expéditeur WhatsApp partagé géré par Bird. Vous n’avez pas besoin de connecter un compte WhatsApp Business ni d’enregistrer un numéro au préalable.

Avant de commencer, vérifiez que le portefeuille de votre organisation est approvisionné. Les envois de modèles WhatsApp sont débités du portefeuille, et Bird refuse avec `402` `WalletInsufficientBalance` tout envoi que le solde ne peut pas couvrir. La page [Moyens de paiement et portefeuille](/docs/knowledge-base/billing/payment-methods-wallet) explique comment recharger le portefeuille.

## 1. Créer une clé API

Dans le tableau de bord, accédez à **Platform tools** > [**API keys**](https://bird.com/dashboard/w/api-keys) et créez une clé avec la portée `whatsapp:write`, qui permet d’envoyer et de lire des messages. Chaque clé est liée à une région et ressemble à `bk_us1_...` ou `bk_eu1_...`. La région indiquée dans le préfixe détermine l’hôte API à appeler : `https://us1.platform.bird.com` ou `https://eu1.platform.bird.com`.

![La page des clés API dans le tableau de bord Bird, qui liste les clés avec leur préfixe masqué, leurs portées et leur date de dernière utilisation](/images/docs/dashboard-api-keys.png)

La clé complète ne s’affiche qu’**une seule fois**, lors de sa création. Copiez-la en lieu sûr, puis exportez-la pour les exemples cURL :

```bash
export BIRD_API_KEY="bk_us1_..."
```

## 2. Envoyer un message basé sur un modèle

Envoyez le modèle `bird_delivery_update` préapprouvé du catalogue géré de Bird vers votre téléphone, ou utilisez `bird_otp` pour envoyer un code de vérification à usage unique. Les modèles gérés commencent par `bird_` et sont envoyés depuis un numéro Bird partagé : vous omettez donc `from`. Installez le SDK Bird pour votre langage en suivant son [guide de démarrage SDK](/docs/get-started/quickstarts). Si vous utilisez l’onglet [Bird CLI](/docs/cli), installez-le d’abord (`curl -fsSL https://cli.bird.com/install.sh | sh`), puis authentifiez-vous avec un accès en écriture (`bird auth login --scope whatsapp:write`).

Dans les onglets SDK, remplacez la clé API d’exemple, et remplacez `+15551234567` par votre numéro de mobile au format [E.164](https://en.wikipedia.org/wiki/E.164). Le CLI utilise votre connexion, et l’onglet cURL utilise `BIRD_API_KEY`.

**TypeScript**

```typescript
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: "bk_XXXXXXXXXXXXXXXXXXXXXXXX" });

const msg = await bird.whatsapp.send({
  to: "+15551234567",
  template: {
    slug: "bird_delivery_update",
    components: [
      {
        type: "body",
        parameters: [
          { type: "text", name: "ref", text: "A1B2C3D4" },
          { type: "text", name: "date", text: "10 Jul 2026" },
        ],
      },
    ],
  },
});

console.log(msg.id, msg.status);
```

Examples: [TypeScript](/fr-fr/documentation/get-started/send-your-first-whatsapp.ts.md) · [Python](/fr-fr/documentation/get-started/send-your-first-whatsapp.py.md) · [Go](/fr-fr/documentation/get-started/send-your-first-whatsapp.go.md) · [PHP](/fr-fr/documentation/get-started/send-your-first-whatsapp.php.md) · [CLI](/fr-fr/documentation/get-started/send-your-first-whatsapp.cli.md) · [MCP](/fr-fr/documentation/get-started/send-your-first-whatsapp.mcp.md) · [cURL](/fr-fr/documentation/get-started/send-your-first-whatsapp.curl.md)

Si votre clé commence par `bk_eu1_`, appelez plutôt `https://eu1.platform.bird.com`.

L’API répond avec `202 Accepted` et le message créé. Son `id` commence par `wam_`, et son `status` vaut `accepted` : Bird a accepté le message et le distribue de manière asynchrone. Conservez le `id` pour l’étape suivante.

## 3. Vérifier le statut de distribution

Récupérez le message à partir de son ID `wam_`. Remplacez `WHATSAPP_MESSAGE_ID` par le `id` obtenu à l’étape 2, puis remplacez la clé API d’exemple dans les onglets SDK par la vôtre :

**TypeScript**

```typescript
import { BirdClient } from "@messagebird/sdk";

const bird = new BirdClient({ apiKey: "bk_XXXXXXXXXXXXXXXXXXXXXXXX" });

const msg = await bird.whatsapp.get("WHATSAPP_MESSAGE_ID");

console.log(msg.id, msg.status);
```

Examples: [TypeScript](/fr-fr/documentation/get-started/send-your-first-whatsapp.ts.md) · [Python](/fr-fr/documentation/get-started/send-your-first-whatsapp.py.md) · [Go](/fr-fr/documentation/get-started/send-your-first-whatsapp.go.md) · [PHP](/fr-fr/documentation/get-started/send-your-first-whatsapp.php.md) · [CLI](/fr-fr/documentation/get-started/send-your-first-whatsapp.cli.md) · [cURL](/fr-fr/documentation/get-started/send-your-first-whatsapp.curl.md)

Le champ `status` indique où en est le message :

- `accepted` : Bird a admis le message et se prépare à le transmettre à WhatsApp.
- `sent` : WhatsApp a accepté le message, et `sent_at` en enregistre l’heure.
- `delivered` : WhatsApp a confirmé la distribution sur l’appareil du destinataire, et `delivered_at` en enregistre l’heure. Lorsque le destinataire lit le message, `read_at` est renseigné tandis que `status` reste à `delivered`.
- `failed` ou `rejected` : le message n’a pas atteint le téléphone. `last_error` indique la raison, et [Événements de statut des messages](/docs/guides/whatsapp/events/message-status) répertorie les codes d’erreur.

Interrogez l’API jusqu’à ce que le statut ne soit plus `accepted` ni `sent`, ou abonnez-vous aux [webhooks WhatsApp](/docs/guides/whatsapp/webhooks) pour recevoir chaque changement de statut de distribution et de lecture (`whatsapp.sent`, `whatsapp.delivered`, `whatsapp.read`, `whatsapp.failed`). Les numéros partagés gérés par Bird servent uniquement à l’envoi et ne transmettent pas les réponses entrantes à votre espace de travail ; pour recevoir des réponses, [connectez votre propre numéro](/docs/guides/whatsapp/numbers/connect). Chaque message apparaît également sur la page [**Messages**](https://bird.com/dashboard/w/whatsapp/messages) avec la chronologie de ses événements.

## Corriger un envoi en échec

- **`402` `WalletInsufficientBalance`** : le solde du portefeuille ne couvre pas le message. Rechargez le portefeuille, puis renvoyez le message.
- **`403` `InsufficientScope`** : la clé API n’a pas la portée `whatsapp`. Modifiez les portées de la clé ou créez une clé avec `whatsapp:write`.
- **`422` `WhatsAppInvalidRecipient`** : le numéro `to` n’est pas un numéro de téléphone E.164 valide. Vérifiez le `+` initial, l’indicatif du pays et les chiffres de l’abonné.

## Étapes suivantes

- [Envoyer des messages WhatsApp](/docs/guides/whatsapp/sending-whatsapp) : envoyez des modèles et des messages de service libres pendant la fenêtre de service client de 24 heures.
- [Modèles WhatsApp](/docs/guides/whatsapp/templates) : parcourez le catalogue géré (`bird_otp`, `bird_delivery_update` et d’autres) ou [créez vos propres modèles](/docs/guides/whatsapp/authoring-templates).
- [Connecter un numéro de téléphone](/docs/guides/whatsapp/numbers/connect) : utilisez votre propre compte WhatsApp Business et votre propre numéro d’expéditeur pour que votre espace de travail puisse aussi recevoir les réponses entrantes.
- [Webhooks WhatsApp](/docs/guides/whatsapp/webhooks) : recevez les accusés de réception et de lecture (ainsi que les messages entrants si vous utilisez votre propre numéro connecté).
- [Référence WhatsApp API](/docs/api/reference/create-whatsapp-message) : le schéma complet des requêtes et des réponses.

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [Connect WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp-connect)