kwtSMS SMS Notifications

Send automated SMS notifications to your WHMCS clients and admins through the kwtSMS gateway. Free, open source, and built for the Kuwait market.

What it does

kwtSMS SMS Notifications connects your WHMCS installation to the kwtSMS SMS gateway (kwtsms.com), sending
automated text messages when key billing events occur. Your clients get instant SMS confirmations, and your
admin team stays informed.

Client notifications

• New registration -- welcome SMS when a client account is created
• Invoice paid -- payment confirmation with invoice number and amount

Admin alerts

• New order placed -- instant SMS to admin phones when an order comes in

Gateway management

• One-click login with your kwtSMS API credentials
• Live balance display with automatic daily sync
• Sender ID selection from your approved sender list
• Coverage check against your account's country prefixes
• Test SMS with inline feedback (message ID, balance after send)

Message templates

• Editable templates for each event with placeholder substitution
• English and Arabic templates included out of the box
• Live character counter (160 Latin / 70 Arabic per SMS page)
• Available placeholders: firstname, fullname, companyname, invoiceid, invoiceamount, orderid, date

Logging

• SMS Log -- every send attempt with full details: event, phone, result, message ID, balance after
• Security Log -- blocked attempts: gateway disabled, coverage skip, balance zero
• Debug Log -- internal diagnostics (toggle on/off in settings)

Test mode

Built-in test mode sends messages through the real kwtSMS API with test=1. Messages queue but never deliver, and credits are recoverable from your kwtSMS dashboard. Safe for development and testing.

Technical details

• PHP 8.2 and 8.3
• WHMCS 8.12.x, 8.13.x, 9.0.x
• Uses Composer for dependency management (kwtsms/kwtsms-php library included)
• PSR-12 compliant, PHPStan level 5 verified
• All database queries use WHMCS Capsule ORM
• Deactivation cleanly removes all custom tables and configuration

Coming soon

• All client and admin events (tickets, services, domains, cancellations)
• Client area opt-in/opt-out preferences
• Two-factor authentication (client and admin login)
• Arabic admin UI

FAQ

Is this free? Yes. Free and open source under the MIT license.

Does it work with other SMS gateways? No. This module is built specifically for kwtSMS (kwtsms.com).

Does it send real SMS during testing? No. Test mode (enabled by default) sends through the real API with a test flag. Messages queue but never
deliver.

What phone format does it expect? International format with country code (e.g. 96598765432). The module automatically normalizes local numbers by prepending your configured country code.

Does deactivation delete my data? Yes. Deactivating removes all custom log tables and configuration. Back up your SMS logs before deactivating if you need them.