Introduction

What are STICKY SENDER & GEOLOCATION MATCH ?##

“Sticky Sender” & “Geolocation Match” are settings for Pools.
A. Sticky Sender: By enabling Sticky Sender, Routee will try and select the same number for a given recipient if they have previous message history.
If Sticky Sender is disabled Routee will try to use different phone numbers as long as this is possible within a given pool rather than try and use the same.

B. Geolocation Match: By enabling Geolocation Match, Routee will try to select a VN that matches the destination country.
Specifically for the US only, Routee will try to select a SenderId based on the Area Code or Overlay Code matching.

If Geolocation Match is disabled, Routee will select the most suitable Virtual Number for the destination country.
You can also set a default country for Geolocation Matching. This is useful in cases where the country of the destination number does not match with the country of any of your Virtual Numbers in your Pool. In this case a Virtual Number from the country you have set as default will be used as the sender id.

What is the Multiple Sender setting?

Multiple Country setting makes it possible to handle more complex scenarios dynamically as users from different countries are added to the pool. Sender id's, keywords and short codes are selected dynamically according to the country of the recipient of the message sent through the /pools/my/{poolId}/sms endpoint.

What is Default Country setting?##

Default Country is used as a fallback option to ensure the deliverability of the message.
Routee accepts a country code in ISO 3166-1 alpha-2 format as 'defaultCountry' parameter.
If set, then Routee will use a Number from this "defaultCountry" parameter as sender, in case there is not a suitable option (eg a number from the same country -Geomatch- or a sticky sender -Sticky- for the recipient).

What is a Priority Country?##

A priority country is a country that is preferred by the pool, over other countries, when providing a virtual number. Usually, these countries are countries with networks and operators that have high coverage worldwide.

Alphanumeric Sender ID#

Alphanumeric Sender IDs are used as a fallback option to ensure the deliverability of the message.
In case there is not a suitable option in the Number selection, Routee will use this value of Alphanumeric Sender ID parameter to terminate the message. There is no additional cost when sending an SMS to countries that support this feature.

Also, you can define specific Alphanumeric SenderId's for a pool and send messages with that SenderId using "poolStrategy" parameter on the send SMS operation.

🚧

Note that if you have SMS-capable numbers from that country in your Messaging Service pool, Routee will use those instead.

Scaler##

Scaler distributes your outbound messaging traffic evenly across the phone numbers in your Messaging Service to help you handle higher messaging volume. When a message is sent from your Messaging Service, the From number is selected from among the phone numbers not currently being used to send a message.

Routee will prioritize any existing Sticky Sender mappings first then select the next available phone number from your Messaging Service that has the least amount of mappings.

What can I do with Pools?##

With the Pool feature, you can group your Virtual Numbers in different Pools (blocks) that share similar characteristics.
You can enable Sticky Sender and/or Geolocation Match for each of your Pools.
Then you can send an SMS message to a destination number by providing a Pool of numbers (its ID) instead of a specific Virtual Number. This will allow you to communicate with your end customers ensuring that they will receive messages from the same Virtual Number.

How to use it?##

In order to use the Pool functionality you have to complete the following steps:

1. Buy Virtual numbers
2. Create a Pool
3. Set the settings of each Pool (Sticky Sender, Geolocation Match, Multiple Sender)
4. Assign a Virtual Number to an existing pool. A Virtual Number can be assigned to only one Pool.
5. Send an SMS message to a destination number using a specific Pool as SenderId

How to Opt-Out using Pools?##

The opt-out functionality works together with the Pool feature.
Routee is capable of recognizing special keywords/terms in the reply message of your end-customers such as:

• STOP
• STOPALL
• UNSUBSCRIBE
• CANCEL
• QUIT
• END
• UNSTOP
• START
• YES
• HELP
• INFO

and doing a specific action (unsubscribe, subscribe, or get help) to this user, based on the keyword he sent to the Virtual Number.

When you try to send an SMS message to a user from a Virtual Number that he has previously Opted-Out of, the message will not be delivered. The status of those messages is: Undelivered with detailed status: Opted-out.

The user is able to re-enable (Opt-In) and receive messages from a Virtual Number that has previously Opted-Out by sending specific keywords: UNSTOP, START, SUBSCRIBE, YES.

Additionally, your end users are capable of receiving extra information about your provided service by sending keywords such as: HELP, INFO

The keywords for opt-out are: STOP, STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT
The keywords for opt-in are: START, YES, UNSTOP
The keywords for help are: HELP, INFO

🚧

The same Virtual Number cannot be assigned to two different Pools at the same time. To assign the same Virtual Number to a different Pool you have to unassign (remove) the Virtual Number from the existing Pool first before you are able to assign this Number to another one.

🚧

Because Opt-Out works with Numbers, in case a Number is deleted (eg. Number could not be renewed because out of balance) from your account for any reason the Opt-Out mapping of the recipients with the Number will be lost.

Pool settings flow##