Skip to main content
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"
}

{
  "type": "image",
  "url": "https://example.com/status/promo.jpg",
  "caption": "Promo du jour",
  "statusJidList": ["22997000000@s.whatsapp.net"]
}

{
  "type": "video",
  "url": "https://example.com/status/story.mp4",
  "caption": "Teaser produit"
}

{
  "type": "audio",
  "url": "https://example.com/status/voice.mp3",
  "statusJidList": ["22997000000@s.whatsapp.net"]
}
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)"
}