Application Settings

You would setup parental controls and apply general application settings using this page. This would allow you to put forward default preferences for sending gateways, Sender-ID to use as default, trash, and log retention management, setting up default values for currency, export batch size, per credit cost to apply, setting up email with SMTP details to send notification emails and alerts, database settings and more with regard to the parental settings for individual modules.

Admin Main Navigation -> Setup -> Application Settings 

There is quite a long list of options that you can control from this page. To manage things well, settings are separated by different tabs. General settings appear under the first tab, next tabs hold settings for other functions and modules such as WHMCS. Let's start from the General Settings first.

General Settings (First Tab)

Installation Domain 
Complete qualified path to the current installation domain/ instance e.g. www.yourdomain.com/mumarasms

Server IP
IP of the current installation server.

Empty Trash After
SMSPlus soft deletes the lists, campaigns; contacts, etc. and moves the elements to the trash first. Until the cron runs after the specified interval to empty the trash. Here in this field, you put forward a number of days after which the system will automatically delete the elements in the trash and empty them.  

Log Retention Limit 
Avoid growing the activity logs too large in size, and retain the most recent logs by suggesting the Log Retention Limit in this field. Fill this field with a number of days for which the system will retain/maintain the activity logs, and will automatically keep deleting the logs older than the suggested limit of retention.

Notification Email 
Provide an email to receive admin notifications, notifications such as cron status report, etc.

Default Sender ID 
Which Sender-ID is to be used as default sender-ID? Client accounts that don’t have their own custom sender-ID approved, can select to send from Default sender-ID. Clients that use Send Message API for sending transactional messages, can also use the default sender ID if their Sender-ID isn’t still approved, fails or parameters remain empty while sending an API request.

Export Batch Size 
Instead of exporting the contacts one by one, SMSPlus offers the ability to speedily export by setting up a batch of contacts and exporting the whole batch. Put forward the size of the batch here in this field to maintain while exporting the contacts.

Record Batch Size 
Control the resource the way you want, provide a preferred batch size the system would fetch from the database. 

Per Credit Cost 
With SMSPlus, you have the ability to setup and offer the desired type of pricing plan to your client among the available three; one of them is Credit Package in which clients maintain credits in their account and the system deducts credits for sending messages.

This field is to provide the cost of every credit, how much every credit would cost? For example, you would provide 1 and the default currency is a dollar, which means, every credit would cost $1 to your client. 

Currency 
Select a Default Currency from the dropdown, later while creating the packages you would have the ability to set the separate currency for the package you create.

Term For Credit 
Use a short-term of Credit for the credit-based packages, like cr. is a largely used abbreviation of credit.

Week Starts From 
On the admin dashboard, there are a couple of charts that offer filters to view the weekly summary of SMS sending stats and gateway activity during the week. You in this field need to provide the day from where the weekly filter would start collecting the stats to show. E.g. Monday or Tuesday.

Low Balance Notification 
Send the client account a low balance notification after the credit/balance reaches the amount you mention in this field. 

API IP Address 
Apart from the API library for the client to use, the admin can also use API functions to programmatically perform certain tasks such as getting packages from the billing, etc. In this specific section, the admin would restrict himself or his staff members to use only the provided IPs for sending API requests. It can be one IP or multiple space-separated IPs.

API Token 
This token is only applicable for the admin related APIs like adding clients through API requests etc. This token will not be considered valid for use in the client-side APIs i.e. Send Message API etc. 

Free Balance
How much balance or credit you want to offer as free to the client account that registers for the services, put forward a number in this field. If you are operating with Topup Plan, this number would reflect monetary unit i.e. 1 dollar. For the credit plan, it reflects a number of credits, and the client account will eventually be able to send a message equal to the number of credits you offered for free. The free balance is basically required for testing purposes. 

Resend Email Attempts 
If the client doesn't receive the confirmation email, how many times he can attempt to request a resend of the email. Put forward a maximum number for the client. 

Resend Mobile Code Attempts 
In one day, how many times the client can request to resend the mobile code to complete the complete account confirmation process. Whenever a new client logs into the account, the system prompts a message to confirm the mobile number by receiving a confirmation code, no client would be able to attempt more than the number of times provided in this field. Reattempt is often required when the client doesn't receive the code in the first attempt.   

Request Mobile Code Time
After how much time the system will allow a client to request the resend of the mobile code that he/she earlier remained unable to receive. Before the time provided in this field completes, the option to request resend of the code will remain unavailable for the client. 

Advanced Statuses 
Enable the system to show advanced message statuses, Pending and Undefined. Not allowing these statuses will only show the basic message statuses such as sent, failed, etc. 

Deduct Credit for Un-attempted Messages 
SMSPlus identifies and lists some of the reasons as obvious sending failure and doesn’t attempt sending upon recognizing numbers with these obvious delivery failures. It is only possible when the client processes contacts through validation and acquires the status of the number ahead of sending, so that system can identify the number that carries obvious failure reason, and doesn’t supply it to the gateway for sending.

When a client list includes such a number or a client attempts to send a message to such numbers, whether you want to deduct the client's credit/balance or not. You can use the Toggle button to setup your preference. However, in either case, SMSPlus doesn’t supply these numbers to sending gateway for processing. Propose of the function is actually to provide the admin with the ability to deduct or not to deduct the client’s credit/balance for these numbers that the system doesn't even attempt sending to. 

Auto Approve Client 
Work this toggle button towards the left to mark it “On” and auto-approve the client accounts upon subscription, and switch it “Off” to make new accounts subject to manual admin approval. In case of having an auto-registration and billing system in place like WHMCS, you can opt for the auto-approve option. 

Demo Mode
If the demo mode is one, no message will be supplied to the gateway for sending.

Fallback Sender ID 
Fallback Sender ID offers an alternative Sender_ID to the clients using Send Message API for transactional messages. If you switch the Fallback Sender-ID option on, it will enable the system to automatically shift to the admin provided fallback sender id, when the primary sender-id of the client fails. It is however limited to the clients that are sending through API. You can setup a Sender-ID when setting up the sending gateway. 

WHMCS Integration 
SMSPlus offers this independent module integrated with WHMCS for auto-registration and invoicing. Turn it off if you aren't using WHMCS integrated module, select otherwise if you are using it. 

Auto Upgrade Version 
Turn it off if you don't want the system to automatically upgrade whenever there is a new version. Select otherwise, if you want the auto-upgrade function working. 

Admin Email & SMS Notification 
Two of these toggle options would help you switch On or Off the Email and the SMS notifications for the admin. Click Notification Center to learn more about the notifications.

Broadcast SMS Settings (Second Tab)

Settings for the broadcast SMS that admin can send to selected or all of the clients. How admin can setup a broadcast for the clients is a separately discussed topic and can be reached by clicking Admin Broadcasts. Here we only discuss what settings we have to control the admin broadcasts. 

Broadcast Through 

A couple of options are provided to select an appropriate one. 

1) Zones 

If the SMS broadcast should be sent by keeping the Zones Sending preferences, then select this option. How priority zones work is a detailed topic discussed here. 

2) Gateways 

If you don't want to apply the Zone Preferences for sending, then select this second option Gateway. Upon selecting, you will be provided all available gateways your system has configured with, you can select one of them to send broadcast text messages through the selected gateway only.

Email Settings (Third Tab)

SMTP settings for sending notification and alert emails to the clients, can be a low credit/ balance alert message or other important notification for the client’s preference.

Email From Name 
An email will appear to be sent from this Name, it can be the company name or something like “Mumara Alerts” etc. 

Send From Email 
Put forward a send from email address.

SMTP Host
Host to the SMTP server, it can be the path or IP address of your server to continue. You might have been provided with more than one IP address. In the case of IP pool, this can be any IP from the range to identify the SMTP host.

SMTP Username 
 Provide the username if the SMTP is username protected.

SMTP Password 
The password associated with the SMTP username in the above field.

Encryption Method
Select if the connection uses an encryption method for secure communication. 

SMTP Port
Port25 is largely known as the default SMTP port, but some ISPs have this default behavior to block port25. Therefore, MumaraSMS has made it possible to fill with an appropriate port. It can be a port 25 or an alternative opening ports like 2525, 2526 (SSL), and 587.     

Global Header and Footer 
There are two boxes at the end, two of these boxes are showing you the values to be shown in the email header and footer. If you are looking to add custom values for the header or footer of the email, you can input the HTML value in the respective box. Every email will then have this value concatenated with the message body.

White Labeling (4th Tab) 

SMSPlus is software exclusively designed for SMS Service Providers, it not only offers the functionality to carry out the technical aspects but also facilitates some of the enterprise features that would help service providers to present their services more effectively. This includes the White Labeling feature that would help to completely rebrand the application using your private labels. Here is how you operate it.

Update Labels
What is the preferred title you want for your installation? And what tagline suits best to the purpose of your service? You can update it in the respective fields for Application Title and Tagline. You can also update the copyright statement with your company name to appear at the bottom of the application.

Update Social Links
There is a place for you to link three of your major social network accounts, Facebook, Twitter, and LinkedIn. Provide the links of your business pages of all three in the respective fields.

Logo and Favicon Images
From the Dashboard logo, it is referring to the logo that appears at the top left area of your dashboard. Whatever image you place here will appear as the preferred logo for the dashboard. 165x36 is the dimension of the logo image. The place for the Favicon appears right beneath the dashboard logo, the size for the Favicon Image is 16x16.

Login Screen Elements
You can select different logos, one for the dashboard like mentioned above, and the second to appear on the login screen. This will appear both on the client login as well as the admin login screen. The login screen logo for the client login screen would appear on the slider, therefore, the logo should be transparent. The other three images down in the line are the images for the slider that appears on the login screen of the client-side.

Default Priority
Before applying the default priority, make sure that these are the default preferences for sending gateways, and you have the ability to later customize the sending pattern by setting up different geo-specific “Priority Zones”. But in case of not being able to find the custom sending settings, the application automatically applies the default sending preferences to send the message. This newly added tab in the application setting provides you a separate place to setup the default priority of sending gateways. Before this newly added tab, we used to manage the priority of primary, secondary, and tertiary sending gateway under the General Settings.

But now as the scope of the sending gateways has enhanced, the default sending priority is shifted under a separate tab, and from the simple fields, we have made it a dynamic drag and drop option to prioritize among the available gateways. The enhancement of sending gateways scope has enabled the admin to add more than one account belonging to one gateway, i.e. you can add two of your accounts belonging to Infobip and later use this drag and drop option to prioritize among these accounts. So now if the top sending priority is set as Infobip 1, the second can be the Infobip 2 the second account of Infobip you have.

WHMCS Settings 
WHMCS is an integrated module of SMSPlus for auto client registration, recurring invoicing, payment processing, and billing. This tab would only appear when you select the WHMCS Integration option under the General Settings as "On". You will fill few simple details belonging to your WHMCS account/installation under this tab to complete the integration. 

Identifier & Secret Key 
These are actually two fields on your interface, but together they make a unique combination to help WHMCS authenticate API requests. When you generate an API within WHMCS, you are being given both these keys together, therefore we too are discussing both these together. You need to provide Identifier in the first field and the Secret Key belonging to your WHMCS account in the second field. 

Login URL 
Provide the URL that the client will login to access the billing/client area of WHMCS, i.e. billing.mumara.com/dologin.php 

Auth Key
While the configuration of the WHMCS, you wrote this key for the value of $autoauthkey in the configuration.php file. Provide that value for the autoauthkey here in this field.

API Link 
Provide a link to your WHMCS API it would appear like http:// yourwhmcs.com /includes/api.php

Server ID 
While you create a new server within WHMCS, a server ID appears, here in this field you would need to provide this Server ID. 

After providing appropriate information in all the required setting options, click update to make new preferences/settings effective.