question.json
- Rodolfo Melia
- Shrab Sahota (Unlicensed)
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.
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 here for more details of how POEditor is used with C4C.
JSON Question Structure
JSON Code Example 1 - Nested Keywords And Value
"factor1": {
"options": {
"Effectiveness": "",
"Privacy": "",
"FewSideEffects": ""
}
}
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.
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.
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 | 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 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
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.