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.

Primary API 

Which sending gateway’s API is to be considered as primary priority for sending messages? Dropdown carries all available sending gateways for you to select the preferred one for primary position.

 

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.

Secondary API

Which sending gateway is preferred as secondary sending priority in case the API on primarily position fails? Select from the dropdown.

Tertiary API 

Select the tertiary preference of Sending Gateway, this would work when the both gateways on primary and secondary position fails.

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.

Fallback Sending Limit

Fallback Sender ID is an exclusive function that SMSPlus offers specifically for the clients sending transactional messages through Send Message API. In case the primary sender ID that the client has got approved/registered doesn't function or failed to response, system automatically use the alternative Sender-ID provided as Fallback Sender ID. In this specific field, you would need to put forward a limit of the messages that system can send from the fallback sender ID at maximum. E.g. you provided 1,000 in this field, system will only send 1,000 message using the fallback sender ID, reaching the limit notifies the admin. 

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 Messages 

Number of messages you want to allow for free of cost. Free messages are required for the testing purposes mostly. 

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 

Above we've mentioned about the Fallback Sender ID in somewhat detail. Fallback Sender ID offers an alternative 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.  

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. 

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.     

WHMCS Settings (Fourth Tab)

WHMCS is an integrated module of Mumara for auto client registration, recurring invoicing, payment processing and billing. This tab would help fill few simple details belonging to your WHMCS account/installation, and 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.