Connect WaSMS to WHMCS

The WaSMS WHMCS addon automatically sends WhatsApp messages to your customers when key events happen in WHMCS — new orders, invoice paid, payment reminders, ticket replies. No coding required.

1. Download the addon

Get the latest zip: download from your dashboard → Integrations or pull directly from https://wasms.net/whmcs/wasms-whmcs-addon.zip.

2. Install in WHMCS

1. Unzip the file. You will get a wasms folder.
2. Upload that folder to modules/addons/ inside your WHMCS install via FTP / SSH.
3. In WHMCS admin go to Setup → Addon Modules.
4. Find WaSMS.Net in the list and click Activate.
5. Click Configure.

3. Paste your WaSMS API key

You will see a field called WaSMS API Key. Get one from wasms.net/dashboard/api-keys. Required scopes:

• messages:send — send outbound messages
• messages:read — show recent activity inside the addon
• accounts:read — list your connected WhatsApp numbers

4. (Optional) Add WHMCS API credentials

For advanced features (pulling order/invoice/ticket details to enrich messages, creating tickets from WhatsApp replies), the addon can also call back into WHMCS via your own API credentials.

1. In WHMCS, go to Setup → Staff Management → API Credentials.
2. Create a new API role with at minimum read on Orders, Invoices, Tickets.
3. Create credentials assigned to that role — you will get an Identifier and Secret.
4. Paste them into the WaSMS addon’s WHMCS API Identifier and WHMCS API Secret fields.
5. WHMCS API URL can be left blank if the addon runs on the same WHMCS install (most cases).

These fields are optional — the basic order/invoice/ticket notifications work without them.

5. Pick events + save

Three toggles at the bottom:

• Send WhatsApp on new order — default Yes. Fires on AfterShoppingCartCheckout.
• Send WhatsApp on invoice paid — default Yes. Fires on InvoicePaid.
• Send WhatsApp on ticket reply — default No. Fires on TicketAdminReply.

Also wired automatically: InvoiceCreated and InvoicePaymentReminder for due/overdue alerts.

6. Test it

Place a test order in WHMCS using a number you control. You should receive a WhatsApp message within seconds. If nothing arrives, check WHMCS’s activity log (Utilities → Logs → Activity Log) for entries starting with WaSMS.

Troubleshooting

• No message arrives — verify the API key has the right scopes, and your WaSMS workspace has at least one connected WhatsApp account.
• WHMCS shows "WaSMS curl error" — your server cannot reach wasms.net; check firewall/outbound HTTPS.
• Some events not firing — some hosts disable WHMCS hook events; check with your host.