You will be able to choose from ten different SMS gateways, define SMS templates in various languages and manage bulk text messaging.
The module will allow you to verify new clients and orders as well as enable SMS codes as a part of two-factor authentication while logging in to your system.
You will also get the access to SMS messages logs in order to verify the status of each sent text message.

We will guide you step by step through the whole installation and configuration process.

Note: You can check current PHP version in your WHMCS. To do so proceed to 'Utilities' → 'System' → 'PHP Info'.

The content of PHP version files should look like this.

File is located in 'modules/addons/sms_center/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area → 'My Products'.

Log in to your WHMCS admin area and proceed to 'Setup' → 'Addon Modules'.
Afterwards, find 'SMS Center' and press 'Activate' button.

To do so, click on 'Configure' button, tick checkboxes to assign desired admin roles.
Choose a country code prefix that will be automatically added to the client's SMS number if it has not been specified. Press 'Save Changes'.

Remember that integration depends on the WHMCS version and template that you are using.
If your system used is WHMCS V6.x.x and template: 'Six', there is no need for you to do any integration.
However, if you are working with WHMCS V6.x.x template 'Five' or WHMCS V5 then you must insert the code snippets as it is explained on the screen below.

/your_whmcs_dir/modules/addons/sms_center/crons/cron.php

Remember to replace your_whmcs_dir with a correct directory of your system.

Press the first one 'Submodules' to configure and check connection with SMS gateways.

You can use a recommended 'FastSMS' gateway:

As an example we will configure SMSEagle gateway.
Apart from connection details, you may here define which countries the gateway shall be used in.
In case you are going to activate more than one gateway, you must point one of them as default.

Activate the gateway, press 'Enable' next to it.

All you need to remember is to set one gateway as default, assignment of countries to a gateway is not obligatory.
If a gateway has no countries assigned, but is set as default, then text messaged will be sent via this gateway and localization requirements are not fulfilled with any other gateway.
If active gateway is not set as default and there are no countries assigned to it, such gateway will simply be not used.

You have the possibility here to decide who of them will receive SMS notifications and which notifications exactly.
Follow the steps described below to configure staff notifications properly.

Press 'Administrators' under 'Configuration' tab.

1. Fill in the administrator's phone number, where text messages with notifications will be sent.
2. Choose which of the available admin messages shall be sent to that administrator.
3. Choose products to notify when they are ordered.
4. Select Ticket priority, you will be informed when a new ticket with selected priority is opened. Save changes.

Repeat these steps for every administrator you wish to receive admin notifications.

By default, 'SMS Center' for client area is enabled, you may disable it here.
Note for WHMCS V5: You must insert integration code snippets to properly use SMS Center in your client area.
If you disable it once codes are inserted, the button will still be visible in your client area but you will not be able to access it.

Once an order is placed a client will receive a text message with a token, which must be then used to finish the order.
You may define here how many times a client will be allowed to ask the token to sent again within one hour.
Note, this option does not support orders upgrades!

Depending on the settings, you may allow clients to ask for resending the token.
The client only needs to press 'Resend Token' button and they will receive another text message.

Declare time intervals for sending tokens here and allowed number of attempts to resend the token.

If allowed by administrator, client may request sending the token again by pressing 'Resend Token' button.

As an administrator you can also verify client's account manually.
To do so, go to your client's profile and click the 'Verify' button:

Declare time intervals between attempts to send text messages and the number of messages that can be sent in one attempt.
Finally, choose time period when text messages can be sent to clients. Detailed information on this function is described here.

Please note that allowed set of characters used for generating a token may contain chars from the following range only:

1234567890ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz

Any of these messages can be enabled/disabled through marking/unmarking checkbox next to them and pressing 'Save'.
Note: Titles of the messages templates can be translated in the module language file.

Press 'Edit' to do so.

In order to prepare a message in an additional language, select desired language from a dropdown menu and press 'Add' as shown on the following screen.

You can remove any additional language through pressing 'x' icon next to it.
Note: Language of a message sent is based on client's language, if message for client's language is not defined, default message will be sent.

Simply, click on the wanted merge field, it will be injected into currently edited version of the message.

Specific details on messages that can be sent in one attempt are specified in 'General' section.
If SMS Queues are enabled every single message before being sent is placed on this list. With every cron run a previously set up number of messages is sent.
If message sending fails (because the number is incorrect, there are problems with gate, no funds etc.) such SMS stays on the list for the next attempt.
After three failed attempts its status is changed to 'Aborted'.

1. Send - send message manually.
2. Reload - use when status has changed to 'Aborted' to bring it back to the queue.
3. Delete - remove message form the list.

Press 'Create New Template' to begin.

Enter your template name, choose a group it will belong to and type in the message text. Use available for the group merge fields.
Do not forget to save the changes.

Select the type of filtering, you can choose from:

• 'General' filtering
• filtering according to 'Addons', 'Domains' or 'Products'.
  
  

Each filter type configuration differs slightly, but there are some general settings available for each type. These are:

• Custom Fields - enable available custom fields;

  'Marketing SMS' is a default addon custom field, if you enable it, clients will receive marketing notifications

• Client Group - select which of your client groups will receive the text message
• Client Status - you may choose clients to receive messages depending on their status in your system
• Language - select default language for the messages.
  

All the above sections are available for 'General' client filter.

Client Filter - Addon

• select purchased addon
• select addon status

• select domain status

• select products from purchased ones
• select product status
• select assigned server
  

Press 'Compose Message' to continue sending mass messages.

If everything is correct, press 'Send Message'.

As you can see on the following screen, here you can find detailed information about each message sent automatically to a client after certain actions.

Type in the message text into the text field like on the screen below and press 'Send'.

Through pressing it your client will be moved to configuration of SMS notification.

Note! Provide SMS Number in the client's profile. Otherwise SMS Notifications will be unavailable for that client.

Two-Factor Authentication adds an extra layer of protection while logging in.
Once enabled and configured, each time they sign in they will be asked to enter both username and password as well as the second factor like a security code.
In order to activate it proceed to 'Setup' → 'Staff Management' → 'Two-Factor Authentication'.
Afterwards, find 'SMS Center Two-Factor Authentication,' and press 'Activate' button.

To do so, fill out the data:

• Enable for Clients - choose this option if you wish all clients to authenticate while logging in their account.
• Enable for Staff - choose this option if you wish all administrators to authenticate while logging in their account.
• Activation Code Valid For - decide how long a received code shall be valid, in minutes. Used once before the first log in.
• SMS Code Valid For - decide how long a received via SMS code shall be valid, in minutes. Used every time to log in after the first authentication.
• Code Length - specify of how many characters a code will be composed.
• Allowed Characters - define which characters can used to generate the codes. Please note that some of special characters may cause unpredictable errors.
  Keep that in min when selecting chars like: ", &, >, < or similar.

Here is how to enable such functionality:
1. Log in to your client area, proceed to 'Account Details' → 'Security Settings'.
There is a button, which once pressed enables two factors authentication configuration for the client.

This step will be skipped if the client entered a valid SMS number in the profile before!

Here is how to enable such functionality:
1. Proceed to 'My Account.' Find 'Two-Factor Authentication' and enable it to start the Two-Factor Authentication process.

2. Required parameters:

• (phonenumber) OR (userid) OR (adminid)

  AND

• (messagename) with (relid) - ID of relation, for example invoice or service OR (message) - text of the message

3. Where:
(Relid) for (userid) is an 'integer'
(Relid) for (adminid) is an 'array'

4. A typical example usage for sending an SMS with a specified message to the user with a given ID:

localAPI('sendsms', array('userid' => $_POST['userid'], 'message' => $_POST['message']), 'admin');

5. Example of usage for admin 'array' with parameters:

array('admin' => 1,'phonenumber' => $number, 'messagename' => 'Service Unsuspension Successful',
'relid' => array('client' => $params['params']['userid'], 'service' => $params['params']['serviceid']))

In case you add phonenumber in the message, you must specify if it is admin's number by entering: 'admin' => 1, like in the example above.
If this is user's number, then you no not need to add that.

6. Since 2.2.0 version of SMS Center there is also support for the new 'force' parameter. If set to 'true' it allows skipping the queue for sending SMS immediately.
Example of usage this parameter:

localAPI('sendsms', array('userid' => $_POST['userid'], 'message' => $_POST['message'], 'force'=> true), 'admin');

1. SMS Center For WHMCS has been integrated with our Clients Profiler For WHMCS module.
Find more information about the integration on Clients Profiler For WHMCS Wiki.
2. SMS Center For WHMCS messages are divided into four categories:
Messages sent automatically to clients after actions (activity is logged in the addon 'Logs' tab)
Messages sent automatically to administrators after actions (activity is logged in WHMCS 'Module Log' )
Messages sent manually from client's profile (activity is logged in WHMCS 'Module Log' )
Messages sent manually from Client Profile Viewer For WHMCS widget (activity is logged in WHMCS 'Module Log' ).

Default message: 'Your account activation token is: erkhq34j329'
Change the message content in the addon language file.