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

Les **Listes de contacts** vous permettent d'organiser et de gérer vos contacts de manière efficace pour vos campagnes WhatsApp.

### Qu'est-ce qu'une liste de contacts ?

Une liste de contacts est une collection de contacts que vous pouvez :

* **Créer manuellement** via JSON ou importer depuis un fichier CSV
* **Réutiliser** dans plusieurs campagnes
* **Mettre à jour** et gérer facilement
* **Dupliquer** pour créer des variantes

### Avantages des listes de contacts

<CardGroup cols={2}>
  <Card title="Réutilisabilité" icon="recycle">
    Créez une liste une fois et utilisez-la dans plusieurs campagnes. Plus besoin d'importer les mêmes contacts à chaque fois.
  </Card>

  <Card title="Organisation" icon="folder-tree">
    Organisez vos contacts par catégories : clients VIP, prospects, clients inactifs, etc.
  </Card>

  <Card title="Mises à jour faciles" icon="arrows-rotate">
    Ajoutez ou supprimez des contacts d'une liste sans affecter les campagnes déjà lancées.
  </Card>

  <Card title="uGain de temps" icon="clock">
    Importez des milliers de contacts via CSV et réutilisez-les instantanément.
  </Card>
</CardGroup>

### Flux de travail typique

1. **Création d'une liste**
   ```bash theme={null}
   POST /contact-groups/create
   { "name": "Clients Premium", "csvUrl": "..." }
   ```

2. **Vérification de l'import**
   ```bash theme={null}
   GET /contact-groups/:id
   # Status: "importing" → "ready"
   ```

3. **Consultation des contacts**
   ```bash theme={null}
   GET /contact-groups/:id/contacts?limit=50&offset=0
   ```

4. **Utilisation dans une campagne**
   ```bash theme={null}
   POST /campaigns/create
   { "listId": "65f1234567890abcdef12345", ... }
   ```