SMSPlus offers integration with more than a few industry-leading sending gateways like Infobip, Twilio, and Clickatell, etc. To configure your system with one of the available gateways, you need to have your account ready with the particular gateway that you want to use for sending. After having an account, you would just need to provide few simple details belonging to your account to finalize the integration process.
Earlier, you were restricted to configure a single account belonging to a certain gateway, but recent updates have made it possible for you to add multiple accounts of a certain gateway, i.e. Infobip I and Infobip II.
Main Navigation -> Setup -> SMS Gateways
The page where you would land by clicking SMS Gateways from the main navigation will show you a table with few columns. This table offers Information about the APIs of the sending gateways that were earlier being configured for sending. If no gateway has yet been setup, you will see this table empty. To populate the record in this table, you would need to first configure your account with one of the available gateways provided by the system. Here is how you do..
On the right side corner of the table's title bar, this button "Add a Gateway" takes you to the page where you'll see all possible gateway options to add for sending. Every company may require different details to authenticate the incoming API request and to connect with its gateway. Therefore, the next page after clicking the desired company name will require somewhat different details for each gateway. So as a first step, click the icon of the desired gateway among the available and proceed.
There are currently three gateway options systems is currently integrated with, Clickatell, Infobip, and Twilio. Later you may have more options, but for now, let's discuss how you would integrate your accounts with currently available options, starting with Infobip.
The following area discusses the fields that you need to fill with appropriate information in order to setup your account with Infobip.
Gateway Name
Before the previous major upgrades, it wasn't possible to add multiple accounts belonging to one gateway. As the new updates have made it possible for a user to add multiple accounts of one gateway, you would need to fill Gateway Name as a mandatory part of configuring your account. This would offer you the ability to make multiple accounts belonging to the same gateway appear differently within the system, i.e. infobip I and infobip II etc.
API Key
Infobip allows creating a unique API key as one of the requirements to authenticate the API request. Provide that particular API key in this field.
Secret Key
The secret key is another required parameter that infobip requires as an authorization token to accept an API request. Put forward your infobip account’s secret key in this field.
Sending Pattern
Select your preferred pattern of sending SMS from the specific gateway, the dropdown has two options. Sending pattern largely depends on how the gateway accepts sending requests from the application side. For example, SMSPlus only offers batch options when the selected gateway accepts contacts in batches and further processes this batch for sending.
Status
Select “Active” to mark the status of the specific gateway as active and working. The system will only use Gateways with Active status for sending. And if you don’t want to send from this gateway right now, you can mark the status of the gateway as “Inactive”.
Fallback Sender ID
In case if primarily preferred Sender-ID fails, the system automatically shifts to the Sender-ID you will set as an alternative in this “Fallback Sender ID” field. Primarily preferred Sender-ID can be the one that the client has got approved for the sending or the one that is given as application’s Default Sender-ID for the clients who don’t have their own Sender-ID approved. In case of the failure, the system automatically shifts to the Fallback Sender-ID.
Logo
You can use this to upload the gateway's logo to appear with the gateway name few places within the application. However, this is optional, if you don't want to upload a logo, you can leave it to continue.
Description
If you want to write some additional details about the gateway you are integrating, this is again an optional field.
Signup Link
Direct link to the gateway signup page to click and quickly signup for an account, if you don't have one already.
Most of the system required fields such as Gateway Name, Status, Fallback Sender-ID, and Sending Pattern, etc. will remain the same for every sending gateway; except for few unique fields that the gateway requires to authorize the API call to connect. So in the case of setting up Clickatell API, the following are the fields different than other gateways.
Username
Unlike the API key of Infobip, Clickatell requires an account username and password to authorize and connect. Provide the username of your Clickatell account to proceed.
Password
Provide the password of your Clickatell account in this field. As mentioned, the rest of the fields will remain and work the same as mentioned above.
With Twilio, the following are the two parameters that Twilio requires to determine the account from which the API call is initiated. Make sure, Twilio doesn’t allow sending in batches, therefore, you will only have the option of sending in the loop.
SID
For sending API requests, Twilio requires providing two important credentials; the first one is the account SID which acts like the username of your account. Provide your Twilio account SID here in this field.
Auth Token
Auth Token is like the password to the SID that you have just provided in the field above. Anyone without knowing this combination of valid SID and Auth Token will not be able to get the API request authorized by Twilio.
The table shows all available gateway accounts that the system currently have. Since every sending gateway requires somewhat different information from the user side to authenticate the API request, therefore you may notice some of the “Rows” will remain empty for certain gateways in the “Available Gateways” table, like Username and Password field will remain empty for “Clickatell” and “Infobip”. Let's discuss the columns/rows of the table in detail.
S/N
Serial number of the records in the table
Company Name
Gateway’s company name in the rows of this column
Gateway Name
In Gateways Configuration, the field actually acts like an account name that you provide while connecting an account that belongs to a certain gateway. Since you can have multiple accounts of a single gateway configured with SMSPlus, this field helps you keep every account easily recognizable.
API Key
To authenticate the API request, some gateways require submitting the valid API key in the API request, like Infobip. So for Infobip, the row under this column shows the API key. For Twilio it shows the account SID under the same column.
Secret Key
The same goes for the secret key column, for Infobip, it shows the secret key of the Infobip account and for the Twilio, it is showing the Auth Token. For Clickatell that requires the account’s username and password, fields for API Key and Secret key will remain empty.
Username
Gateways that require an account’s Username and Password for sending a valid API request will be having Username information in the respective row of the column. For Infobip and Twilio, the row under the “Username” column will remain empty, while for the Clickatell, it will show the Username of the Clickatell account that was being provided while setting up Clickatell API.
Password
Password associated to the Username in a row before.
Edit | Click to reach the Edit page, where you will be able to edit and update earlier saved API settings and preferences. |
Delete | Click to remove some gateway account from the list. |