> ## 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

> Créez et gérez les étiquettes WhatsApp associées aux conversations

Les étiquettes permettent d’organiser les conversations d’un compte WhatsApp connecté. L’API WaChap permet de lister, créer, modifier et supprimer les étiquettes, puis de les appliquer ou de les retirer d’une conversation.

## Endpoints disponibles

| Opération                    | Méthode  | Endpoint                       |
| :--------------------------- | :------- | :----------------------------- |
| Lister les étiquettes        | `GET`    | `/v1/whatsapp/labels`          |
| Créer une étiquette          | `POST`   | `/v1/whatsapp/labels`          |
| Modifier une étiquette       | `PATCH`  | `/v1/whatsapp/labels/:labelId` |
| Supprimer une étiquette      | `DELETE` | `/v1/whatsapp/labels/:labelId` |
| Appliquer à une conversation | `POST`   | `/v1/whatsapp/labels/apply`    |
| Retirer d’une conversation   | `POST`   | `/v1/whatsapp/labels/remove`   |

Toutes les routes nécessitent votre Secret Key dans le header `Authorization` et un `accountId` qui vous appartient.

<Note>
  Les créations et modifications sont synchronisées avec WhatsApp. Le compte doit être connecté. Le champ `color` est un entier transmis à WhatsApp ; sa représentation visuelle peut varier selon le client WhatsApp.
</Note>

## Cibler une conversation

Pour appliquer ou retirer une étiquette, fournissez l’un des champs suivants :

* `conversationJid`, par exemple `2290100000000@s.whatsapp.net` ou un JID de groupe ;
* `phone`, au format international ;
* les alias `chatJid` ou `to` sont également acceptés.

Vous pouvez identifier l’étiquette avec `labelId`. Pour l’application, il est aussi possible d’utiliser `labelName` avec `createIfMissing: true` afin de la créer si elle n’existe pas.

## Erreurs de synchronisation

| Code                       | Statut         | Signification                                                       |
| :------------------------- | :------------- | :------------------------------------------------------------------ |
| `LABEL_NOT_FOUND`          | `404`          | Étiquette absente ou déjà supprimée                                 |
| `APP_STATE_RESET_REQUIRED` | `409`          | L’état synchronisé WhatsApp doit être réparé avec l’aide du support |
| `LIST_LABELS_ERROR`        | `400` ou `409` | La liste n’a pas pu être synchronisée                               |

Lorsque `sync=true`, WaChap peut retourner les données en cache avec un objet `warning` si WhatsApp ne peut pas être synchronisé immédiatement.