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

This Skill gives the Digital Person the ability to conversationally schedule a Microsoft Outlook meeting. The Skill is triggered by saying Create/Setup/Schedule (an event)/(a meeting). This skill uses the Microsoft Office 365 Graph API to find people in an organization and get their calendar information.

In order to create an event, the user must provide a date, time, and title. In response to the user's keywords representing dates and times, a markdown graphic is displayed, showing the event on their calendar. After creating the event, the user may invite other Microsoft users or groups to attend the event. By default, a 30 mins meeting is set up which can then be edited from Microsoft outlook if needed.

This skill is:

  • Built and owned by Soul Machines Ltd.

  • Only supported in English.

  • Powered by the Microsoft Graph API

Supported Phrases

To set up a meeting users can schedule a date by providing the day, month, and/or year. Users can also specify phrases such as "today", "tomorrow", "noon", “next monday”, or certain US holidays to schedule events.

Expand
titleBelow are the supported US holidays:
  • New Years' Day

  • Valentines Day

  • Martin Luther King Jr. Day

  • Presidents' Day

  • Saint Patrick’s Day

  • Easter

  • Memorial Day

  • Juneteenth

  • Independence Day

  • Labor Day

  • Columbus Day

  • Veterans' Day

  • Halloween

  • Thanksgiving

  • Christmas Eve

  • Christmas Day

  • New Years Eve

Limitations

  • The current version of the skill cannot edit or delete events. If you would like to edit or delete an event, you must log on to Microsoft Outlook and make changes there.

  • The current version also does not support adding multiple users in the same sentence. If you would like to add multiple users quickly, make sure they are all a part of a Microsoft Outlook Group and you can add the group to an event.

  • The skill does not warn if the event occurs on a weekend or holiday.

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.

Image Added
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.

Image RemovedImage RemovedImage Added

Image Added

Supported form questions:

  • Short Answer - When you expect a short answer for 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 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.

Image Added

Image Added

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:

Image RemovedImage Added

Field

Type

Description

Google Form ID (required)

TEXT

Google Form ID to be used in the survey.

Text to read to the user before starting (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.

Table of Contents