Ces routes sont préfixées par /whatsapp et utilisent le header x-api-key. Elles sont idéales pour les intégrations no-code ou les plateformes qui ne supportent pas les paramètres d’URL dynamiques.

Statut

GET /v1/whatsapp/status Récupère le statut d’une session via query string.
sessionId
string
required
UUID de la session
cURL
curl "https://api.waaconnect.com/v1/whatsapp/status?sessionId=uuid-session-12" \
  -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"
}

Connecter

POST /v1/whatsapp/connect Lance la connexion d’une session.
sessionId
string
required
UUID de la session à connecter
cURL
curl -X POST https://api.waaconnect.com/v1/whatsapp/connect \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"sessionId": "uuid-session-12"}'
Réponse 200 — Statut de la session mis à jour (CONNECTING).

Déconnecter

POST /v1/whatsapp/disconnect Déconnecte une session.
sessionId
string
required
UUID de la session à déconnecter
cURL
curl -X POST https://api.waaconnect.com/v1/whatsapp/disconnect \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"sessionId": "uuid-session-12"}'
Réponse 200
{
  "id": "uuid-session-12",
  "sessionName": "Support Team Session",
  "status": "DISCONNECTED",
  "qrCode": null,
  "phone": "22997000000@s.whatsapp.net",
  "lastError": "Manual disconnect",
  "lastSeen": "2026-05-09T09:56:56.058Z"
}

Envoyer

POST /v1/whatsapp/send Envoie un message texte avec le sessionId dans le corps.
sessionId
string
required
UUID de la session
to
string
required
Numéro de téléphone (sans +) ou JID complet
message
string
required
Texte du message
cURL
curl -X POST https://api.waaconnect.com/v1/whatsapp/send \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "uuid-session-12",
    "to": "22997000000",
    "message": "Bonjour depuis l'\''API rapide"
  }'
Réponse 200
{ "ok": true, "id": "uuid-message-451" }