Ana içeriğe atla
GOWA Mesaj Zamanlayıcısına Genel Bakış Her gönderim isteği, hemen gönderilmek yerine zamanlanabilir. scheduled_at ve timezone ekleyin; GOWA isteği saklar ve bir arka plan işçisi belirtilen zamanda gönderir. Zamanlamalar yeniden başlatmalarda korunur ve çevrimdışı cihazın bağlanmasını bekler. Zamanlanabilen mesaj türleri: metin, görüntü, dosya, video, ses, çıkartma, kişi, bağlantı, konum, anket ve iletme (/message/{id}/forward). Çevrimiçi durum, yazıyor göstergeleri ve deneysel /send/interactive uç noktası zamanlanamaz.

Zamanlama alanları

scheduled_at olmadan istek her zamanki gibi hemen gönderilir.

Örnekler

Zamanlanmış gönderim yanıtları message_id yerine schedule_id içerir.
Yüklenen dosyalar, zamanlama tamamlanana kadar sunucuda tutulur. Multipart gövdelerde weekdays değerini yinelenen alanlar olarak gönderin (-F weekdays=1 -F weekdays=3).

Zamanlamaları yönetme

Zamanlamalar bir cihaza aittir; aynı X-Device-Id değerini gönderin.
Liste, results.data ve results.pagination (limit, varsayılan 25; offset; total) döndürür.

Durumlar

Teslimat davranışı

  • İşçi, zamanı gelen zamanlamaları her 5 saniyede bir kontrol eder.
  • Cihaz çevrimdışı veya oturum açılmamış: çalıştırma bekler ve her 30 saniyede bir yeniden dener. Beklemek başarısız deneme sayılmaz; böylece zamanlama uzun kesintilerde korunur.
  • Gönderim hataları: 15 saniyeden başlayıp 5 dakika ile sınırlanan artan bekleme süreleriyle, her gerçekleşme için en fazla 10 kez yeniden denenir. Ardından tekrarlanan zamanlama bir sonraki gerçekleşmeye geçer; tek seferlik zamanlama failed olur.
  • Geçersiz istek (örneğin hatalı alıcı): yeniden denenmeden hemen başarısız olur.
  • Geciken çalıştırmalar: end_at sonrasına geciken bir gerçekleşme gönderilmez.
  • Çökmeler ve yeniden başlatmalar: kapanma, halihazırda devam eden bir gönderimi iptal etmez. İlk denemeden önce GOWA, ilgili gerçekleşme için bir WhatsApp mesaj kimliğini kalıcı olarak kaydeder. 2 dakikalık sahiplenme süresi dolduktan sonra kesintiye uğrayan gerçekleşme aynı kimlikle yeniden kuyruğa alınır ve deneme sınırına dahil edilir. Anketler de yeniden denemeler arasında şifreleme anahtarını korur. Bu, sonucu belirsiz bir alındı bildiriminden sonra mesaj kimliğini korur, ancak tam olarak bir kez teslimatı garanti etmez.
  • Eski kesintiye uğramış denemeler: sonucu bilinmeyen eski denemelerde temkinli kurtarma uygulanmaya devam eder. İşçi, yeni bir mesaj kimliği atamak yerine tekrarlanan zamanlamada bu gerçekleşmeyi atlar veya tek seferlik zamanlamayı başarısız olarak işaretler.

MCP üzerinden

MCP aracı whatsapp_send aynı zamanlama alanlarını kabul eder; whatsapp_schedule ise zamanlamaları listeler, getirir, duraklatır, sürdürür ve iptal eder. MCP sunucusu bölümüne bakın.
GET /app/info sonucunu kontrol edin: sunucu zamanlama alanlarını kabul edip /send/schedules uç noktasını sunduğunda results.scheduled_sends, true olur.