Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


SMS gateways are used by CommCareHQ to send and receive text messages.  Each SMS gateway is represented by a phone number - normally a gateway is setup for each country, but some gateway providers will let you send messages to many countries.  Details on our SMS gateways can be found here (Gateway Options to Set up an SMS Project).  

If you don't want to use one of CommCareHQ's shared Gateways, or if you can't because connectivity isn't working with the countries or networks of your recipients, you can setup your own Android SMS gateway with Telerivet, and integrate it with CommCareHQ.   An Android SMS gateway will use an Android phone and its SIM card to send and receive messages for CommCareHQ.



Before proceeding, you will need an Android phone with an active SIM card. All SMS will be sent and received from this phone and SIM. Your phone will be charged according to your plan for sending and receiving SMS, so you will need to keep the SIM card's account balance topped up in order to help prevent interruptions of service. Click here to see the Telerivet FAQ which has important information, including which phones are recommended to be used.

To get started, navigate You should only consider setting up a Telerivet Android gateway if:

  1. You have an Android phone that you will be using exclusively for this purpose
  2. The phone will always be on and charged
  3. The phone will always be connected to wifi (or optionally, mobile data, though that may be more expensive)
  4. You will monitor the phone's balance and ensure it always has enough credit to send and receive SMS

If you have a phone that meets those criteria, you can get started by navigating to Messaging -> SMS Connectivity in your project space. At the bottom of this page, click "Add Another Gateway":


Image Removed

CommCareHQ . CommCareHQ will then walk you through the steps to setup a Telerivet SMS gateway and connect it to your CommCareHQ project for sending and receiving SMS.:


Image Added

Step 2: Read these Important Tips for using Telerivet with CommCare Messaging


You still register your contacts in CommCareHQ the same way as you would if used any other SMS gateway. Information on registering mobile worker contacts is here, and information on registering case contacts is here.

Step 4 (Optional) - Share Your Telerivet Gateway with Another Project