Versions Compared

Key

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

A very popular option that works in any location is to set up an Android Gateway using systems like Telerivet and a local SIM and Android device. This is our recommended approach to setting up a gateway for CommCare.

...

If you want to set your Telerivet pricing to a non-free plan, make sure that when you use your credit card to add funds to "Select a plan" that you want to use. 

...

Set Up A CommCare Account

Once you have a phone and set up that meets this criteria, log into CommCare

  • Navigate to Messaging -> SMS Connectivity in your project space.

  • At the bottom of this page, click "Add Another Gateway". 

...

  • 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

Managing Your Telerivet Gateway

Setting up Back-up Connectivity

By default, Android phones won't automatically switch from Wi-Fi to mobile data if the phone is connected to the Wi-Fi network but the Wi-Fi network isn't connected to the internet. The Telerivet Android app lets you override that. From the Phone Settings screen in the Telerivet Android app, scroll to the bottom and enable "Network failover". Then Telerivet will automatically switch the phone from Wi-Fi to mobile data if it can't connect to telerivet's servers via Wi-Fi.  This may use more airtime but will result in a more reliable connection.

...

Once you have a phone and set up that meets this criteria, log into CommCare

  • Navigate to Messaging -> SMS Connectivity in your project space.

  • At the bottom of this page, click "Add Another Gateway". 

...

  • 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

Managing

...

Managing Stored Message Volume

It's important to be aware of the maximum number of stored messages that your Telerivet plan allows. For example, the Test Telerivet plan only allows 500 messages to be stored in the account, so after sending and receiving 500 messages total, the account will stop sending new messages until old messages are deleted.  To have your Telerivet account automatically delete old messages, you can update the "Message Retention" setting for your Telerivet project (Dashboard -> Edit Settings).

...

You can read more here about Telerivet's limits here. As a note:

...

limits

...

Outbound SMS message do have rate limits, based on the gateways capacity. Shortcodes do not have the same rate limits.

Increasing your rate limit: The rate limit does not depend on your paid Telerivet susbcription, but it can be expanded by downloading Expansion packs from the Google Play store. You can see more instructions here.

Issues with sending: If there are problems with CommCareHQ and messages can't be sent from the gateway to CommCareHQ immediately, Telerivet will retry failed webhooks periodically for up to a day.

...