Overview of Usage

Pulso ONG consists of three types of data

Participants

Only a phone number is stored for participants. They can be added to the system manually by a Pulso ONG administrator, or if a participant wishes to participate in a survey they can add their number to the database by sending an SMS to us containing JOIN (or UNIRSE), or to unsubscribe from surveys they can send LEAVE (or DEJAR).

Surveys

A collection of questions scheduled to send on a specific date. A survey can have an introduction message defined that is sent initially to greet the participant.

Questions

The questions defined for each survey. Questions are formatted using a syntax (see below) force the participant to choose one option, choose one-or-more options, or to give a freeform response. Questions are ranked to be sent in a specific order.

Question syntax

The question text is limited to 160 characters (SMS limit).

There are three available types of questions:

1. Choose one option

Include the options behind ) brackets, e.g.:

Have you worked in the US in the past 5 years? A) Yes, B) No

The responded can reply either A or B; if the system doesn't understand the response it will send the participant a message asking them to try again.

2. Freeform response

For a multiple-choice-style question, include the options behind ] brackets, e.g.:

Which abuse have you experienced (choose one-or-more): A] Fraud, B] Threats, C] Physical abuse, D] Verbal abuse, E] Extortion, F] Blacklisting, G] Human trade

The response can include any number of single letters with any kind of separator (A B C or A,B,C); if the system doesn't understand the response it will send the participant a message asking them to try again.

3. Freeform response

To allow a freeform response to a question, simply end the question with a question mark (?). E.g.,

How did you hear about your job?

Any reply will be accepted.