What is Geomatch and how does it work?

Twilio's Messaging Service Geomatch feature automatically selects the best Twilio phone number from your Messaging Service for sending to your destination. This guide explains how the Geomatch feature works.

Messaging Services overview

Twilio's Messaging Services allow you to create a "group" of Phone Numbers for easier message sending to different recipients. Once created, you can use the Messaging Service SID for the From value instead of a single phone number, and Twilio will automatically select the best phone number for sending messages to each destination phone number. For full details, see Getting started with Messaging Services.

Country Code Geomatch

When sending a message using a Messaging Service SID, Twilio will automatically select a phone number from this service that matches the country of the To phone number. If your Messaging Service does not include a number from the same country as the destination, Twilio will attempt to send your message using a US-based phone number.

Notice: If your Messaging Service does not contain any local or US-based phone numbers, it will then try sending from a random phone number in the service. Your message will fail if there are no phone numbers in your Service that can deliver your message.

Area Code Geomatch

When sending a message using a Messaging Service SID to the US and Canada, Twilio considers geographic proximity and area codes when selecting the sending phone number. These messages will attempt to use a number from your Messaging Service that matches the local area code of the To phone number. If your Messaging Service does not include a number from the same area code as the destination, Twilio will attempt to send your message using a number with an overlay area code (an area code that services the same geographic region).

Notice: If your Messaging Service does not contain any local or overlay phone numbers, it will then try sending from a random US or Canadian phone number in the service. Your message will fail if there are no phone numbers in your Service that can deliver your message.

Configure Geomatch

To use Geomatch, simply add phone numbers to your Messaging Service that match the countries of your end users. This can be done via Console, or the REST API.

When a phone number of a new geographic country is added to your Messaging Service, Twilio will automatically select and remap Sticky Sender so that the From number can match the same country as your recipient's phone number.

Additional Resources

Have more questions? Submit a request
Powered by Zendesk