Manual Setup & Configuration of Messaging Gateway

Last Updated: 31 Dec 2018

In the event that you have skipped or cancelled the Post Setup Wizard, this article guides you to manually setup and configure the Messaging Gateway.

Connecting to the Cloud Alert Service

Open the Administration Portal in your web browser, using the URL and login with the default password 'password'

Select Manage Networks - Add Network. Enter the following information:

  • Network Name: Cloud Alert Network
  • Network ID: CLA
  • Network Type: Cloud Alert
Click Save.

Now, select Manage Cloud Alert Connection - Configure Connection.

  • Connection name: Cloud Alert
  • Network: Cloud Alert Network
  • Node: Node 1
  • User name:
  • EMail address: (Your organization's email address)
    This email address will be visible to users, so its recommended that you enter a common email address, or that of your call center.
Click Next.

The Logo Upload page will be displayed. Select a logo file in the JPG or PNG formats, with size 512x512 pixels. This logo will be displayed alongside the name of your organization. Click Upload

Next, confirm your details and click the Verify button

The next page will request you for an authorization code. Enter the code sent to your organization's email address and click on the Verify button.

The page confirms that you have setup your Cloud Alert Connection. Restart the Cloud Alert Messaging Gateway service for the settings to take effect.


  • The Network ID is a 3-character code, in uppercase, that identifies the network. You can enter any easily-memorable code as long as the same code is entered in other settings that refer to this Network. The network code cannot be changed once specified. The code is included in generated log files for reporting and analysis purposes.
  • The Node setting is used in active-active clustered environments. Setting up a Messaging Gateway cluster is beyond the scope of this document

Connecting to SMPP Gateways

From the Administration Portal Home Page, navigate to Manage Networks - Add Network. Enter the following information:

  • Network Name: (enter the name of your SMPP service provider)
  • Network ID: SMS
  • Network Type: Telecommunication Network
Click Save.

From the Administration Portal Home Page, select Manage SMPP Connections - Add Connection

  • Connection Name: SMPP Connection 1
  • Server name: (The hostname of the SMPP server)
  • Port number: (The port number of the SMPP server)
  • Login name: (The authentication details provided by your sms provider)
  • Login password: (The authentication details provided by your sms provider)
  • Network: (Select your SMPP service provider)
  • Node: Node 1
  • Max Outstanding Packets: (The Window Size specified by your provider, typically 1 or 10)
Leave the rest of the settings blank, and click Save.
Restart the messaging gateway for the settings to take effect.

Once restarted, navigate to View Logs - this will show you the status of your system. The text 'Connection... has connected' indicates that the connection's connectivity to the server is fine, and its login operation has been successful.
The status of the connections is also present in the View Outbound Connections window.

Setting up routing and failover

Navigate to the Manage System Settings window and alter the following settings. To alter a setting, click on the icon at the left, enter the new value, then click Save.

  • The network code for initial send try: CLA
  • The network code that failover fails from: CLA
  • The network code that failover fails to: SMS
Note that these network codes correspond to the codes previously entered in the Manage Networks section.
Restart the Gateway for the settings to take effect.

Testing your setup

  • From the administration portal, select Send test message.
  • Enter the details, select the Route and click the Send button.

The successful delivery of the message confirms the setup.

Cookies on
As described in our Privacy Policy, we place cookies on your device to improve usability of our website. You can change your cookie preferences by using your browser settings.
I accept