İçeriğe geç
ZZenWapp Docs

API referansı

Messages

Metin mesajı gönderimi, kuyruk ve hız limiti durumu, içerik doğrulama.

post/messages/send

Metin mesajı gönder

Varsayılan olarak asenkron çalışır: mesaj kuyruğa alınır ve `202 Accepted` döner. Teslimat durumunu webhook üzerinden takip edin. `sync: true` ile yanıtı gönderim tamamlanana kadar bekletebilirsiniz — bu mod zaman aşımına (504) açıktır, toplu işlerde kullanmayın.

Gerekli yetki: messages:send

Gövde alanları

tozorunlustringAlıcı telefon numarası (ülke kodlu) veya sohbet kimliği.
messagezorunlustringMesaj metni.
typestringDeğerler: textVarsayılan: "text"
priorityintegerKuyruk önceliği. Küçük değer daha önce gönderilir (1 = en yüksek).Varsayılan: 3
syncbooleantrue ise gönderim tamamlanana kadar bekler ve 200 döner.Varsayılan: false

İstek örneği

curl -X POST "https://api.zenwapp.com/api/v1/whatsapp/external/messages/send" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"905551234567","message":"Merhaba, siparişiniz kargoya verildi."}'

Yanıt 202

{
  "success": true,
  "queued": true,
  "job_id": "wa:send:8f21c0",
  "to": "[email protected]"
}

Yanıt kodları

  • 202Mesaj kuyruğa alındı
  • 400Gövde veya sorgu parametreleri geçersiz
  • 429Hız limiti aşıldı. `X-RateLimit-Reset` başlığındaki ana kadar bekleyin.
  • 504`sync: true` modunda gönderim zaman aşımına uğradı. Mesaj yine de teslim edilmiş olabilir — webhook ile doğrulayın.
get/messages/rate-limit

Hız limiti durumu

Hesabın anlık gönderim limiti ve kalan kotasını döndürür.

Gerekli yetki: messages:read

İstek örneği

curl -X GET "https://api.zenwapp.com/api/v1/whatsapp/external/messages/rate-limit" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY"

Yanıt 200

{
  "success": true,
  "data": {
    "limit": 30,
    "remaining": 24,
    "window": "1m",
    "reset_at": "2026-07-30T09:13:00.000Z"
  }
}

Yanıt kodları

  • 200Limit durumu
get/messages/queue

Kuyruk durumu

Bekleyen, işlenen ve başarısız iş sayılarını döndürür. Toplu gönderim sırasında ilerlemeyi izlemek için kullanın.

Gerekli yetki: messages:read

İstek örneği

curl -X GET "https://api.zenwapp.com/api/v1/whatsapp/external/messages/queue" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY"

Yanıt 200

{
  "success": true,
  "data": {
    "waiting": 12,
    "active": 1,
    "failed": 0,
    "delayed": 3
  }
}

Yanıt kodları

  • 200Kuyruk durumu
post/messages/validate

Mesaj içeriğini doğrula

Mesajı göndermeden önce içerik politikası ve uzunluk kontrolünden geçirir. Toplu gönderim öncesi ön kontrol için kullanışlıdır.

Gerekli yetki: messages:read

Gövde alanları

messagezorunlustring

İstek örneği

curl -X POST "https://api.zenwapp.com/api/v1/whatsapp/external/messages/validate" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"Kampanya metni burada"}'

Yanıt 200

{
  "success": true,
  "valid": true,
  "warnings": []
}

Yanıt kodları

  • 200Doğrulama sonucu
  • 400Gövde veya sorgu parametreleri geçersiz