API referansı

Scheduled

İleri tarihli mesaj planlama, listeleme, güncelleme ve iptal.

get/messages/scheduled

Zamanlanmış mesajları listele

Gerekli yetki: messages:read

Sorgu parametreleri

`status`	`string`	Değerler: `pending`, `sent`, `failed`, `cancelled`
`page`	`integer`	Varsayılan: `1`
`limit`	`integer`	Varsayılan: `50`

İstek örneği

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

Yanıt kodları

200Zamanlanmış mesaj listesi

post/messages/schedule

Zamanlanmış mesaj oluştur

`scheduled_at` ISO 8601 biçiminde olmalıdır. Geçersiz tarihte `invalid_date` döner. Başarısız gönderimler `max_retries` kadar yeniden denenir.

Gerekli yetki: messages:send

Gövde alanları

`to`zorunlu	`string`
`message`	`string`
`message_type`	`string`	Varsayılan: `"text"`
`media_url`	`string`
`media_caption`	`string`
`template_id`	`uuid`
`template_variables`	`object`
`scheduled_at`zorunlu	`ISO 8601`
`max_retries`	`integer`	Varsayılan: `3`

İstek örneği

curl -X POST "https://api.zenwapp.com/api/v1/whatsapp/external/messages/schedule" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to":"905551234567","message":"Randevunuz yarın saat 14:00'te.","scheduled_at":"2026-08-01T11:00:00.000Z"}'

Yanıt 400

{
  "error": "validation_error",
  "message": "Missing required field: to"
}

Yanıt kodları

201Zamanlandı
400Gövde veya sorgu parametreleri geçersiz

get/messages/scheduled/{id}

Zamanlanmış mesaj detayı

Gerekli yetki: messages:read

Yol parametreleri

idzorunlu uuid Kaynak kimliği (UUID).

İstek örneği

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

Yanıt 404

{
  "error": "not_found",
  "message": "Resource not found"
}

Yanıt kodları

200Detay
404Kaynak bulunamadı

put/messages/scheduled/{id}

Zamanlanmış mesajı güncelle

Yalnızca henüz gönderilmemiş (`pending`) kayıtlar güncellenebilir.

Gerekli yetki: messages:send

Yol parametreleri

idzorunlu uuid Kaynak kimliği (UUID).

Gövde alanları

`message`	`string`
`scheduled_at`	`ISO 8601`
`max_retries`	`integer`

İstek örneği

curl -X PUT "https://api.zenwapp.com/api/v1/whatsapp/external/messages/scheduled/00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_at":"2026-08-02T09:00:00.000Z"}'

Yanıt 404

{
  "error": "not_found",
  "message": "Resource not found"
}

Yanıt kodları

200Güncellendi
404Kaynak bulunamadı

delete/messages/scheduled/{id}

Zamanlanmış mesajı iptal et

Gerekli yetki: messages:send

Yol parametreleri

idzorunlu uuid Kaynak kimliği (UUID).

İstek örneği

curl -X DELETE "https://api.zenwapp.com/api/v1/whatsapp/external/messages/scheduled/00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer $ZENWAPP_API_KEY"

Yanıt 404

{
  "error": "not_found",
  "message": "Resource not found"
}

Yanıt kodları

200İptal edildi
404Kaynak bulunamadı