Skip to content

Notification

Menu: Commerce -> Notification
Deep link: /_Admin/commerce/notification?SiteId={siteGuid}

Configure commerce email notifications and webhooks: send email or callback external URLs on events such as order created, payment succeeded. Settings stored in Commerce settings. Bottom Save writes to site (saveSettings); after save, Monaco script cache refreshes (email template editor IntelliSense).

How to Open

  1. In the Edit menu, enable Commerce -> Notification (and the parent Commerce group).
  2. Open Commerce -> Notification in the left sidebar.
Commerce notification: email and webhook configuration areas

Email Notification

Toggle and Delivery Method

ItemDescription
Enable email notificationenableEmailNotification master switch
Mail serverKooboo: platform mail address; Custom: self-hosted SMTP
Kooboo sender addressDropdown of site mail addresses (wildcard addresses excluded)
Custom SMTPClick Set server info to open SMTP settings dialog; after save shows server/port/account summary
EventsConfigured email rule list; see below
LogsCard top-right Logsemail log dialog

Email Event Rules

Each list item shows: event description, event tag (display), Settings (edit), Delete.

Click round + or row Settings to open email notification dialog:

Email notification dialog: event, recipients and template preview/code
FieldDescription
EventDropdown from getEmailEvents() (e.g. order-related events)
Send toCustomer (sendToCustomer); Partners can enter multiple emails (SelectInput)
Preview / CodeAfter selecting event: Preview calls emailPreview for subject/body; Code edits subjectTemplate, bodyTemplate (Monaco HTML + KScript)
Switch eventAuto-loads default subject/body templates for that event

On confirm, writes to settings.emailNotifications list; must click page bottom Save to take effect.

SMTP Settings Dialog

Set server info appears only for Custom mail server.

SMTP settings: server, port, SSL, account and sender
FieldDescription
ServerSMTP host
PortNumber
SSLToggle
Account / PasswordLogin credentials
Sender addressfrom

Save updates settings.customMailServer (still requires page bottom Save).

Email Log Dialog

ColumnDescription
EmailRecipient address
EventTrigger event name
ContentSubject; click to expand details
TimeSend time
StatusSuccess/failure; hover for error on failure
Email log dialog: send records and pagination

Webhook

Toggle and Configuration

ItemDescription
Enable WebhookenableWebhook
WebhooksRule list; ? next to tag shows webhookSecret and signature verification: SHA256Hash(request.body+secret) == request.header["X-Kooboo-Hmac-SHA256"]
LogsCard top-right LogsWebhook log dialog

Click + or row Settings to open Webhook dialog:

Webhook dialog: event and URL
FieldDescription
EventEvent from getWebhookEvents()
URLCallback address; must pass URL validation

Webhook Log Dialog

ColumnDescription
URLCallback URL (row.address)
EventTrigger event name (row.event; matches configured webhook event)
ContentRequest body summary; click for full content (JsonTree)
TimeCall time
StatusSuccess/failure; hover for error on failure
Webhook log dialog
  • Orders — common trigger source (order placed, paid, etc.)
  • Settings — other Commerce global items
  • k.mail — site mail capability; Kooboo sender depends on mail address configuration