System Settings/Notification Settings

Notification Settings

The Notification Settings module configures how your platform sends notifications to users. You can set up email, SMS, WhatsApp, and Telegram delivery channels with customizable templates.

Accessing Notification Settings

  1. Log in to the admin panel at https://your-domain/admin
  2. Click Notification Settings in the sidebar under "System Settings"
  3. You will land on the Notification Settings hub page

notification settings
Notification Settings

Notification Settings Overview

The hub page provides access to all notification configuration modules:

ModuleDescription
Email DriversConfigure email delivery providers
SMS DriversConfigure SMS delivery providers
WhatsApp DriversConfigure WhatsApp delivery
Telegram DriversConfigure Telegram bot delivery
FormatsCustomize notification templates
ShortcodesManage dynamic content variables

Email Drivers

Navigate to Notification Settings → Email Drivers to configure email delivery.

Configuring Email Drivers

  1. Select an email driver from the list
  2. Configure the driver settings:

SMTP Configuration

SettingDescription
HostSMTP server hostname
PortSMTP port (usually 587 or 465)
UsernameSMTP authentication username
PasswordSMTP authentication password
EncryptionTLS or SSL encryption
From AddressSender email address
From NameSender display name

Mailgun Configuration

SettingDescription
API KeyMailgun API key
DomainSending domain
RegionUS or EU region

SendGrid Configuration

SettingDescription
API KeySendGrid API key
From EmailVerified sender email
From NameSender display name
  1. Click Save to update
  2. Click Test to send a test email

Testing Email Delivery

  1. Click the Test button
  2. Enter a test email address
  3. Click Send Test
  4. Check the inbox for the test email

SMS Drivers

Navigate to Notification Settings → SMS Drivers to configure SMS delivery.

Configuring SMS Drivers

  1. Select an SMS driver from the list
  2. Configure the driver settings:

Twilio Configuration

SettingDescription
Account SIDTwilio account SID
Auth TokenTwilio authentication token
From NumberTwilio phone number

Nexmo Configuration

SettingDescription
API KeyNexmo API key
API SecretNexmo API secret
From NumberNexmo phone number
  1. Click Save to update
  2. Click Test to send a test SMS

WhatsApp Drivers

Navigate to Notification Settings → WhatsApp Drivers to configure WhatsApp delivery.

Configuring WhatsApp Drivers

  1. Select a WhatsApp driver from the list
  2. Configure the driver settings:

WhatsApp Business API

SettingDescription
API URLWhatsApp Business API endpoint
Access TokenAPI access token
Phone Number IDBusiness phone number ID
  1. Click Save to update
  2. Click Test to send a test message

Telegram Drivers

Navigate to Notification Settings → Telegram Drivers to configure Telegram delivery.

Configuring Telegram Bot

  1. Configure the Telegram bot settings:
SettingDescription
Bot TokenTelegram bot token from @BotFather
Bot UsernameBot username (without @)
Webhook URLWebhook URL for receiving messages
  1. Click Save to update
  2. Click Test to send a test message
  3. Click Configure Webhook to set up the webhook URL

Telegram Bot Setup

  1. Open Telegram and search for @BotFather
  2. Create a new bot with /newbot
  3. Copy the bot token
  4. Paste the token in the configuration
  5. Configure the webhook URL

Notification Formats

Navigate to Notification Settings → Formats to customize notification templates.

Managing Templates

ActionDescription
Create TemplateAdd a new notification template
Edit TemplateModify existing template
Delete TemplateRemove a template

Template Fields

FieldDescription
NameTemplate identifier
ChannelEmail, SMS, WhatsApp, or Telegram
SubjectEmail subject line (email only)
BodyNotification content
ShortcodesDynamic variables (see below)

Using Shortcodes

Shortcodes are dynamic variables that get replaced with actual values:

ShortcodeDescription
{{name}}User's name
{{email}}User's email
{{amount}}Transaction amount
{{plan}}Subscription plan name
{{date}}Current date
{{time}}Current time
{{site_name}}Your site name
{{link}}Action link

Notification Shortcodes

Navigate to Notification Settings → Shortcodes to manage available shortcodes.

Creating a Shortcode

  1. Click Create Shortcode
  2. Enter the shortcode details:
    • Key — Shortcode identifier (without braces)
    • Description — What this shortcode represents
    • Default Value — Fallback if no value available
  3. Click Save

Editing a Shortcode

  1. Click Edit on the shortcode row
  2. Modify the details
  3. Click Save

Notification Workflow

The typical notification workflow:

  1. Event occurs — User action triggers notification
  2. Template selected — System picks appropriate template
  3. Shortcodes replaced — Dynamic values inserted
  4. Channel selected — Email, SMS, WhatsApp, or Telegram
  5. Message sent — Delivery via configured driver
  6. Delivery confirmed — System logs delivery status

Best Practices

  • Test all channels — Verify email, SMS, and Telegram work
  • Use shortcodes wisely — Personalize notifications for engagement
  • Keep templates updated — Review and update notification content
  • Monitor delivery rates — Track notification success rates
  • Provide opt-out — Allow users to manage notification preferences
  • Backup configurations — Export driver settings regularly