Processing and Delivery
Buka di CMSPlugin 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:
- Mengambil distributed lock Redis untuk mencegah pemrosesan bersamaan di beberapa instance.
- Mencari semua reminder item
activeyangnextSendTime-nya sama dengan atau sebelum waktu saat ini. - Mengelompokkan hasil berdasarkan
agentId,configurationId,countryCode, danphoneNumber. - Memproses setiap kelompok dalam batch paralel (ukuran batch dapat dikonfigurasi).
- 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:
- Mengambil konfigurasi dan memeriksa bahwa
serverStatebernilairunning. Jikapaused, reminder dilewati. - Memanggil endpoint template notifikasi milik layanan Dialog dengan nomor telepon, kode negara, nama template, dan parameter penerima.
- Jika berhasil:
- Mengisi
lastSendTimedengan waktu sekarang. - Mengatur ulang
lastAttemptsmenjadi 0. - Memajukan
nextSendTimeke waktu terjadwal berikutnya di daftar. - Jika tidak ada lagi waktu kirim, mengatur
statusmenjadicompleteddan mencatatcompletedDate. - Menambahkan entri
Sentke history. - Memanggil webhook URL yang dikonfigurasi dengan status terbaru.
- Mengisi
- Jika gagal:
- Menambah
lastAttempts. - Jika
lastAttemptsmencapai 5, melewati waktu kirim saat ini dan maju ke waktu berikutnya. - Menambahkan entri
SendFailedatauSendErrorke history.
- Menambah
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.
| Percobaan | Hasil |
|---|---|
| Gagal ke-1 sampai ke-4 | Penghitung bertambah. Run processor berikutnya mencoba ulang waktu kirim yang sama. |
| Gagal ke-5 | Penghitung diatur ulang. Processor melewati waktu kirim ini dan beralih ke waktu berikutnya di daftar. |
| Tidak ada lagi waktu kirim | Status 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:
countryCodedanphoneNumberpenerimanotificationTemplateName- Daftar
templateParameters notificationKeydari konfigurasi (header otorisasi)accountCodedari konfigurasi (akun messaging)
Layanan Dialog meneruskan pesan ke channel messaging yang sesuai dan mengembalikan hasil berhasil atau gagal.
Variabel Konfigurasi
| Variabel | Deskripsi | Default |
|---|---|---|
Plugins_Reminder_BatchSize | Jumlah kelompok reminder yang diproses per batch. | 10 |
Plugins_Reminder_LockTTLMinutes | Time-to-live lock Redis dalam menit. | 10 |
Plugins_Reminder_LockRenewalMinutes | Seberapa sering lock diperbarui selama pemrosesan, dalam menit. | 5 |
DialogServiceUri | Base URL layanan Dialog. | - |
Halaman Terkait
- Plugin Setup: server state dan kredensial.
- Create Reminder Items: field dan siklus status.
- Webhook Notifications: callback yang dipanggil setelah setiap pengiriman.
- Reminder Overview