Sessions WhatsApp

Une session représente une connexion WhatsApp liée à un numéro de téléphone. Chaque session dispose d’un sessionId (UUID) utilisé dans toutes les requêtes. Voir aussi : Lister et Déconnecter, en pages séparées.

Créer

POST /v1/sessions Crée une nouvelle session WhatsApp.

string

required

Nom de la session

cURL

curl -X POST https://api.waaconnect.com/v1/sessions \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "Support Team Session"}'

Réponse 201

{
  "id": "uuid-session-12",
  "sessionName": "Support Team Session",
  "status": "DISCONNECTED",
  "qrCode": null,
  "phone": null,
  "lastError": null,
  "lastSeen": null
}

Détails

GET /v1/sessions/:sessionId Retourne les détails d’une session spécifique.

string

required

UUID de la session

cURL

curl https://api.waaconnect.com/v1/sessions/uuid-session-12 \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

Modifier

PATCH /v1/sessions/:sessionId Modifie le nom d’une session.

string

required

UUID de la session

string

Nouveau nom de la session

cURL

curl -X PATCH https://api.waaconnect.com/v1/sessions/uuid-session-12 \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"sessionName": "Sales Session Benin"}'

Supprimer

DELETE /v1/sessions/:sessionId Supprime définitivement une session et ses données d’authentification.

string

required

UUID de la session

cURL

curl -X DELETE https://api.waaconnect.com/v1/sessions/uuid-session-12 \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

Statut

GET /v1/sessions/:sessionId/status Récupère le statut de connexion en temps réel (non mis en cache). Valeurs possibles de status

Valeur	Description
`DISCONNECTED`	Session déconnectée
`CONNECTING`	Connexion en cours
`QR_READY`	QR code disponible, en attente de scan
`CONNECTED`	Session connectée et active
`PAUSED`	Session en pause manuelle

cURL

curl https://api.waaconnect.com/v1/sessions/uuid-session-12/status \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

Réponse 200

{
  "id": "uuid-session-12",
  "sessionName": "Support Team Session",
  "status": "CONNECTED",
  "qrCode": null,
  "phone": "22997000000@s.whatsapp.net",
  "lastError": null,
  "lastSeen": "2026-03-26T15:20:26.000Z"
}

Changer le statut

PATCH /v1/sessions/:sessionId/status Change manuellement le statut d’une session.

string

required

Statut à appliquer : CONNECTED, DISCONNECTED, CONNECTING, PAUSED

cURL

curl -X PATCH https://api.waaconnect.com/v1/sessions/uuid-session-12/status \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"status": "PAUSED"}'

QR code

GET /v1/sessions/:sessionId/qrcode Récupère le QR code de connexion en base64.

Appelez d’abord POST /sessions/:sessionId/connect pour générer le QR code.

cURL

curl https://api.waaconnect.com/v1/sessions/uuid-session-12/qrcode \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

Réponse 200

{
  "sessionId": "uuid-session-12",
  "status": "QR_READY",
  "qrCode": "data:image/png;base64,iVBORw0KGgo...",
  "hasQrCode": true
}

Connecter

POST /v1/sessions/:sessionId/connect Lance la connexion WhatsApp de la session. Génère un QR code à scanner ou reconnecte automatiquement si des credentials existent.

cURL

curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/connect \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

Réponse 200

{
  "id": "uuid-session-12",
  "sessionName": "Support Team Session",
  "status": "CONNECTING",
  "qrCode": null,
  "phone": null,
  "lastError": null,
  "lastSeen": null
}

Code de pairing

POST /v1/sessions/:sessionId/pairing-code Génère un code de pairing à 8 chiffres (alternative au QR code).

string

required

Numéro de téléphone sans + ni espaces

cURL

curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/pairing-code \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "22997000000"}'

Réponse 200

{
  "pairingCode": "ABCD-1234"
}

Vue d'ensemble

Compte

Sessions

Messages

Campagnes & envois groupés

Contacts & Groupes

Groupes

Statuts

Chaines

Webhooks

Endpoints Rapides

Créer

Détails

Modifier

Supprimer

Statut

Changer le statut

QR code

Connecter

Code de pairing

​Créer

​Détails

​Modifier

​Supprimer

​Statut

​Changer le statut

​QR code

​Connecter

​Code de pairing

Créer

Détails

Modifier

Supprimer

Statut

Changer le statut

QR code

Connecter

Code de pairing