readme.md

SMSSurvey

SMSSurvey is a web application that expedites the sms-survey making process.
SMSSurvey is perfect for studies whose target audiences have texting capabilities.
Any question can be asked, and answers can have multiple parts, as well as numerical
limits placed upon them. Create surveys using the web portal and connect a phone with
an active simcard, and you can now conduct surveys!

Setting up

Requirements

SMSTools3

Once smstools3 is downloaded, compiled and install,
create the following directories in your /var/spool/sms folder

outgoing

checked

failed

incoming

sent

report

Then connect your phone and find what serial port it is connected too.
This will usually be connected to /dev/ttyACM0 or /dev/ttyS0. To find out,
diff the output of ls /dev/tty* before and after connecting the phone.

Now we need to connect the software to smstools3 driver.
Modify /etc/smsd.conf to include an eventhandler:

eventhandler=/var/www/SMSSurvey/textArtisan.sh

Settup is now complete! Now a survey must be created.

Creating a Survey

Click on the Questions tab
For every question click "Add a new Question". Then proceed to edit the questions.
Here you can signify how many answers you wish to have for each question, as well
as a minimum and maximum limit on the numerical values. You can even change
the order of the questions as needed.
Once your changes are done, submit and save.

Click on the Phones tab
Here enter in the phone numbers you wish to participate in the survey. This
can be a comma-separated list, so batch processing can be done here.

One you have submitted click on the Settings tab
Here you can change what type of messages you wish to have for different scenarios,
such as notifying invalid responses or stating if the survey has closed. The delimiter
to be used for answers can also be set here.
You can even set up time intervals for various events, such as how long
after a pre-reminder text the survey should begin, or to resend a message
if a person has not responded within a specified amount of time.

At this point the survey is now ready to go!
Go to the index page and click "start survey". When the survey is complete
go click end survey, and download the survey's csv file!

License

SMSSurvey by Cal-it2 is open-sourced software licensed under the MIT license