Adding a Multiple Choice question to a conversation

To create an Multiple Choice dialog:

1. In the Conversation editor, click Add Dialog.

2. Choose to create a new Multi Choice question, or use an an existing question (and optionally customize it). In the Dialog editor, choose either Multiple Choice (for new) or Existing Multiple Choice the Dialog type.

   

   Important: The Question or Question Name becomes the field name of the associated question stored in the database. The name always begin with q_ followed by the question or name. For example, How did you like your stay? becomes a field named q_how_did_you_like_your_stay. The database has a limit of 63 characters, which means the first 61 characters of the Question Name must be unique within your company.

3. (Existing Multiple Choice) Select the existing question: click Select a question and pick the question. You can scroll the list, or type parts of the question prompt or name. For example, type "5" shows all questions that have the number 5 in them; similarly, typing "Likelihood" shows all questions with that word in them.

   Selecting the question automatically fills in the existing question's prompt and responses. You may

   • not change the text of the responses

   • change the question

   • add keywords and pictures to the responses

4. Provide the question prompt. (For existing Multiple Choice, you may change the default question.)

   • Enter the text of the dialog.

   • To insert information into the dialog, choose one or more variables with the Insert Parameter dropdown. The drops down lists:

     • All fields provided in the invitation and fields associated with the business unit.

     • Last Response the respondent provided in the same conversation session. This response may have happened in a different Conversation but which branched from the original to the the current Conversation, as long as it happened in the same session. In the dialog text the parameter looks like {{CONVO.LAST_RESPONSE}}.

     • Response to an earlier question (Q-Field) in the same session. When choosing a Response you have the option of choosing the the result of Response rules, or the RAW response which is exactly what the respondent provided. In the dialog text the parameter looks similar to {{CONVO.q_mc_fieldname}}.

       

   • To add a picture, click the camera icon, then either drag the picture on to the tile or click the tile to select the picture on your device.

     

5. For settings:

   ​​

   1. Retry settings specify what to do when system does not recognize the respondent's response as being valid for the dialog type.

      • Maximum number of retries — Count of times the respondent may submit a malformed answer before the conversation gives up and sends an error message. For example, if the response is expecting an email address, but the respondent submits a name without the @, the respondent gets this number of retries before failing.

      • Retry message — Text of the message to send when the response was was invalid. This message repeats each time the respondent provides an invalid response, except the last time (based on the maximum number of retries).

      • Exceeded maximum number of retries message — Text of the message to send when the respondent repeatedly fails to provide the expected response.

   2. (optional) For channels that support formatting the choices into one or more rows, set the Number of columns to display on custom channel setting to number of rows to use. For example, to distribute the choices across five rows, enter a 5. The default (no value specified or for a value of zero) is 1 row.

      Note: For developers, this option is the "message": { "configuration_settings": { "items_per_row " }} parameter in the payload of the message.

6. (optional) Parse Failure specifies what to do when the respondent failed to provide a valid response. The default action is to do nothing and proceed to processing Post Conditions (if any). Otherwise, the navigation can immediately go to another dialog or conversation.

   

7. Select or create a Response Set that identifies the options the respondent may choose, such as "Yes or No".

   Tip: Many common responses already exist, such as "Yes or No" and "Very Unsatisfied, Unsatisfied, Neutral, Satisfied, and Very Satisfied." Once you create a new set, that set will be available for future questions.

   • Existing Response Set — Select an existing set to use already defined options. You may add keywords and pictures to the responses, but you may not add, remove, or alter options.

   • New Response Set — Create a new set of options and name the set.

   Each response includes:

   • Response — The text of the choice.

   • Picture (optional) — An image to show with the choice.

   • Keyword (optional) — One or more keywords the respondent may type as a synonym or short-cut. For example, for a "Yes" response, keywords might include "sure", "ok", "y", and "yeah".

8. For settings:

   1. Retry settings specify what to do when system does not recognize the respondent's response as being valid for the dialog type.

      • Maximum number of retries — Count of times the respondent may submit a malformed answer before the conversation gives up and sends an error message. For example, if the response is expecting an email address, but the respondent submits a name without the @, the respondent gets this number of retries before failing.

      • Retry message — Text of the message to send when the response was was invalid. This message repeats each time the respondent provides an invalid response, except the last time (based on the maximum number of retries).

      • Exceeded maximum number of retries message — Text of the message to send when the respondent repeatedly fails to provide the expected response.

9. (optional) Add the ' hide_replies' label to suppress the showing of the available options. Otherwise, when the label is missing, the dialog also prompts the list of available options.

   

10. Optionally, add pre-conditions that determine whether or not to present this dialog to the respondent. For more information, see Condition rules.

11. Optionally, add post-conditions that determine whether to say an acknowledgment message or navigate to another dialog or conversation. For more information, see Condition rules.

12. Click Add Dialog to save the dialog to the conversation.

    Optionally, Add another dialog to the conversation.

    1. When finished, click Add Dialog.

    2. Click Cancel to close the Dialog editor.

13. When finished, click Save.

You can now add another dialog to the conversation.