MS-8.4: Organize Zones


Here on this page, you will see a tree-view of all currently available zones that have earlier been setup using “Setup Destination Zone”. The functionality of this page would offer you the ability to dig the prioritized sending deeper and setup different levels of preferences for priority based sending. Following are these levels.

  1. Zone Based Sending Preferences (Top Level)
  2. Network Based Sending Preferences (Child Level)


Navigate to Organize Zones

Admin Main Navigation->Addons->Destination Zones->Organize Zones   


All currently available zones with the hierarchical tree of child elements are listed on the left side under “Zone Name” each level in the hierarchy that has the cog icon can carry its separate sending preferences. The cross button can be used to delete particular zone from the list.


Drag and Drop

Manage countries in a zone by using drag and drop feature. For example if some of the countries are part of “Default Zone” that you want to add to particular “Priority Zone”, all you need to do is to keep hold of the country from your mouse and drag it to the zone to which you want to add it. It is how you can conveniently manage and organize the countries in the zones.


Default Zone

As mentioned earlier, default zone appears at top of the tree above all currently available priority zones. Countries that aren’t the part of any other zone are automatically made part of the default zone. But default zone can’t carry any country that has already been made part of any priority zone.

Image#MS-8.4.1: Default Zone, Top/Child Level Zones, Zone Settings 



Zone Based Sending Preference (Top Level Priority)

To update zone level sending priority, clicking the Cog button will popup setting with the following fields/preferences.

Zone Name (Text Field)

Name of the zone that you earlier provided while setting it up on “Setup Priority Zone” page, zone name was first mandatory field to fill. You however have the ability to update that zone name and can provide a new name here in this field.

Status (Dropdown Selection)

Zone status as it was marked while it was first setup using “Setup Priority Zone”. From here, you can update specific zone status from Inactive to Active, Blocked to Inactive, or may be Active to Inactive or Blocked. Your selected status will effect sending in one of the following ways.

  • Application will apply preferences of an “Active” zone while sending messages to countries/networks in specific Priority Zone
  • Application will ignore zone preferences and will apply default sending settings for a zone marked as “Inactive”
  • Application will block sending to the specific countries/networks added to a zone with “Blocked” status.


Primary, Secondary and Tertiary API (Dropdown Selection)

Followed by zone Status, three of the fields are showing the primary, secondary and tertiary priority of sending gateways in a sequence.  Each of the dropdown carries all currently available Sending Gateway APIs to update the preferred ones at primary, secondary and tertiary positions for sending.

Countries (Checkbox Selection)

Country’s list would show number of countries that was selected for particular zone while setting it up, however if you want to add more countries in the zone, or exclude few of the already selected ones, you can use the checkboxes along with the name of every country in the list. Tick the checkbox to add a country in the zone, and uncheck the checkbox to exclude the country from the zone. Use search box to search particular countries from the list.


Being on top of the hierarchy, zone level settings and preferences can be applied recursively to the child level (Network) down in the hierarchy. So if you select the checkbox next to the label “Options” the preferences will apply recursively to the network level down in the hierarchy of the zone. And leaving the checkbox unchecked will keep preferences to the zone level sending only.

Save & Exit

Click to save the updated preferences for specific zone.


Click to close the popup window without saving the updated preferences.


Image#MS-8.4.2: Prioritizing Top Level of Sending (Zone Based) 




Network Based Sending Preferences (Child Level Priority)

Countries and the networks operating in these countries appear down in the hierarchy of the Zone Tree. MumaraSMS automatically populates the regional networks operating in specific country that you can see by clicking the country name in the tree. Moreover, if MumaraSMS detects sending to a new/unsaved network carrier, it automatically and accurately lists that network under its country.  

Other than the zone level sending preferences, you can apply separate sending preferences for the networks down in the hierarchy. Click the country name to expand its networks, and then clicking the cog button next to the network name to pop-up the setting window on your screen. Popup window will carry the following fields.

Network Name (Uneditable Field)

The field isn’t editable and just showing the name of the network carrier for which you are applying custom sending preferences.

Primary, Secondary and Tertiary API (Dropdown Selection)

Primary, secondary and tertiary APIs are the dropdown options carrying all currently available sending gateways, for you to select the preferred ones for primary and then secondary and tertiary positions respectively.

 Save & Exit

Click to save the sending preferences for specific network carrier.


Click to close the popup window without saving the sending preferences.


Image#MS-8.4.3: Prioritizing Child Level of Sending (Network Based)



How Priority Based Sending Works?

As we have learnt to implement the zones and organizing the different hierarchal levels of setting up sending preferences, let’s now discuss priority based sending actually works.

Whenever a client account attempts sending to a destination covered by a zone, system looks and considers network based sending preferences on priority, if it fails to identify with the network based sending preferences, it detects the country from the country code in the number and will look for the zone particular country falls in. In case of successfully tracing the zone, system applies the sending preferences of the zone. If the detected country isn’t the part of any priority zone, then the sending preferences of Default Zone will be applied. Default zone appears at top of the tree and it includes all the countries that aren’t part of any priority zone.

Make sure that to be able to apply network based sending preferences; system should be able to recognize the network carrier first. And it is only possible when the client validates the contacts before scheduling a campaign. Because when client validates the contact, system acquires and saves certain information with regard to the contact number, it includes contact’s network carrier name and destination country. So the way application identifies the destination network before sending is through contact validation. If system doesn’t identify the destination network before sending, network based sending preferences will be ignored and system will look for the country to apply zone based sending preferences or will send from the Default Zone if the country isn’t the part of any priority zone.


Have more questions? Submit a request


Powered by Zendesk