Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
hiddentrue

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.

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, customers can create a Google Form survey about the services they provide as part of the interaction with the Digital Person. The survey is triggered when the user requests the survey form by saying “start survey or survey or begin Survey”. 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.

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

survey-skill-video.mov

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.

Info

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

  • 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:

Adding an image and description to a question

Adding an image

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

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.

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 (required)

Status
colourRed
titlerequired

TEXT

Google Form ID to be used in the survey.

Text to read to the user before starting (required)

Status
colourRed
titlerequired

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.

Table of Contents