Introduction

Toutes les routes nécessitent le header x-api-key.

Vue d’ensemble

WaaConnect vous permet de gérer un carnet d’adresses attaché à votre compte, indépendamment des sessions WhatsApp.

Votre compte
│
├── Contacts ── identifiés par JID (22997000000@s.whatsapp.net)
│   ├── name, email, isBlocked
│   ├── tags: ["vip", "client"]       ← étiquettes libres pour segmenter
│   └── variables: { commande: "…" }  ← variables de personnalisation {commande}
│
└── Groupes de contacts ── listes nommées
    ├── "Clients VIP"  → [contact A, contact B]
    └── "Prospects"    → [contact A, contact C]  ← un contact peut être dans plusieurs groupes

Contacts

Tags

Les tags sont des étiquettes libres posées directement sur chaque contact. Un contact peut en avoir plusieurs.

{ "tags": ["vip", "client", "promo-mai"] }

Usage	Description
Filtrage	`GET /v1/contacts?tag=vip`
Envoi en masse	Voir Envoi en masse — Par tag
Segmentation rapide	Organiser sans créer de groupe

Tag vs Groupe — Le tag est une étiquette sur le contact (modifiable via PATCH /contacts/:jid). Le groupe est une liste séparée avec un nom. Un contact peut appartenir à plusieurs groupes simultanément.

Groupes de contacts

Pour l’envoi en masse par groupe de contacts ou par tag, voir Campagnes & envois groupés.

Variables de personnalisation

Les templates supportent des variables entre accolades simples :

Variable	Remplacement
`{name}`	Nom du contact (numéro si non renseigné)
`{phone}`	Numéro sans `@s.whatsapp.net`
`{clé}`	Valeur de `variables.clé` du contact

Exemple

Bonjour {name}, votre commande {commande} est prête à {ville} !

Avec name: "Aicha" et variables: { commande: "CMD-001", ville: "Cotonou" } :

Bonjour Aicha, votre commande CMD-001 est prête à Cotonou !

Vue d'ensemble

Compte

Sessions

Messages

Campagnes & envois groupés

Contacts & Groupes

Groupes

Statuts

Chaines

Webhooks

Endpoints Rapides

Vue d’ensemble

Contacts

Tags

Groupes de contacts

Variables de personnalisation

​Vue d’ensemble

​Contacts

​Tags

​Groupes de contacts

​Variables de personnalisation

Vue d’ensemble

Contacts

Tags

Groupes de contacts

Variables de personnalisation