Overview
The questions file contains all the questions and their corresponding answers as options. This file does not represent the order in that questions are asked - it is merely an inventory of the questions that may be asked and their possible answers.
Which questions and in what order they are asked are controlled by the algorithm file.
This file also does not represent the way the question appears to the actual user of the bot.
The wording of individual questions is controlled by what is written in POEditor. Strings on this file are related to a term in POEditor, the tool used for translations and localisation.
To learn more about the C4C multilingual feature, click here.
Each question is defined by a keyword in double quotes and can have one or more options.
As in the example below, the question "factor1" (I'll give you some options to choose from. Tell me which one is most important to you when considering contraception.) has 3 options: "Effectiveness" (Efficient method), "Privacy" (Discrete method), and "FewSideEffects" (Method with few side effects).
...
| Info |
|---|
DEFINITIONS & TERMINOLOGIES Keyword: The data for this field can be found in the POEditor App, each question has a unique keyword. Options: These fields are the relevant answers available to the user to answer the question being asked. A question will always have a minimum of two options. |
| Note |
|---|
Please note the questions.json file is just a repository of all questions, the order in which questions are listed in the file is irrelevant as the algorthm.json file supplies the logic/order in which questions are asked. |
Please note you need access to the POEditor App in order to view all Keywords and Options used in the questions.json file. You can request access to the POEditor from your C4C Tecnical Administrator.
Click /wiki/spaces/DHM/pages/8814662 for more details of how POEditor is used with C4C.
JSON Question Structure
JSON Code Example 1 - Nested Keywords And Value
| Code Block |
|---|
"factor1": {
"options": {
"Effectiveness": "",
"Privacy": "",
"FewSideEffects": ""
}
} |
The following tables present the terms (keywords) available for the algorithm file:
Questions
...
Keyword
...
factor2
...
In this example, you will note the first keyword ‘factor1’ is followed by the nested keyword ‘options’ which subsequently lists the three values; Effectiveness, Privacy, FewSideEffects.
The question.json file makes a call to the POEditor App to return the human-readable text of the questions and answers that appear on the ChatBot or WebApp UI.
Below is a screenshot from the POEditor App, you will note the keyword ‘factor1’ is paired with the text in the right column, this is the text that is displayed to the user on the ChatBot or WebApp.
| Note |
|---|
Please ensure you maintain the json file structure and pay special attention to keep all strings you enter or update within “double quotations” marks. |
| Info |
|---|
Accessing The POEditor AppYou will need to request access to the POEditor from your C4C Tecnical Administrator. Click /wiki/spaces/DHM/pages/8814662 for more details of how to use the POEditor |
Questions
The algorithm.json file controls which questions are presented to the user based on their previous answers, however, the overall logic/order of the questions are shown in the table below.
Please note the actual text shown here may be different to the text you see in on the POEditor App.
Keyword (POEditor App) | Value (Actual text displayed on the ChatBot or WebApp) |
|---|---|
gender | How do you identify yourself? It helps me to better meet your needs. |
futurePregnancy | Do you want to be pregnant in the future? |
breastFeeding | Are you breastfeeding a baby less than 6 months old? |
age | How old are you? |
factor1 |
...
I'll give you some options to choose from. Tell me which one is most important to you when considering contraception.
Thanks for that basic information about yourself! Now I want to ask you a few more questions to understand what kind of contraception might be best for you… | |
factor2 | I'll ask these questions a few more times to really understand what you want. For example, if you might have trouble remembering to use your contraceptive on a daily basis, you might want a method that you can "Get and Forget"!… |
factors2vs1 | Compared to your first choice, '{{FACTOR_1}}', how important is your second choice, '{{FACTOR_2}}'? |
factor3 | Finally, which of the following |
...
things is most important to you? | |
factors3vs12 | Compared to your first choices, '{{FACTOR_1}}' AND '{{FACTOR_2}}', how important is '{{FACTOR_3}}'? |
Options
...
Methods
...
Keyword
...
Translation
...
Sterilization
...
Sterilization
...
IUD
...
IUD
...
IUD
...
IUD
...
Implant
...
Implant
...
Injectables
...
Injectables
...
POP
...
Progesterone Pills
...
COP
...
Combined Pills
...
EC
...
EC
...
Condoms
...
Condoms
...
Cyclebeads
...
Cyclebeads
Factor 1
...
Keyword
...
Translation
...
Effectiveness
...
Efficient method
...
Privacy
...
Discrete method
...
FewSideEffects
...
Method with few side effects
Factor 2
...
Keyword
...
Translation
for Factor2/2Vs1/3 Questions
Keyword (POEditor App) | Value (Actual text displayed on the ChatBot or WebApp) |
|---|---|
EasyToStop | Easy to stop using |
EasyToForget | I get it and I forget it! |
Effectiveness | Efficiency |
Privacy | Discretion |
FewSideEffects | Few side effects |
SelfAdministered | Self-administered |
...
Making changes
...
Keyword
...
Translation
...
EasyToStop
...
Easy to stop using
...
EasyToForget
...
I get it and I forget it!
...
Effectiveness
...
Efficiency
...
Privacy
...
Discretion
...
FewSideEffects
...
Few side effects
...
SelfAdministered
...
Self-administered
| Info |
|---|
Modifications should only be made by a qualified developer. |
| Note |
|---|
Never attempt to delete a question or options directly yourself, please contact the C4C Technical administrator to delete items. |
Adding new questions/options
This file is intended to be modified by a developer. If a new question or option is required
...
please contact your ‘C4C Technical Administrator’ and provide the name of the question and options. In case the option is for an existing question, indicate the question (keyword) in which the new option will be located.
Remove questions/options
If a question or option needs to be removed, contact the C4C technical administrator. Provide the keyword or name of the element to remove. Do not
...
attempt to remove the question directly, as this can damage the file.
...