> ## 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 Canaux WhatsApp (aussi appelés Newsletters) sont une fonctionnalité qui permet de diffuser des messages à un large public de manière unidirectionnelle.

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

Un canal WhatsApp est un outil de diffusion qui permet à :

* **Créateurs et organisations** de partager des mises à jour avec leurs abonnés
* **Abonnés** de recevoir des messages sans pouvoir répondre directement
* **Propriétaires et administrateurs** de gérer le contenu et les paramètres

## Caractéristiques des canaux

### 📢 Communication unidirectionnelle

Seuls les propriétaires et administrateurs peuvent publier des messages. Les abonnés reçoivent les messages mais ne peuvent pas répondre dans le canal.

### 🔒 Confidentialité

Les abonnés ne peuvent pas voir qui sont les autres membres du canal, garantissant ainsi leur confidentialité.

### 📊 Statistiques

Les créateurs peuvent voir combien de personnes ont vu leurs messages et suivent leur canal.

### 🎯 Portée illimitée

Un canal peut avoir un nombre illimité d'abonnés.

## Rôles dans un canal

| Rôle         | Permissions                                                               |
| :----------- | :------------------------------------------------------------------------ |
| `OWNER`      | Propriétaire du canal - contrôle total (publier, gérer admins, supprimer) |
| `ADMIN`      | Administrateur - peut publier et modérer                                  |
| `SUBSCRIBER` | Abonné - peut uniquement consulter les messages                           |

## Fonctionnalités disponibles

| Fonctionnalité                    | Description                                              | Statut       |
| :-------------------------------- | :------------------------------------------------------- | :----------- |
| **Récupérer la liste des canaux** | Listez tous vos canaux et ceux auxquels vous êtes abonné | ✅ Disponible |
| **Envoyer un message**            | Publiez un message dans un canal que vous gérez          | 🚧 À venir   |

## Flux de travail typique

### 1. Récupérer vos canaux

```bash theme={null}
POST /api/whatsapp/newsletters/list
{
  "accountId": "a1233b-a1233b-a1233b-a1233b-a1233bcdjdg9878"
}
```

### 2. Identifier votre rôle

La réponse indique votre rôle pour chaque canal :

* `OWNER` : Vous pouvez tout gérer
* `ADMIN` : Vous pouvez publier
* `SUBSCRIBER` : Vous pouvez uniquement consulter

### 3. Publier un message (si OWNER ou ADMIN)

```bash theme={null}
POST /api/whatsapp/newsletters/send
{
  "accountId": "a1233b-a1233b-a1233b-a1233b-a1233bcdjdg9878",
  "newsletterJid": "123456789@newsletter",
  "type": "text",
  "content": "Nouvelle mise à jour !"
}
```

## Format d'un JID de canal

Les canaux ont un identifiant unique (JID) qui se termine par `@newsletter` :

```text theme={null}
123456789@newsletter
```

À la différence des :

* Contacts personnels : `33612345678@s.whatsapp.net`
* Groupes : `120363123456789012@g.us`

## Base URL

```text theme={null}
https://api.wachap.com/v1/whatsapp/newsletters
```

## Authentification

Tous les endpoints nécessitent le header Authorization avec votre clé secrète.

```bash theme={null}
-H "Authorization: Bearer sk_votre_cle_secrete"
```

## Limites et restrictions

* Vous devez être `OWNER` ou `ADMIN` pour publier des messages
* Les canaux ne peuvent pas être créés via l'API (créez-les depuis WhatsApp)
* Les abonnés ne peuvent pas être ajoutés/retirés via l'API
* Seuls les canaux auxquels vous êtes abonné ou que vous gérez sont visibles

## Cas d'usage

### 📰 Média et actualités

Diffusez des articles, des breaking news, et des mises à jour à vos lecteurs.

### 🏢 Entreprises

Communiquez les annonces internes, les mises à jour produits, ou les promotions.

### 🎓 Éducation

Partagez des ressources pédagogiques, des annonces de cours, ou des actualités éducatives.

### 🎵 Créateurs de contenu

Informez vos fans de nouvelles sorties, événements, ou contenus exclusifs.

## Prochaines étapes

Explorez les endpoints disponibles pour commencer à utiliser les canaux :

* [Récupérer la liste de vos canaux →](/fr/channels/list)
* [Envoyer un message dans un canal →](/fr/channels/send-message)