Processing and Delivery

Buka di CMS

Plugin Reminder memakai processor latar belakang untuk memeriksa reminder yang tertunda dan mengirimkannya pada waktu terjadwal. Halaman ini menjelaskan cara kerja processor, cara retry ditangani, dan cara memicu atau mengendalikan pengiriman.


Alur Pemrosesan Latar Belakang

Processor dipicu oleh scheduler eksternal yang memanggil:

POST /api/reminder/item/pending/send?secret=YOUR_SCHEDULER_SECRET

Endpoint ini dipanggil secara berkala (misalnya setiap menit oleh cron job atau Azure Function). Setiap pemanggilan:

  1. Mengambil distributed lock Redis untuk mencegah pemrosesan bersamaan di beberapa instance.
  2. Mencari semua reminder item active yang nextSendTime-nya sama dengan atau sebelum waktu saat ini.
  3. Mengelompokkan hasil berdasarkan agentId, configurationId, countryCode, dan phoneNumber.
  4. Memproses setiap kelompok dalam batch paralel (ukuran batch dapat dikonfigurasi).
  5. Melepas lock Redis setelah pemrosesan selesai.

Jika instance lain sedang memegang lock, request yang masuk langsung keluar tanpa memproses apa pun. TTL lock dan interval pembaruannya dapat dikonfigurasi, sehingga lock tidak tertahan selamanya jika sebuah instance processor crash.


Langkah Pengiriman per Reminder

Untuk setiap reminder yang tertunda, processor:

  1. Mengambil konfigurasi dan memeriksa bahwa serverState bernilai running. Jika paused, reminder dilewati.
  2. Memanggil endpoint template notifikasi milik layanan Dialog dengan nomor telepon, kode negara, nama template, dan parameter penerima.
  3. Jika berhasil:
    • Mengisi lastSendTime dengan waktu sekarang.
    • Mengatur ulang lastAttempts menjadi 0.
    • Memajukan nextSendTime ke waktu terjadwal berikutnya di daftar.
    • Jika tidak ada lagi waktu kirim, mengatur status menjadi completed dan mencatat completedDate.
    • Menambahkan entri Sent ke history.
    • Memanggil webhook URL yang dikonfigurasi dengan status terbaru.
  4. Jika gagal:
    • Menambah lastAttempts.
    • Jika lastAttempts mencapai 5, melewati waktu kirim saat ini dan maju ke waktu berikutnya.
    • Menambahkan entri SendFailed atau SendError ke history.

Logika Retry

Setiap waktu kirim di jadwal reminder memperbolehkan hingga lima percobaan pengiriman. Penghitung percobaan (lastAttempts) kembali ke nol setelah setiap pengiriman berhasil atau saat processor maju ke waktu kirim berikutnya.

PercobaanHasil
Gagal ke-1 sampai ke-4Penghitung bertambah. Run processor berikutnya mencoba ulang waktu kirim yang sama.
Gagal ke-5Penghitung diatur ulang. Processor melewati waktu kirim ini dan beralih ke waktu berikutnya di daftar.
Tidak ada lagi waktu kirimStatus reminder tetap active, tetapi tidak ada pengiriman lagi yang dicoba. Tinjau secara manual.

Memicu Pengiriman Secara Manual

Anda dapat memicu pengiriman reminder tertentu saat itu juga, tanpa menunggu waktu terjadwal:

POST /api/reminder/item/send?agentId={agentId}&configurationId={configurationId}&reminderId={reminderId}&secret=YOUR_SCHEDULER_SECRET

Ini menjalankan langkah pengiriman yang sama seperti pemrosesan latar belakang untuk satu reminder item tersebut. Berguna untuk pengujian atau pengiriman ulang yang mendesak.

Validasi sebelum pengiriman manual:

  • Notification key harus sudah diatur di konfigurasi.
  • Reminder harus memiliki nomor telepon dan nama template.
  • URI layanan Dialog milik konfigurasi harus dapat dijangkau.

Server State

Setiap konfigurasi memiliki serverState bernilai running atau paused. Processor memeriksa state ini untuk setiap kelompok sebelum mengirim.

  • Running: reminder dikirim sesuai jadwal.
  • Paused: reminder tetap dalam antrean tetapi tidak dikirim. Tidak ada data yang hilang; pengiriman berlanjut otomatis saat state dikembalikan ke running.

Mengubah server state:

PUT /api/reminder/configuration/{agentId}/{configurationId}/server-state
{
  "serverState": "paused"
}

Semua perubahan state dicatat di audit log. Lihat Plugin Setup untuk detailnya.


Pengiriman ke Layanan Dialog

Processor memanggil endpoint API AutoTrigger milik layanan Dialog untuk mengirim setiap template notifikasi. Request-nya berisi:

  • countryCode dan phoneNumber penerima
  • notificationTemplateName
  • Daftar templateParameters
  • notificationKey dari konfigurasi (header otorisasi)
  • accountCode dari konfigurasi (akun messaging)

Layanan Dialog meneruskan pesan ke channel messaging yang sesuai dan mengembalikan hasil berhasil atau gagal.


Variabel Konfigurasi

VariabelDeskripsiDefault
Plugins_Reminder_BatchSizeJumlah kelompok reminder yang diproses per batch.10
Plugins_Reminder_LockTTLMinutesTime-to-live lock Redis dalam menit.10
Plugins_Reminder_LockRenewalMinutesSeberapa sering lock diperbarui selama pemrosesan, dalam menit.5
DialogServiceUriBase URL layanan Dialog.-

Halaman Terkait