Langsung ke konten utama
Gambaran Umum Penjadwal Pesan GOWA Setiap permintaan pengiriman dapat dijadwalkan. Tambahkan 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

Respons terjadwal memiliki schedule_id sebagai pengganti message_id.
File yang diunggah disimpan di server hingga jadwal selesai. Dalam body multipart, kirim weekdays sebagai kolom berulang (-F weekdays=1 -F weekdays=3).

Mengelola jadwal

Jadwal terikat pada perangkat; kirim X-Device-Id yang sama.
Daftar mengembalikan 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_at tidak 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 MCP whatsapp_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.