# Premiers pas

> Index de la documentation : https://wahasend.com/docs/fr/llms.txt · Tout en un fichier : https://wahasend.com/docs/fr.md · URL de base de l'API : https://app.wahasend.com/api/v1

WahaSend envoie et reçoit des messages WhatsApp depuis **votre propre numéro WhatsApp**. L'API est du simple HTTPS avec du JSON. Cinq minutes de zéro au premier message :

1. [Créez un compte](https://wahasend.com/register) et choisissez un produit. Il commence par un essai gratuit, et chaque produit vient avec une clé d'API ([les routes de chacun](https://wahasend.com/docs/fr/authentication.md#auth-products)).
2. Reliez votre numéro WhatsApp : tableau de bord → **WhatsApp**, scannez le QR code avec votre téléphone (ou utilisez le code d'association sur un téléphone).
3. Récupérez votre clé : tableau de bord → **Pour les développeurs** → **Générer une clé** (avec Connect : page **Connect**). Elle n'est affichée qu'une fois ; gardez-la comme un mot de passe.
4. Envoyez votre premier message :

```bash
curl https://app.wahasend.com/api/v1/alert/send \
  -H "X-API-Key: $WAHASEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+22212345678", "message": "Hello from WahaSend"}'
```

Réponse (201):

```json
{
  "success": true,
  "messageId": "4f0c6a1e-2b7d-4c1a-9e35-7d8f2a6b1c90",
  "status": "queued",
  "priority": "normal"
}
```

Le message part quelques secondes plus tard avec l'indicateur « écrit… ». Suivez-le avec `GET /messages` ou les [événements webhook](https://wahasend.com/docs/fr/webhooks.md).

<a id="base-url"></a>

### URL de base et format

- Tous les chemins ci-dessous commencent par `https://app.wahasend.com/api/v1`.
- Envoyez du JSON avec `Content-Type: application/json` (10 Mo max par requête). Les réponses sont en JSON.
- Les réponses réussies portent `"success": true` (sauf pour l'instant les routes des [numéros WhatsApp](https://wahasend.com/docs/fr/api/numbers.md)). Les erreurs utilisent toujours [la même enveloppe](https://wahasend.com/docs/fr/errors.md).
- Les dates sont en ISO 8601 UTC (`2026-09-30T10:30:12.000Z`). Les identifiants sont des UUID.
- Chaque réponse a un en-tête `X-Request-Id` : donnez-le quand vous écrivez au support.

<a id="products"></a>

### Ce que chaque produit débloque

Chaque endpoint ci-dessous indique la fonction nécessaire. Un compte peut avoir plusieurs produits et cumule leurs fonctions. Appeler une fonction non incluse répond 403 `PRODUCT_REQUIRED` avec `details.products`. Notify, Assistant et Shop permettent d'ajouter autant de numéros WhatsApp que nécessaire ; Developer et Connect en incluent 3, et les suivants sont des numéros supplémentaires (voir [Numéros WhatsApp](https://wahasend.com/docs/fr/api/numbers.md)).

| Produit | Fonctions | Clé d'API |
| --- | --- | --- |
| Notify | `send, batch, campaigns, reminders, api` | oui |
| Assistant | `send, bots, knowledge, api` | oui |
| Shop | `send, bots, commerce, api` | oui |
| Developer | `send, batch, api, otp, media, webhooks` | oui |
| Connect | `send, batch, inbox, mcp, api` | oui |

<a id="for-agents"></a>

### Pour les agents IA

Cette documentation existe aussi en Markdown, pour les agents de code (Claude Code, Cursor, Codex…) et tout ce qui lit le web sans exécuter JavaScript : [llms.txt](https://wahasend.com/llms.txt) liste toutes les pages, [llms-full.txt](https://wahasend.com/llms-full.txt) les réunit en un fichier, et chaque page a sa propre adresse `.md` (par exemple [getting-started.md](https://wahasend.com/docs/getting-started.md) ; la version française est sous `/docs/fr/`). Pour qu'une application d'IA envoie et lise elle-même des messages WhatsApp, utilisez [Connect](https://wahasend.com/docs/fr/connect.md).

Les agents de code peuvent aussi installer le skill WahaSend (quoi appeler pour quoi, signatures des webhooks, erreurs, protéger le numéro), et les outils d'API importer [openapi.json](https://wahasend.com/openapi.json) (OpenAPI 3.1 : Postman, Insomnia, générateurs de SDK, actions GPT).

```bash
npx skills add ahmedEssyad/wahasendskills
```

Une consigne pour votre agent:

```text
Read https://wahasend.com/llms.txt and the pages it links to, then add WhatsApp notifications to this project with the WahaSend API. My key is in the WAHASEND_API_KEY environment variable.
```