Gateway Options for SMS Projects

Owned by Gillian Javetski
Last updated: Jul 30, 2024 by Gillian Javetski
2 min read

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: or here: .

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 . 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.

 

Configuring SMS to be sent from CommCareHQ’s servers via an SMS Gateway

 

Configuring SMS to be sent from CommCareHQ’s servers via an SMS Gateway

Instructions

See https://dimagi.atlassian.net/wiki/x/XCrKfw on how to implement this functionality using the CommCare messaging feature and an SMS Gateway provider.

This is used for messages that are:

  • Asynchronous alerts or reminders

  • Batch messages sent out to many users at once

  • Messages that need to be sent from an anonymous or system user

  • Automated, interactive SMS workflows

Application Building Level of Effort

Interface is fairly user-friendly, but requires several hours of exposure before app-builders fully grasp all the details.

User Experience

Messages are delivered asynchronously. The messages typically originate from a “short code” assigned by the Telcom involved, and may be configured to accept user responses. The messages can be triggered by:

  • A specific date

  • Change in a user case property

  • A manual broadcast

Requirements

Requires activation of an SMS gateway in the country you are working in.

Dimagi adds a surcharge of $0.01 per message sent. Users must sync data with the server in order to trigger SMS messages.