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.

Navigate to Application Settings 

Admin Main Navigation -> Setup -> Application Settings 

There is quit a long list of options that you can control from this page. To manage the things well, settings are separated by different tabs. General settings appears under 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 number of days after which the system will automatically delete the elements in trash and empty it.  

Log Retention Limit 

Avoid growing the activity logs too large in size, and retain most recent logs by suggesting the Log Retention Limit in this field. Fill this field with number of days for which 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 notification, 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 remains empty while sending 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 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 it is Credit Package in which clients maintain credits in their account and 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 dollar, it means, every credits 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 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 couple of charts that offer filters to view 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 to the amount you mention in this field. 

API IP Address 

Apart from the API library for the client to use, admin can also use API functions to programmatically perform certain tasks such as getting packages from the billing etc. In this specific section, admin would restrict himself or his staff members to use only the provided IPs for sending API request. 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 using 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 credit plan, it reflects number of credits and the client account will eventually be able to send message equal to the number of credits you offered for free. The free balance is basically required for the testing purposes. 

Resend Email Attempts 

If the client doesn't receive the confirmation email, how many time 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 time the client can request to resend the mobile code to complete the complete the account confirmation process. Whenever a new clients logs into the account, 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 requires when the client doesn't receive the code in the first attempt.   

Request Mobile Code Time

After how much time 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, option to request resend of the code will remain unavailable for the client. 

Advanced Statuses 

Enable 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 client processes contacts through validation and acquires 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 number or client attempts sending message to such numbers, whether you want to deduct client's credit/balance or not. You can use 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 admin with an ability to deduct or not to deduct client’s credit/balance for these numbers that system doesn't even attempt sending to. 

Auto Approve Client 

Work this toggle button towards 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 auto-approval 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 system to automatically shift to the admin provided fallback sender id, when the primary sender-id of 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. 

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 option 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 

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, it can be a low credit/ balance alert message or other important notification for the client’s reference.

Email From Name 

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 addresses. 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 

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 default SMTP port, but some ISPs has 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 a 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 a software exclusively designed for the 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 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 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 second to appear on the login screen. This will appear both on client login as well as admin login screen. The login screen logo for the client login screen would appear on the slider, therefore, the logo should be transparent. 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, application automatically applies the default sending preferences to send the message. This newly added tab in application setting provides you a separate place to setup 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 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 client will login to access the billing/client area of WHMCS, i.e. billing.mumara.com/dologin.php 

Auth Key

While 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 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, 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.