Toutes les routes utilisent le header x-api-key.

Publier un statut

POST /v1/sessions/:sessionId/status/send Publie un statut WhatsApp immédiatement.
Une réponse avec accepted: true signifie que WhatsApp Web a accepté la publication. La diffusion effective peut prendre quelques secondes.
type
string
required
Type de statut : text, image, video, audio
text
string
Texte du statut (requis si type: text)
url
string
URL publique du média (requis si type ≠ text)
caption
string
Légende du média (image ou vidéo)
backgroundColor
string
Couleur de fond hex pour les statuts texte (ex : #111B21)
statusJidList
array
Liste de JIDs ciblés pour la diffusion
audience
string
all_contacts pour diffuser à tous vos contacts
{
  "type": "text",
  "text": "Annonce du jour : ouverture exceptionnelle à 19h.",
  "backgroundColor": "#111B21"
}
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/status/send \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"type": "text", "text": "Annonce du jour : ouverture exceptionnelle à 19h.", "backgroundColor": "#111B21"}'
Réponse 200
{
  "ok": true,
  "accepted": true,
  "validation": "payload_validated",
  "deliveryState": "accepted_by_whatsapp_web",
  "type": "image",
  "target": "status@broadcast",
  "recipientsCount": 1,
  "statusJidList": ["22997000000@s.whatsapp.net"],
  "messageId": "3EB0B430B438B4F26B29"
}

Programmer

POST /v1/sessions/:sessionId/status/schedule Programme la publication d’un statut en one-shot après un délai.
payload
object
required
Même structure que le corps de /status/send
delayMs
number
required
Délai avant publication en millisecondes
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/status/schedule \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {"type": "text", "text": "Status dans 5 minutes"},
    "delayMs": 300000
  }'
Réponse 200
{ "ok": true, "scheduledInMs": 300000 }

Récurrent

POST /v1/sessions/:sessionId/status/recurring Programme la publication automatique d’un statut à intervalles réguliers.
payload
object
required
Même structure que le corps de /status/send
everyMs
number
required
Intervalle de répétition en millisecondes (ex : 86400000 pour 24h)
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/status/recurring \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {"type": "text", "text": "Rappel quotidien"},
    "everyMs": 86400000
  }'
Réponse 200
{
  "ok": true,
  "recurringEveryMs": 86400000,
  "timerId": "Timeout(12)"
}