Skip to content

Notification Center ​

Updated: 2026-03-28

The Dujiao-Next Notification Center supports automatic admin notifications via Email and Telegram when key business events occur.


1. Feature Overview ​

FeatureDescription
Multi-channel notificationsSupports Email and Telegram notification channels
Event-drivenOrder payment, recharge success, pending delivery reminders, exception alerts, etc.
Custom templatesEach event type supports custom notification title and content
Multi-languageTemplates support Simplified Chinese, Traditional Chinese, and English
DeduplicationPrevents duplicate notifications for the same event within a short time window
Low-stock alertsAutomatically detects low product inventory and sends alerts

2. Configuration Entry ​

Admin Panel > Settings > Notification Center


3. Notification Channels ​

3.1 Email Notifications ​

FieldDescription
EnabledToggle for email notifications
Recipient listEmail addresses to receive notifications (multiple supported)

Email notifications depend on SMTP configuration. Please complete the mail server setup in Admin Panel > Settings > SMTP Email first.

3.2 Telegram Notifications ​

FieldDescription
EnabledToggle for Telegram notifications
Chat ID listTelegram Chat IDs to receive notifications (multiple supported)

A Telegram Bot Token must be configured in the system. You can use the Bot Token from Admin Panel > Settings > Telegram Login, or the channel client Token from the Telegram Bot service.

How to get your Chat ID:

  1. Send a message to your Bot
  2. Visit https://api.telegram.org/bot{YOUR_BOT_TOKEN}/getUpdates
  3. Find the chat.id field in the response

4. Notification Events ​

4.1 Event Types ​

EventIdentifierDescription
Wallet recharge successwallet_recharge_successNotifies when a user completes a wallet recharge
Order payment successorder_paid_successNotifies when a user completes an order payment
Manual fulfillment pendingmanual_fulfillment_pendingAlerts admin when a manual-delivery order is paid
Exception alertexception_alertLow stock, order backlog, and other anomalies

Each event can be enabled or disabled independently.

4.2 Exception Alert Details ​

The system periodically checks the following metrics and triggers alerts when thresholds are exceeded:

Alert TypeDescription
Product sold outA product has 0 available stock
Low stockProduct stock is below the warning threshold
Pending payment backlogAbnormal number of pending-payment orders
Payment failuresAbnormal number of payment failures

Alert notifications include the list of affected products and specific data.


5. Custom Templates ​

Each notification event supports template customization in three languages (Simplified Chinese / Traditional Chinese / English).

5.1 Template Fields ​

Each template contains:

  • Title: The notification title/subject
  • Content: The detailed notification body

5.2 Template Variables ​

Use {{variable_name}} in templates to insert dynamic data:

Wallet recharge success:

VariableDescription
{{customer_label}}Customer name and email
{{customer_email}}Customer email
{{recharge_no}}Recharge order number
{{amount}}Recharge amount
{{currency}}Currency
{{payment_channel}}Payment channel

Order payment success:

VariableDescription
{{customer_label}}Customer name and email
{{customer_email}}Customer email
{{order_no}}Order number
{{amount}}Order amount
{{currency}}Currency
{{payment_channel}}Payment channel
{{items_summary}}Product list (with SKU details)
{{fulfillment_items_summary}}Products pending manual fulfillment
{{delivery_summary}}Delivery method summary

Manual fulfillment pending:

VariableDescription
{{customer_label}}Customer name and email
{{customer_email}}Customer email
{{order_no}}Order number
{{order_status}}Current order status
{{fulfillment_items_summary}}Products pending fulfillment
{{delivery_summary}}Delivery information

Exception alert:

VariableDescription
{{alert_type}}Alert type
{{alert_level}}Alert level (error / warning)
{{alert_value}}Current value
{{alert_threshold}}Threshold
{{message}}Alert message
{{affected_items_summary}}Affected product details
{{affected_items_count}}Number of affected items

6. Advanced Settings ​

FieldDefaultDescription
Default languagezh-CNDefault language for notification templates
Deduplication interval300 secondsSame event will not be sent again within this window (30--86400 seconds)
Low-stock alert interval1800 secondsMinimum interval between low-stock alerts (60--604800 seconds)
Ignored productsNoneProduct IDs excluded from low-stock alert checks

7. Notification Logs ​

Notification delivery history is available in the admin panel, including:

  • Event type
  • Delivery channel (Email / Telegram)
  • Delivery status (Success / Failed)
  • Delivery time

A test notification can be sent to verify that the configuration is correct.

Released under the GPLv3 License.