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

# Introduction

L'API Statuts vous permet de publier et gérer des statuts (stories) WhatsApp depuis vos comptes connectés.

## Qu'est-ce qu'un statut WhatsApp ?

Les statuts WhatsApp sont des publications temporaires qui :

* Disparaissent après 24h automatiquement
* Peuvent contenir du texte, des images ou des vidéos
* Sont visibles par vos contacts selon vos paramètres de confidentialité
* Permettent de partager des moments ou des informations importantes

## Fonctionnalités disponibles

### 📤 Publier un statut

Publiez du contenu texte, image ou vidéo sur votre statut WhatsApp.

[Publier un statut →](/fr/status/post)

### 🔒 Gérer la confidentialité

Contrôlez qui peut voir vos statuts : tous vos contacts, certains uniquement, ou personne.

* [Consulter les paramètres →](/fr/status/get-privacy)
* [Définir la confidentialité →](/fr/status/set-privacy)

## Cas d'usage

### Marketing & Communication

* Partager des offres promotionnelles limitées dans le temps
* Annoncer des événements ou nouveautés
* Créer de l'engagement avec votre audience

### Business

* Partager des actualités de l'entreprise
* Publier du contenu exclusif pour vos clients
* Maintenir une présence régulière auprès de vos contacts

### Automatisation

* Programmer des publications via API
* Publier du contenu sur plusieurs comptes simultanément
* Intégrer avec vos systèmes existants

## Types de contenu supportés

| Type      | Description                          | Formats                 |
| :-------- | :----------------------------------- | :---------------------- |
| **Texte** | Messages texte avec personnalisation | Police, couleur de fond |
| **Image** | Photos avec légende optionnelle      | JPG, PNG (\~5MB max)    |
| **Vidéo** | Vidéos courtes avec légende          | MP4 (\~16MB max)        |

## Paramètres de confidentialité

| Mode              | Visibilité                 |
| :---------------- | :------------------------- |
| `all`             | Tous vos contacts          |
| `contacts`        | Tous vos contacts (défaut) |
| `contacts_except` | Contacts sauf liste noire  |
| `none`            | Personne (privé)           |

## Limites et restrictions

* **Durée** : 24h maximum (automatique WhatsApp)
* **Fréquence** : Pas de limite API, mais éviter le spam
* **Taille** : Images \~5MB, Vidéos \~16MB
* **Formats** : JPG, PNG pour images / MP4 pour vidéos

## Différence avec les messages

| Critère           | Statuts                  | Messages normaux          |
| :---------------- | :----------------------- | :------------------------ |
| **Durée de vie**  | 24h                      | Permanent                 |
| **Destinataires** | Contacts (configurables) | Destinataires spécifiques |
| **Réponses**      | Privées uniquement       | Conversation normale      |
| **Visibilité**    | Broadcast public         | Privé 1-à-1 ou groupe     |

## Exemples rapides

### Publier un statut texte

```bash theme={null}
POST /api/whatsapp/status/post
{
  "accountId": "a1233b-a1233b-a1233b-a1233b-a1233bcdjdg9878",
  "type": "text",
  "content": "Nouvelle promotion ! -20% aujourd'hui"
}
```

### Publier une image

```bash theme={null}
POST /api/whatsapp/status/post
{
  "accountId": "a1233b-a1233b-a1233b-a1233b-a1233bcdjdg9878",
  "type": "image",
  "imageUrl": "https://example.com/promo.jpg",
  "caption": "Découvrez notre nouvelle collection !"
}
```

### Définir la confidentialité

```bash theme={null}
PUT /api/whatsapp/status/privacy
{
  "accountId": "a1233b-a1233b-a1233b-a1233b-a1233bcdjdg9878",
  "privacyType": "contacts"
}
```

## Notes importantes

* Les statuts sont publiés depuis le compte WhatsApp connecté
* La confidentialité est configurée au niveau du compte WhatsApp
* Les listes de contacts proviennent de l'application WhatsApp
* Vous ne pouvez pas voir qui a vu votre statut via l'API (fonctionnalité WhatsApp uniquement)