You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

This tutorial will describe how to setup an SMS survey for your project.  This builds on the application already developed in the Messaging Beginner Tutorial, so please complete that tutorial before continuing.   We will add an SMS survey to that application that will check with the mother if she has visited the clinic.   

Learning Objectives for SMS Survey Tutorial

In this tutorial, you will learn the following:

  • Creating an SMS Survey in CommCareHQ
  • Sending an SMS Survey in a Reminder

Tutorial Contents

  1. SMS Survey Tutorial
  2. Create an SMS Survey
  3. Setup an SMS Survey Reminder
  4. Test and Verify the Survey


Creating an SMS Survey

An SMS Survey is just another form in CommCareHQ.  You can have the same logic you have in forms (display logic, validation logic).  You can also use the survey to update cases as you can with regular CommCareHQ forms.  The only limitation on SMS surveys is that only some question types will work over SMS (text, label, numbers and single and multiple choice).  

Setup the SMS Application

We need to add a new application to the existing project created for the Messaging Beginner Tutorial.  This application will contain all the SMS surveys so they don't appear in the existing health worker application. 

  1. Add a new application to the project by going to the Applications tab and choosing New Application -> Blank Application.  
  2. Update the first module and set the name to Pregnancy Surveys
  3. And then set the case type to pregnancy.  This module will contain all surveys related to pregnant women.  

Add the Clinic Attendance Survey

This tutorial assumes you already know how to create a form with hidden values.  

  1. Rename the Untitled Form to Clinic Attendance Survey and add questions so that it resembles the following. 

    The following calculations and display logic is used in the form:

    Question ID or Choice ValueTypeLabelRequiredDisplay LogicCalculation
    attend_clinicSingle AnswerDid you attend the clinic today?Yes  
    visited_clinic_labelLabelGreat! Speak to your health worker about the results. /data/attend_clinic = 'yes' 
    no_visitLabelIts important you visit the clinic. Please try visit next week.  /data/attend_clinic = 'no' 
    send_clinic_visit_reminderHidden Value   if(/data/attend_clinic = 'yes', 'no', 'yes')
  2. Save the form and configure the case management for the form.  The form will be setup to update or close cases.  We'll only save send_clinic_visit_reminder.  This will then affect the reminders that are based on this case property.  








introduce you to using Messaging within your CommCare application.    This will be based on a very simple application (registration of a pregnant woman and tracking of pregnant women.).  We'll add some basic messaging to the application including a welcome message to registered women, a message to remind women to visit the clinic if she has danger signs and messages to health workers to remind them of delivery dates. 

  • No labels