Event SMS
Event SMS allows ISPBills to automatically send an SMS to a customer whenever a specific action or event occurs on their account. Instead of manually notifying customers after every transaction or status change, you configure a message template for each event type once, and the system handles all future notifications on its own.
Supported Event Types
ISPBills supports automatic SMS triggers for the following events:
| Event | When it fires |
|---|---|
| New Customer Registration | A new customer account is created in the system. |
| Payment Received | A payment is recorded against a customer's account (manual entry or online payment). |
| Package Activated | A package is assigned to or activated on a customer's account. |
| Account Suspended | A customer's account is suspended (e.g. due to non-payment). |
| Account Disabled | A customer's account is fully disabled. |
Each event type is independently configurable — you can enable some and leave others disabled, and each has its own message template.
Configuring Event SMS
Navigate to Settings → SMS Notifications → Event SMS to manage event triggers.
For each event listed, you will find:
- Enable toggle – Switch the event SMS on or off without losing your message template.
- Message Template – The SMS body that will be sent when the event fires.
Template Variables
The following variables can be used inside any event message template:
| Variable | Replaced with | Best used for |
|---|---|---|
{customer_name} |
Customer's full name | All event types |
{package_name} |
Name of the package involved | Package activation and expiry-related events |
{amount_due} |
Outstanding balance | Suspension, due, and balance reminders |
{amount_paid} |
Amount of the most recent payment | Payment confirmation |
{expiry_date} |
Package expiry date | Package activation and expiry-related events |
Not every variable is meaningful for every event — use only the variables that make sense for each context.
Example Templates
New Customer Registration:
Welcome to our network, {customer_name}! Your account has been created. Please contact us if you need any assistance.
Payment Received:
Hi {customer_name}, we have received your payment of {amount_paid}. Thank you. Your remaining balance is {amount_due}.
Package Activated:
Hi {customer_name}, your {package_name} package has been activated. Enjoy your internet service.
Account Suspended:
Dear {customer_name}, your account has been suspended because of an outstanding balance of {amount_due}. Please make a payment to restore your service.
Account Disabled:
Dear {customer_name}, your account has been disabled. Please contact us to discuss reactivation.
Enabling and Disabling Individual Events
Each event can be toggled independently. If you want payment confirmations to go out but do not want to send messages when accounts are suspended, simply leave the suspension event disabled. Changes take effect immediately — the next time that event occurs, only enabled events will trigger an SMS.
Notes
- Event SMS messages are sent in real time when the triggering action takes place, not on a scheduled basis.
- One SMS credit is consumed per message sent. High-volume events such as Payment Received may consume credits frequently; monitor your SMS balance accordingly.
- The SMS gateway must be configured and active under Settings → SMS Gateway for Event SMS to function.
- If a customer does not have a valid mobile number on their profile, the SMS will be silently skipped for that customer. Keep customer contact details up to date.