About SMS Gateways

SMS gateways are used by CommCareHQ to send and receive text messages.  Each SMS gateway is represented by a phone number - this could be a long code (e.g. +1-555-123-4567) or a short code (e.g. 13341). normally a gateway is setup for each country, but some gateway providers will let you send messages to many countries. 

SMS Gateway Options with CommCare

There are different ways that you can se up your Gateway with CommCare.

Gateway Considerations

Potential Costs

Gateways will typically require an additional cost to an organization outside of their CommCare subscription. Depending on your setup and gateway, these costs may include the following:

• Purchase of the smartphone

• Maintenance of a phone number or active SIM card

• Assuring the gateway has sufficient credit

• And may include subscription costs of the Gateway provider

In addition, CommCare also charges an additional $.01 (US) per message on all incoming and outgoing messages. More information can be found here: CommCare Subscriptions & Pricing FAQs | Fees for SMS or here: https://www.commcarehq.org/messaging-pricing .

Normally, it is not recommended to use an international SMS gateway for a live project because delivery rates tend to be worse. Experience has shown that using an in-country gateway leads to better delivery rates. However, if you test with an international gateway and are pleased with the results it might be an option for you as long as you understand that delivery rates might be lower and may change over time.

Important Considerations

When setting up your gateway, it’s important to keep in mind the following areas:

• Gateways act as a pass through. Delivery of SMS messages depends on the reliability of the local mobile operator. Gateways cannot send messages if they are offline or guarantee that SMSes are delivered on time.

• In-Country Regulations: Some countries have regulations related to the volume of SMS that you send. It’s helpful to look these up as you set up your gateway.

• Volume: If you're planning on sending more than 60 SMS per minute, you will likely need a short code via a Commercial SMS Gateways . Short codes allow for higher volumes of SMS and trying to send more than 60 SMS per minute with a long code might end up in less reliable delivery rates.