> ## Documentation Index
> Fetch the complete documentation index at: https://docs.waaconnect.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Démarrage rapide

> Envoyez votre premier message WhatsApp avec WaaConnect en moins de 5 minutes.

## 1. Obtenez votre clé API

Connectez-vous sur [app.waaconnect.com](https://app.waaconnect.com) et copiez votre clé API depuis les paramètres de votre compte.

```
x-api-key: wac_xxxxxxxxxxxxxxxx
```

## 2. Créez une session WhatsApp

Une session représente un numéro WhatsApp connecté à WaaConnect.

```bash theme={null}
curl -X POST https://api.waaconnect.com/v1/sessions \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Ma première session"}'
```

Notez l'`id` retourné — c'est votre `sessionId`.

## 3. Connectez la session

Deux méthodes sont disponibles pour associer WhatsApp à votre session.

<Tabs>
  <Tab title="QR code">
    Lancez la connexion pour générer un QR code.

    ```bash theme={null}
    curl -X POST https://api.waaconnect.com/v1/sessions/VOTRE_SESSION_ID/connect \
      -H "x-api-key: wac_xxxxxxxxxxxxxxxx"
    ```

    Récupérez ensuite le QR code et scannez-le avec WhatsApp sur votre téléphone.

    ```bash theme={null}
    curl https://api.waaconnect.com/v1/sessions/VOTRE_SESSION_ID/qrcode \
      -H "x-api-key: wac_xxxxxxxxxxxxxxxx"
    ```

    <Tip>
      Le champ `qrCode` contient une image en base64 (`data:image/png;base64,...`). Affichez-la dans un navigateur ou une balise `<img>` pour la scanner.
    </Tip>
  </Tab>

  <Tab title="Code de pairing">
    Si vous ne pouvez pas scanner un QR code, utilisez un code numérique à 8 chiffres directement depuis WhatsApp.

    **Étape 1 — Demandez un code de pairing** en fournissant votre numéro de téléphone (format international sans `+`) :

    ```bash theme={null}
    curl -X POST https://api.waaconnect.com/v1/sessions/VOTRE_SESSION_ID/pairing-code \
      -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
      -H "Content-Type: application/json" \
      -d '{"phoneNumber": "22997000000"}'
    ```

    ```json Réponse theme={null}
    { "pairingCode": "12345678" }
    ```

    **Étape 2 — Entrez le code dans WhatsApp** :

    1. Ouvrez WhatsApp sur votre téléphone
    2. Allez dans **Paramètres → Appareils connectés → Connecter un appareil**
    3. Appuyez sur **Vous avez un code de connexion ?**
    4. Saisissez le code à 8 chiffres reçu

    <Note>
      Le code de pairing expire après quelques minutes. Relancez la requête si besoin.
    </Note>
  </Tab>
</Tabs>

## 4. Envoyez votre premier message

Une fois la session à l'état `CONNECTED`, envoyez un message texte.

```bash theme={null}
curl -X POST https://api.waaconnect.com/v1/sessions/VOTRE_SESSION_ID/send \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"to": "22997000000", "message": "Bonjour depuis WaaConnect !"}'
```

```json Réponse theme={null}
{ "ok": true, "id": "uuid-message-451" }
```

## Prochaines étapes

<CardGroup cols={2}>
  <Card title="Sessions" icon="mobile" href="/api-reference/sessions">
    Gérez vos connexions WhatsApp
  </Card>

  <Card title="Messages" icon="message" href="/api-reference/messages">
    Médias, interactifs, campagnes
  </Card>

  <Card title="Groupes" icon="users" href="/api-reference/groups">
    Créez et gérez des groupes
  </Card>

  <Card title="Statuts" icon="circle-play" href="/api-reference/status">
    Publiez et planifiez des statuts
  </Card>
</CardGroup>