
scheduled_at dan timezone; GOWA menyimpan permintaan tersebut, lalu worker latar belakang mengirimkannya pada waktu yang ditentukan. Jadwal tetap tersimpan setelah server dimulai ulang dan menunggu jika perangkat sedang offline.
Jenis pesan yang dapat dijadwalkan: teks, gambar, file, video, audio, stiker, kontak, tautan, lokasi, polling, dan penerusan (/message/{id}/forward). Status kehadiran, indikator mengetik, dan endpoint eksperimental /send/interactive tidak dapat dijadwalkan.
Kolom jadwal
Tanpa
scheduled_at, permintaan langsung dikirim seperti biasa.
Contoh
schedule_id sebagai pengganti message_id.
weekdays sebagai kolom berulang (-F weekdays=1 -F weekdays=3).
Mengelola jadwal
Jadwal terikat pada perangkat; kirimX-Device-Id yang sama.
results.data dan results.pagination (limit, default 25; offset; total).
Status
Perilaku pengiriman
- Worker memeriksa jadwal yang sudah waktunya dijalankan setiap 5 detik.
- Perangkat offline atau belum login: eksekusi menunggu dan mencoba lagi setiap 30 detik. Menunggu tidak dihitung sebagai percobaan gagal, sehingga jadwal tetap berlaku meskipun koneksi terputus lama.
- Kesalahan pengiriman: dicoba ulang dengan jeda bertahap mulai dari 15 detik hingga maksimum 5 menit, maksimal 10 percobaan per pengiriman terjadwal. Jadwal berulang kemudian melewati pengiriman tersebut dan beralih ke pengiriman berikutnya; jadwal sekali kirim menjadi
failed. - Permintaan tidak valid (misalnya penerima yang salah): langsung gagal tanpa percobaan ulang.
- Eksekusi terlambat: pengiriman yang tertunda hingga melewati
end_attidak dikirim. - Crash dan mulai ulang: penghentian server tidak membatalkan pengiriman yang sedang berlangsung. Sebelum percobaan pertama, GOWA menyimpan ID pesan WhatsApp untuk pengiriman tersebut. Setelah masa klaim 2 menit berakhir, pengiriman yang terputus dimasukkan kembali ke antrean dengan ID yang sama dan dihitung dalam batas percobaan. Polling juga mempertahankan kunci rahasia enkripsinya pada percobaan ulang. Ini menjaga identitas pesan saat konfirmasi penerimaan tidak pasti, tetapi tidak menjamin pesan terkirim tepat satu kali.
- Percobaan lama yang terputus: percobaan dari versi lama dengan hasil yang tidak diketahui tetap dipulihkan secara konservatif. Worker melewati pengiriman tersebut untuk jadwal berulang atau menggagalkan jadwal sekali kirim, alih-alih memberikan identitas pesan baru.
Melalui MCP
Tool MCPwhatsapp_send menerima kolom jadwal yang sama, sedangkan whatsapp_schedule dapat menampilkan daftar, mengambil, menjeda, melanjutkan, dan membatalkan jadwal. Lihat Server MCP.
Periksa
GET /app/info: results.scheduled_sends bernilai true jika server menerima kolom jadwal dan menyediakan /send/schedules.