Versions Compared


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

Setup an SMS Survey Reminder

Now that our reminder is setup, we can test it using our phones and view it in the reminder calendar.  


Similar to how was done in the Messaging Beginner Tutorial, use the existing registered pregnancy or create a new pregnancy case and flag that case for high risk symptoms.  Please make sure the phone numer you enter is unique - that is, it is not used by any other case or mobile worker in the system. 


Duplicate Phone Numbers: Each phone number used for two-way (SMS Survey or Keyword) communication must be unique within and across projects. This is because CommCareHQ uses the phone number to determine which case or mobile worker an incoming message is associated with. If your phone number is not unique, you won't be able to verify the phone number for a mobile worker (Setup a Mobile Worker for Messaging), and CommCareHQ won't send out any surveys for that case or mobile worker.

If a survey is not sent out due to a duplicate phone number, this will appear in the Reminders In Error report, which is in the Messaging tab.


  1. First create a mobile worker (Setup a Mobile Worker for Messaging) and make sure you verify the mobile worker's phone number.  This is necessary for two way surveys.  
  2. We now need to put the mobile worker in a Group  Go to the Users tab and choose Groups on the left pane.  Then type a group name (ex. Test Group), then click on the Create Button
  3. Add you test mobile worker (the one with the verified phone number) to the group and click on Update
  4. Go to the Messaging tab and choose Broadcast Messages in the left pane.
  5. Click on + New Broadcast to create a new broadcast. 
  6. Setup the broadcast to send to Test Group immediately as shown below.  Choose the Clinic Visit Check survey to be sent. 


Congratulations, you've completed the SMS Survey tuturial!  Use the Messaging- SMS in CommCare page to read more about messaging and other functionality.