Passer au contenu principal
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ôlePermissions
OWNERPropriétaire du canal - contrôle total (publier, gérer admins, supprimer)
ADMINAdministrateur - peut publier et modérer
SUBSCRIBERAbonné - peut uniquement consulter les messages

​
Fonctionnalités disponibles

FonctionnalitéDescriptionStatut
Récupérer la liste des canauxListez tous vos canaux et ceux auxquels vous êtes abonné✅ Disponible
Envoyer un messagePubliez un message dans un canal que vous gérez🚧 À venir

​
Flux de travail typique

​
1. Récupérer vos canaux

POST /api/whatsapp/newsletters/list
{
  "accountId": "account_xxx"
}

​
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)

POST /api/whatsapp/newsletters/send
{
  "accountId": "account_xxx",
  "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 : 
123456789@newsletter
À la différence des :

​
Base URL

https://api.wachap.com/v1/whatsapp/newsletters

​
Authentification

Tous les endpoints nécessitent le header Authorization avec votre clé secrète. 
-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 :