Follow these steps to enable Messaging for a mobile worker. For each mobile worker, we need to verify that the entered phone number is a real number. This verification occurs by sending a message to the worker's phone number and having them respond to that message.







Troubleshooting and Notes

  1. I see an "Already In Use" message and I can't click the "Verify" button.
    This means that the phone number is already in use somewhere else in CommCareHQ. This could be in the same project or in another project. Unfortunately, Messaging only support a phone number being used once in the system. You'll need to delete the verified phone number from any other mobile workers (potentially in another project) and close any Messaging-enabled cases that use that phone number. 

  2. I don't receive a verification message on my phone
    Depending on your country and carrier, we may not support sending messages to the entered phone number. 

    In India specifically, your number may be registered on a Do-Not-Disturb (DND) list. Before receiving any message from Dimagi, you'll need to opt-in to receiving messages from us. Send the message "START" to +917760962755. Once this is done, you can click the "Verify" button again to send another message. 

  3. My response is not received (or I can't respond to the message I get). 
    Depending on which country you're in, you may not be able to respond to the confirmation message that you receive. We're still working on our SMS coverage and what is available depends on the country (and potentially the carrier you're using). 

    If you are using a Telerivet gateway and you can't respond to the message you receive, then the connection is not configured properly.  Double-check the Telerivet setup page to make sure that you configured everything properly in CommCareHQ and in Telerivet.  

    If you are not using a Telerivet gateway and you can't respond to the message you receive, you could try sending "123" to one of the following numbers:
    1. In India, send a message to +919845204984. Due to government regulations, you cannot respond directly to the phone number which sends you messages. 
    2. In other countries, the system we use to send outgoing messages may not support incoming messages. To get around this issue, you can directly send a message to our US incoming SMS phone number (+1 617 575 2704). Note: Sending a message to this number may incur international messaging fees. This should only be used for initially verifying the phone number (and not for interactive SMS surveys).


Special Note about SMS in India

In order to send SMS/IVR to an Indian number, that number may need to opt-in to receive SMS/IVR. It's a best practice to have each Indian number you want to send an SMS to follow the opt-in process. Details can be found here: SMS and IVR in India

  • No labels