...
- Log in to your project space in CommCareHQ, and navigate to Messaging -> SMS Connectivity. Under "Create Another Connection", choose "Telerivet (Android)" and click "Create Another Gateawy".
Enter the following required fields (the rest are optional):
Field Value to Enter Name Enter a short but descriptive name for you to identify this connection. Reply to Phone Number Add the phone number of the gateway that you are using. API Key Enter the value from your Telerivet account obtained from step 1.3 above. Project ID Enter the value from your Telerivet account obtained from step 1.3 above. Phone ID Enter the value from your Telerivet account obtained from step 1.3 above. Webhook Secret Enter the value from your Telerivet account obtained from step 1.4 above.
- Then save.
- For most projects, you will want to click "Set As Default" next to the Telerivet gateway. This will use the Telerivet gateway as the default gateway for any future SMS from this project.
...
Step 4: Read these Important Tips for using Telerivet with CommConnectCommCare Messaging
- When setting your gateway, check to see where your project falls under Telerivet's pricing. It is important to set up the right pricing structure before your project goes live. For example, it's important to ensure that the number of contacts you will be sending to falls within the limit allowed on the account. 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.
- When sending outbound SMS, you may need to throttle the rate at which you send SMS in order to comply with regulations in the country you are sending. A good rule of thumb is to not exceed the rate of 1 SMS per second, though you should check with the regulations in the country you wish to send SMS. In order to enforce the rate limit, in the Telerivet Android app, go to Phone Settings -> Message Sending Parameters -> Delay after message sent (ms), and enter the number of milliseconds to wait between sending each SMS. For example, enter 1000 to send SMS no faster than the rate of 1 SMS per second.
...
- Here is a guide you can download to learn about how to maintain your Telerivet Android gateway through a CommConnect CommCare Messaging project.