Skill - Google Forms Survey
Skill Type
Base Conversation
Overview
With the Google Forms Survey skill, you can conduct a survey about the services you provide as part of the interaction with the Digital Person. With this Skill, you can create a Google Form survey about the services they provide as part of the interaction with the Digital Person. If the user wishes to skip a non-required question, they may say "skip" or “next”. When a user requests to repeat a question, both the question and the options are repeated.
The survey is triggered when the user requests the survey form by saying:
start survey
survey
begin Survey
start quiz
begin quiz
submit feedback
share feedback
Note: If you would like to explore additional training phrases, please contact us.
This skill is:
Built and owned by Soul Machines Ltd.
Only supported in English.
Powered by the Google Forms.
Limitations
The Google Forms Survey skill doesn't work with the Transcription Skill and Translation Skill if added to the same project.
The survey options are presented as options cards, the user should only click once. Does not support double click.
Skill Demo
Google Forms Survey Skill as Base Conversation
The Google Forms Survey Skill is available as an intent matching skill or can also be used as a base conversation, this will start the survey immediately after the Welcome message.
Note that the compatibility of the other skills with Google Forms Survey Skill as the base is unknown.
Creating a Google Form
The Google form created must be in a certain format for the Digital Person to be able to read out the questions coherently and also to accept the answers from the users hence we support only 4 types of questions.
Supported form questions:
Short Answer - When you expect a short answer to the question. Within this question type the additional Description and Response Validation options are not supported:
Paragraph - When you expect a longer answer to the question.
Multiple Choice - When you want to give the user limited options to choose from. These are easier to analyze afterward as these standardize the answer format with no room for interpretation.
Checkboxes - Answers can be ticked. One or more answers are ticked, including “Other” for short answers.
Linear Scale - When you want to collect the user’s opinion numerically on a scale. You can change the scale, but it must start with either a 0 or a 1, and can go up to 10.
Liner scale questions must include label descriptions identifying the extremes:
Title and Description - These add a section to your form on the current page, however, only the description will be rendered by the skill
Sections - These add a section title and also put the section on a new page of the form, however, the DP ignores the sections, and the questions will be rendered continuously in the interaction
Adding an image to a question
You can add an image to a question for the supported questions.
In Google Forms, open a form.
Click a question.
To the right, click Add image.
Upload or choose an image.
Click Select.
Adding a description to a question
You can add an additional description to the questions which the Digital Person will read out but is not displayed in the survey.
Select a question in Google Forms.
Click on ⋮ More icon.
Select show Description.
Enter the description for the question.
In the screenshot below, the highlighted text is the description added to the question. The digital person speaks this text, which can only be viewed in the transcription window.
Adding images to options
Currently, images in options are not displayed for either the Web widget and Default UI, even if the Survey Skill sends the information. To display images as options, you should either implement a custom UI or contact your customer representative to request a beta version of web widget that does have images enabled. Soul Machines expects to have image support available in the default web widget in early Q1 2022.
In Google Forms, open a form.
Select a multiple-choice question.
To the right of the option, click Add image.
Upload or choose an image.
Click Select.
Google Form Settings
On the form settings tab, the following options should be disabled to allow users to access the form.
Obtaining Google Form ID
You will need the Form ID to connect to the Digital DNA studio so that the Digital Person can access the survey questions. From the Google Form, click Send, copy the URL, and note the Form ID.
As shown in the example below, the Form ID is part of the URL (in red):
https://docs.google.com/forms/d/e/1FAIpQLSeaR2jrUvL8ZJXx6SPKeDyEcIJIJTWWhaHZi3zgeMvOsJa9Ag/viewform?usp=sf_link
Skill Configurations
Provide the following information in the Survey Skill configuration screen in Digital DNA Studio. See Adding Skills to your Digital Person for detailed instructions:
Field | Type | Description |
---|---|---|
Google Form ID |
| Google Form ID to be used in the survey. |
Text to read to the user before starting required |
| Output phrase to be read before starting the survey. |
Text to read to the user after a valid answer |
| Output phrase to be read after a valid answer. Default phrase is: |
Text to read to the user after an invalid/unknown response |
| Output phrase to be read if the user responds with an unknown response Default phrase is: |
Text to read to the user after the user completes the survey |
| Output phrase to be read after completion of the survey. Default phrase is: |
Digital Person to read the options for choice questions |
| If set to |
Add scale descriptor to option cards |
| If set to |
Order Scale Question Option Card |
| Allows you to set the order of the linear scale question. |
URL for callback function when a survey question is answered |
| Enter a URL to the webhook callback that contains tailored responses based on the users input. See Adding custom responses (Advanced) for example. |
URL for callback function when a survey question is submitted |
| Enter a URL to the webhook callback that contains tailored responses after submitting the entire survey. See Adding custom responses (Advanced) for example. |
Allow images in options (NEEDS UI SUPPORT) |
| Set to true to display images in options. Images can be displayed only if the UI supports this feature. |