Skip to content
✦

Small plugins. A more connected business. One-time $15 licenses for your favorite platforms.

Explore the collection ↗

WASMS · WHMCS

KNOWLEDGE BASE

Install. Connect. Make it yours.

Your WHMCS installation and use guide.

All guides
WATCH THE MODULE

A guided look inside.

Six short steps through the actual WASMS interface. English on-screen captions, a full transcript and demonstration data. No narration.

1 minute · English captions

Shared plugin screens vary by platform. Native installation steps remain in the written guide. No messages were sent while creating this walkthrough.

English transcript & chapters
  1. Install the matching WHMCS 7 legacy, 8 or 9 archive. Activate Doiteasy WASMS in Addon Modules and allow the intended administrator roles.

  2. Enter your own WASMS API key and WhatsApp device ID in Configurations. Keep test mode enabled during setup. Normal WASMS plan limits and usage charges apply.

  3. Open Management, select one supported event and edit its English or Arabic template. Confirm the supported merge fields before enabling notifications.

  4. Open the composer and inspect the recipient and message preview. Screens use fictional demonstration data; no real messages are sent in this walkthrough.

  5. Use Logs to inspect pending, accepted and failed requests. Accepted is not proof of phone delivery. Investigate an unknown outcome before retrying.

  6. Follow the written guide for license activation and your platform worker. Native CMS installation and a controlled delivery test are still required before live use.

01Before you install

Three review archives: WHMCS 7.6–7.10 legacy, WHMCS 8, and WHMCS 9. Only WHMCS 8.11.2 / PHP 8.2.34 has native installation evidence. Match the PHP version to your exact WHMCS release; PHP 8.0 is excluded. Legacy 7 uses PHP 7.3, outside the requested PHP 7.4+ range.

Your shared control center

Your shared control center · demonstration interface
Home brings queue totals, recent activity and the composer together. This is the actual shared WASMS interface with fictional customers; the surrounding CMS menu differs by platform.Select the image to view it at full size.
02Install & open your product

Back up the database and module files. Extract the matching archive at the WHMCS root so modules/addons/doiteasy_wasms/doiteasy_wasms.php exists. In System Settings → Addon Modules activate Doiteasy WASMS, assign intended admin roles, then open Addons → Doiteasy WASMS. For 2FA, install the optional modules/security/doiteasywasms directory only from the 8/9 package. Enable/enroll the factor through native WHMCS security settings separately.

03Scheduled sending & reminders

Configurations → Queue cron → Install cron (or Repair cron). Use the exact PHP executable and command displayed by the module if your host requires manual setup. Check the heartbeat. Keep the existing WHMCS billing cron. Direct-number sending is immediate; bulk and event notifications depend on the worker.

04What to configure & test

43 configurable account, invoice, service, domain, ticket, administrator and verification events. Shipping requires the doiteasy_wasms_shipping_notify integration hook. Guest-order verification enforcement and secondary-contact fan-out are not included.

Choose an event template

Choose an event template · demonstration interface
In Management, select an event group and an event, then edit the English or Arabic message. Check the merge fields supported by your platform before enabling that event.Select the image to view it at full size.
05Activation & connection

Open WASMS → My licenses, select this product and download the matching archive. Enter its activation code in the plugin License section; the configured site URL is its one-site identity. In Connection save your own WASMS API key and connected WhatsApp device ID. Keep messaging disabled and test mode enabled until configuration is checked. Sending requires wa_send; number registration checks require validate_wa_phone. Normal WASMS plan limits and usage charges apply.

Connection and test mode

Connection and test mode · demonstration interface
Configurations holds the WASMS API key, device ID and messaging preferences. Use your own connection, keep test mode on during setup, and follow the platform-specific worker instructions above.Select the image to view it at full size.
06Cloud API & Copy code (optional)

For supported OTP flows, open WASMS account → Cloud API and enter your own Meta access token, WhatsApp Business Account ID, phone number ID and approved AUTHENTICATION / COPY_CODE template for the intended language. Verify that profile, then select Cloud API for OTP delivery in plugin Connection settings. A linked device alone cannot create the native Copy code card. Keep the existing sender until the Cloud profile is verified; this does not enable a native login factor on platforms that do not include one.

07First test & everyday use

Start on a CMS test installation or a WASMS test workspace. Choose Arabic (RTL) or English (LTR), save one template and confirm its supported merge fields. Check permissions, license/entitlement and the worker heartbeat. Test mode should create no real delivery. When ready, use one recipient you control who has agreed to receive the test. Enable only the needed event and confirm receipt on the phone. Check duplicate events, opt-out and failed credentials before expanding automation.

Preview a message before sending

Preview a message before sending · demonstration interface
The composer separates recipients from message content. Check the recipient and template preview first. These screenshots and the walkthrough do not send messages.Select the image to view it at full size.
08Troubleshooting & safe updates

Queued: check the worker, PHP executable, permissions and connection. Accepted: the request was accepted, not proof of phone delivery. Unknown: inspect the original request before retrying. For license errors check the product and canonical site URL. Before updates back up files/database and preserve private configuration and encryption secrets. Disable messaging and pause the worker before rollback; restore the matching files and database together. Do not erase customer data during a routine update. Send support the platform/PHP version and a redacted error, never API keys or OTPs.

Read delivery states correctly

Read delivery states correctly · demonstration interface
Logs show queue and request outcomes. Accepted means the service accepted a request; it does not prove receipt on the phone. Investigate an unknown result before retrying.Select the image to view it at full size.