To activate this feature, you must have a Head Office. To activate, contact your Booxi representative.
The Custom Notification Channel feature allows you to offer your clients greater control over how they receive booking related communications, beyond Booxi’s email & SMS notification options.
When booking through the booking widget v3, clients can optionally select their preferred communication channel based on channels you configure. Booxi securely captures this preference and the associated contact data at booking time.
Booxi will send the captured channel preference information provided by the client to you via webhook.
*Note: Booxi does not send notifications or communications through these custom channels, nor does it manage message delivery, timing, or content for these channels. All communication sent through custom channels is fully owned and operated by you.
This feature will be useful to you if:
You maintain your own communication infrastructure
You require flexibility beyond standard SMS and/or email notifications
Important Considerations
Configuration of the communication channels are done in the Head Office only.
Configuration and/or editing of channels must be done by a Head Office user with administrator permissions.
This feature is supported by the booking widget v3 (not v2).
When a Custom Notification Channel has been configured or edited in the Head Office, the updates must be pushed to your stores for the channels to be applied to the booking widget.
Both Channel Name and Channel Value are mandatory.
Channel Name is what will be exposed to the client in the BNv3 widget.
Channel Value is not exposed in the widget, but is sent in the webhooks.
If multiple channels are configured, they will appear in alphabetical order in the widget.
Configuring a Notification Channel
Channel configuration dictates:
Which preferred notification channels are available for client selection in the BNv3 widget.
What channel name is displayed to the client in the BNv3 widget.
The corresponding data structure value for each channel.
Whether providing a phone number and/or email address is mandatory for each configured channel.
Permissions: Administrator
Instructions
Log into Head Office as an administrator.
Navigate to the "My Stores" tab.
Select the template store.
Access the Booking Rules.
Navigate to Client Notifications > Custom Notification Channels.
Click the + button.
Input a Channel Name (mandatory).
Input a Channel Value (mandatory).
Select if phone, email, both or neither are mandatory for the client to provide when booking.
Click Save.
Translating a Channel Name (Optional)
If translations are available for the Channel Name, the name will be displayed in the corresponding translated language within the widget when that language is detected.
Permissions: Administrator
Instructions
After configuring the channel and saving, click the Translations button on the Booking Rules header bar.
Navigate to the Custom Notification Channels section.
Input translations for each Channel Name you wish to translate.
Click Save.
Removing a Notification Channel
If a configured channel should no longer be visible and selectable by the client in the widget as an option to receive notifications, it may be removed in the Head Office.
Permissions: Administrator
Instructions
Log into Head Office as an administrator.
Navigate to the "My Stores" tab.
Select the template store.
Access the Booking Rules.
Navigate to Client Notifications > Custom Notification Channels.
Click the ‘Delete this channel’ button.
Click Save.
Screenshots
View of channel options in Booking Widget (client view):
Example configuration in Head Office Booking Rules:
Webhook information
Here is a sample webhook portion containing notification channel data:
{
"content": {
"booking": {
"client": {
"id": 2391242,
"email": "example@booxi.com",
"lastName": "Smith",
"presence": "Expecting",
"timeZone": "",
"firstName": "Curtis",
"remindBySMS": false,
"trackingPage": {
"viewUrl": "https://site.booxi.com/tracking/Mmi3qHPBAmSUAPbG-gJD5Tra_V71Ln3vulD_?lang=eng",
"canCancel": true,
"canModify": true,
"canConfirm": false
},
"remindByEmail": false,
"homePhoneNumber": "+15145555555",
"additionalRequest": "",
"hasRequestedStaff": false,
"mobilePhoneNumber": "",
"videoConferenceUrl": "https://site.booxi.com/video/",
"notificationChannels": [
{
"identifier": "whats_app",
"displayName": "WhatsApp"
}
]
}
},
"notificationChannels": [
{
"identifier": "whats_app",
"displayName": "WhatsApp",
"isEmailMandatory": false,
"isPhoneMandatory": true
},
{
"identifier": "line",
"displayName": "Line",
"isEmailMandatory": true,
"isPhoneMandatory": false
}
]
}
}To see it in a complete webhook payload, see here.
*Note: the notificationChannels field appears twice in the webhook payload because it serves two distinct purposes depending on where it appears.
content.booking.client.notificationChannels
This tells you the notification channel that the client selected when booking — in other words, how that specific client wants to receive their notifications.
Example: if your client chose WhatsApp, only WhatsApp will appear here.
content.notificationChannels
This gives you the full list of custom notification channels configured for your business. Each entry also includes the contact information requirements you've set for that channel (isEmailMandatory, isPhoneMandatory).
This list is the same regardless of which client made the booking.