Docs/Using Plugins/Manage Reminders

Manage Reminders

The management view gives you visibility into all reminder items across a configuration. Use it to monitor delivery status, inspect individual reminders, and perform bulk operations.

Navigate to Actions → Plugins, open the Reminder plugin, and go to the Management section.


Dashboard Statistics

The dashboard shows a summary of all reminders for the current configuration:

MetricDescription
Total RemindersTotal number of reminder items created.
ActiveReminders scheduled and awaiting delivery.
PendingReminders whose next send time has arrived but not yet been processed.
CompletedReminders where all send times have been successfully delivered.
CancelledReminders that were manually or programmatically cancelled.
RecentReminders created in the last 7 days.

Reminder List View

The list displays all reminders with key details:

ColumnDescription
PhoneCountry code and phone number of the recipient.
Recipient NameOptional display name.
TemplateThe notification template name used.
StatusCurrent status: active, completed, expired, or cancelled.
Next Send TimeThe next scheduled delivery time (UTC).
Last AttemptsNumber of failed attempts for the current send time.
CreatedWhen the reminder was created.

Filtering the List

Use the following filters to narrow the list:

FilterDescription
StatusShow only reminders with a specific status.
Phone NumberSearch by recipient phone number.
Date FromShow reminders created on or after this date.
Date ToShow reminders created on or before this date.
Page SizeNumber of items per page.
SkipOffset for pagination.

Viewing a Reminder

Open any reminder to see its full detail including:

  • All scheduled send times and the current nextSendTime
  • Complete delivery history with timestamps and action details
  • Template parameters and timezone

The History section is the primary tool for diagnosing delivery issues. Each entry shows:

FieldDescription
dateUTC timestamp of the action.
actionOne of Created, Sent, SendFailed, SendError.
detailA description of what happened.
statusThe reminder's status after this action.

Bulk Operations

Select multiple reminders in the list to perform operations on them at once.

Bulk Delete

Permanently removes all selected reminder items. This action cannot be undone.

POST /api/reminder/item/bulk-delete
{
  "reminderIds": ["rem-001", "rem-002", "rem-003"]
}

Bulk Status Update

Changes the status of all selected reminders to a new value.

POST /api/reminder/item/bulk-status
{
  "reminderIds": ["rem-001", "rem-002"],
  "newStatus": "cancelled"
}

Valid target statuses: active, completed, expired, cancelled.

The response includes a count of successful and failed updates, and a list of any errors:

{
  "successCount": 2,
  "failureCount": 0,
  "errors": [],
  "message": "Bulk status update completed"
}

Management API Endpoint

For server-side or admin-tool access, the management list is also available via API:

GET /api/reminder/management/list?status=active&userId=81234567890&dateFrom=2025-06-01&dateTo=2025-06-30&pageSize=50&skip=0
GET /api/reminder/management/dashboard-stats

These endpoints are intended for admin interfaces and reporting tools, not for the Integration API used by external systems.