Page Comparison

Skill Type

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

This skill is:

• Built and owned by Soul Machines Ltd.

• Only supported in English.

• Powered by the Google Forms.

Limitations

1. The Google Forms Survey skill doesn't work with the Transcription Skill and Translation Skill if added to the same project.

2. 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.

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 anew 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.

1. In Google Forms, open a form.

2. Click a question.

3. To the right, click Add image.

4. Upload or choose an image.

5. 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.

1. Select a question in Google Forms.

2. Click on ⋮ More icon.

3. Select show Description.

4. 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.

1. In Google Forms, open a form.

2. Select a multiple-choice question.

3. To the right of the option, click Add image.

4. Upload or choose an image.

5. 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 Status colour Red title required	TEXT	Google Form ID to be used in the survey.
Text to read to the user before starting Status colour Red title required	TEXT	Output phrase to be read before starting the survey.
Text to read to the user after a valid answer	TEXT	Output phrase to be read after a valid answer. Default phrase is: Alright, the next question.
Text to read to the user after an invalid/unknown response	TEXT	Output phrase to be read if the user responds with an unknown response Default phrase is: I'm sorry but I did not understand that. Please choose from the given options.
Text to read to the user after the user completes the survey	TEXT	Output phrase to be read after completion of the survey. Default phrase is: Thank you that completes the survey.
Digital Person to read the options for choice questions	Dropdown	If set to true the Digital Person will read all the options in the multiple choice question.
Add scale descriptor to option cards	Dropdown	If set to true, the upper and lower extremes are added to the option card for a linear scale question.
Order Scale Question Option Card	Dropdown	Allows you to set the order of the linear scale question.
URL for callback function when a survey question is answered	TEXT	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	TEXT	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)	Dropdown	Set to true to display images in options. Images can be displayed only if the UI supports this feature.