SMS gateways are used by CommCare HQ to send and receive text messages. Each gateway is represented by a phone number - this could be a full phone number (e.g. +1-555-123-4567) or a shortcode (e.g. 13341). Different types of gateways exist - use this page to determine which SMS gateway is most appropriate for your project.
The table below summarizes the four main gateway options that can be used for SMS projects. For most projects, understanding the high-level pros and cons is sufficient for determining which gateway option to adopt.
Dimagi Connected Gateways
Ideal option for larger scale projects in countries that are supported.
Review the Dimagi Global and In-Country Gateways table below to determine if your country is supported.
Ideal for short term, small pilots and projects
Use an Android phone to send and receive messages.
New In-Country Gateway
Ideal for large-scale initiatives and national campaigns
For guidance on identifying gateway options for a country, please contact us.
Dimagi Global and In-Country Gateways
Dimagi Global and In-Country Gateways are always available for use without setup time/cost, and Dimagi manages the relationships with these gateway providers. In the table below are our existing connected gateways.
On CommCareHQ, choose Messaging -> SMS Connectivity to choose your gateway. See Setup SMS Connection for Project for more detailed instructions.
|GRAPEVINE-ZA||Grapevine is a South Africa-based gateway. Users can send messages to this phone number for free (messages are reverse billed). The phone number for this gateway may change depending on which network provider the receiving phone is using.|
|MOBILE_BACKEND_MACH||Mach is useful for sending messages to a wide range of countries, but currently only supports outgoing messages. The phone number will change based on the selected country.||Various Countries|
|MOBILE_BACKEND_MEGAMOBILE||Megamobile is a Philippines based gateway.||Philippines|
|MOBILE_BACKEND_TROPO_US||Tropo US can send and receive messages using a US-based phone number. Sending to international countries will be more expensive. The phone number for sending/receiving messages is +1 617 575 2704.||Various Countries, but US number|
|MOBILE_BACKEND_TROPO_CANADIAN||Tropo Canada uses a Canadian number to send and receive messages. It is sometimes more reliable than Tropo US for international messages. Sending to international countries will be more expensive. The phone number for sending/receiving messages is +1 514 400 9265.||Various Countries, but Canadian number|
|MOBILE_BACKEND_TWILIO||Twillio is another US-based phone number. International messages will be more expensive. Rates to a given country may differ between Twilio and Tropo. The phone number for sending/receiving messages is +1 617 600 0456.||Various Countries, but US number|
Unicel is an India-based gateway.
|MOBILE_BACKEND_YO||Yo is a Uganda-based gateway. The shortcode for this gateway is 8291.||Uganda|