# Survey App Test on Alexa

## Objective

This document will help you use the Survey Skill feature of the VoiceWorx platform to create an Alexa skill app.

## Steps

The following shows the general steps/activities that will be carried out in setting up the survey skill. **Note:** It is advisable to use same email for signup across the 3 channels below. Step 1 -3 below are required.

1. [Sign up for Alexa account](http://alexa.amazon.com/)
2. [Sign up for Alexa developer account](https://signin.aws.amazon.com/signin?redirect_uri=https%3A%2F%2Fus-east-2.console.aws.amazon.com%2Fconsole%2Fhome%3Fregion%3Dus-east-2%26state%3DhashArgs%2523%26isauthcode%3Dtrue\&client_id=arn%3Aaws%3Aiam%3A%3A015428540659%3Auser%2Fhomepage\&forceMobileApp=0\&code_challenge=9nNXzyrNIGZEa88E12gdwP_z_GcXjUlexn0VjUc6Z_s\&code_challenge_method=SHA-256).
3. [Sign up for VoiceWorx platform](https://portal.voiceworx.ai/Account/Login?ReturnUrl=%2F)
4. Ensure you Login with Amazon (LWA) <https://developer.amazon.com/alexa/console/ask> account is setup by your admin. If you are the account admin, you can follow this instruction to set it up.
5. Setup Survey Content

* Create New Survey Content
* Design the Survey Content
* Test the Survey Content
* Schedule the Survey Content

1. Setup Survey App
2. Publish Survey App on Alexa
3. Test skill on Alexa.

## Setup Survey Content

## Setup Survey Content

Login to the VoiceWorx portal at [https://portal.voiceworx.ai](https://portal.voiceworx.ai/)

1. The first step to create a Survey App is design Survey content. To Configure Survey, on the **Content** menu, Click on ‘**Survey**’.

![](/files/-Ml9UitwwcegsCT2DSrN)

Survey Skill home page will be displayed. Now create a new Survey Skill now. Follow the steps.

### Create New Survey Content

1. This page would display the Survey list. Initially, the list would be empty, but the purpose is to create a new Survey content. So, click on add button in top right corner. ![](/files/-Ml9Uitx6BDAgvfsH1GD)
2. Provide following details in the Add Survey dialog box:

**Survey name** :\<Any Name>

**Survey logo**: Optional

**Description:** \<Any Description>

**Restrict Survey Custom Bot**: Fill this field only if the Survey has to be restricted to a certain app.

**Require Schedule**: Enable / Check the box.

**Status**: Open

**Date Open**: \<No next date>

**Date Expire**: \<No previous date>

**Click**: Save

![](/files/-Ml9UityCxIVBPi-nrz_)

1. The Survey is created and displayed in the Survey list page.

![](/files/-Ml9UitzRUeO4iLuh0tG)

### Design the Survey Content

1. Click “**Design**” to create a Design Survey for newly created Survey.

![](/files/-Ml9Uiu-VUTgxZ3Bg2nk)

1. Choose the type of question needed from the Survey Designer by drag and drop the control.

![](/files/-Ml9Uiu0d42MxnYB3WF6)

1. Click the Edit icon to change the question and answer and then click “**close**”.

![](/files/-Ml9Uiu1pMWpYEVNIj-z)

1. To create another question of the same type you can also click the Add (+) and to delete a question click the Remove (x) icon. Once the survey designer page is complete, click “**Save**” and “**Exit**”.

![](/files/-Ml9Uiu2VV-7yjtDT9hd)

### Test the Survey Content

1. Click “**Test**” to run the survey content.

![](/files/-Ml9Uiu3wT1lGDoku8eR)

1. ChatBot opens with a welcome message. To begin the chat, use the command “**take survey”.** The ChatBot provides the option to start all the available surveys. Invoke the survey as per the provided suggestion in ChatBot. If you are not the creator of the Survey, you might receive following messages.

![](/files/-Ml9Uiu4caayG-DRKv_g)

The message “The survey has been closed by your administrator”, It occurs because the Survey is not **live** yet. Let us now finish the additional setup so that other users can participate in the survey. Survey has 3 statuses basically:

* 1. **Open**: Survey is created and is under design, so the users cannot access survey yet.
  2. **Closed**: Survey is now closed. Survey status is changed to Closed after the scheduled time period.
  3. **Live**: The participants now participate in the Survey.

### Schedule the Survey Content

1. VoiceWorx supports a parameter “**Require Schedule**” for survey, which determines whether the Survey is available for anyone or requires invitation from the Admin to be able to participate in the Survey.

**Require Schedule: Checked**, only invited employees, for whom the Survey has been scheduled can participate. Invited employees can participate in the survey over the scheduled time period only.

**Require Schedule: Unchecked,** anyone in the organization can participate in the Survey.

1. For this document, we are demonstrating the Require Schedule: True scenario. Enable the “**Require Schedule**” field and click “**Update**”.

![](/files/-Ml9Uiu5qMAFIjSJMt5k)

1. Click “**Schedule**” to create Survey Schedule.

![](/files/-Ml9Uiu6tLjQCuDKAgdT)

1. Click “**Launch Survey**”.

![](/files/-Ml9Uiu7qrZkzVe0BauL)

1. The Survey Status would change to “**Live**”.

![](/files/-Ml9Uiu89oo176gMm13Q)

1. Now, we have to invite the employees for participating in Survey. In an organization, we can schedule this survey for every employee. Using the left navigation menu click “**Administration**” and then click the “**Invite Users**”.

![](/files/-Ml9Uiu9ByPNbj-C1FtS)

1. Complete all the fields with the details of the employees and click “**Send Invite**”.

![](/files/-Ml9UiuAHFerYw9vHk9D)

1. The invited user would be listed in “**Manage User Invitations**”. Repeat the same to invite another user.

![](/files/-Ml9UiuBbFEZgL65t3PQ)

1. Using the left navigation menu click “**Content**” then and select “**Survey**”.

![](/files/-Ml9UiuCFr2gyaABrQv5)

1. Click “**Schedule**”.

![](/files/-Ml9UiuDB0oRIZk5qFLx)

1. Click “**Schedule New Employee**”.

![](/files/-Ml9UiuE-uUUpASKbOpr)

1. Select the name of the employee for the “**Employee name**” dropdown field, the end date of survey and click “**Save**”.

![](/files/-Ml9UiuFSXijGGvIYqOh)

1. The Employee Name, status, start and end date of the Survey will be displayed. You will be able to view whether the employee has participated in the Survey or not on the basis of the Status value.![](/files/-Ml9UiuGsZTuVGuFS_GJ)

## Setup Survey App

1. To create a survey app, use the navigation menu on the left and select “**Custom Apps**” then select “**Manage Apps**” then click on “**Create New Custom App**”.

![](/files/-Ml9UiuHXEvNyjExFsSw)

1. A popup screen will appear as shown below.

![](/files/-Ml9UiuIq_WlFsvMRxZZ)

1. Add Custom Skill by doing the following:

**Name:** Survey Test

**Custom Skill Type**: Survey

**Category**: None

**Click**: Save.

1. You should see the screen as shown below:

![](/files/-Ml9UiuJKFplOOn1Tlr_)

## Publish to Alexa

1. To publish to Alexa, in the top menu tabs select “**Publish**” then click “**Add Skill Publishing**”.

![](/files/-Ml9UiuKaE03t_13oOCw)

**External Skill Name**: Survey Skill. (This will be the name of the skill in Alexa. Therefore, make it unique and different from the names of your other skills in Alexa.)

**Skill Type**: Survey

**Channel**: Alexa

**Skill Invocation Name**: Take Survey. (This will be what users say to launch your skill in Alexa. It must be in lower case alphabets cannot contain **START, BEGIN, STOP, EXIT, LAUNCH** and cannot contain number or special characters.)

**Uncheck the following**: Require account linking, Auto Publish

**Optional**: Replace all placeholder values in all “Message”. Uncheck all the settings shown in the second image below.

**Click**: Publish.

![](/files/-Ml9UiuLCceDMcnmsfrc)

![](/files/-Ml9UiuM5AQWzHyZ5R_J)

1. Once in Publish Skill to Amazon Alexa, select and do the following:

**Selected Skill**: Survey Skill

**Select Amazon Account:** LWA Config

Select the LWA account setup by your admin or the one you set up in step 4 above.

**Click:** Publish to Alexa.

![](/files/-Ml9UiuNETL4nBqKhVbG)

![](/files/-Ml9UiuO0cCaNXHTxtFB)

1. On the resulting screen, ensure that a success message shows for the publishing steps before clicking the “**Go To Alexa Skill**”. If success message not shown, click “**Go To Skill Publishing**” to fix any issue shown in publishing result.

!\[Graphical user interface, text, application

Description automatically generated]\(/files/-Ml9UiuPtJUmr1-FHH4L)

1. On the Alexa skill page, ensure “**Full Build Successful**” message is shown in bottom right corner before starting to test skill.

![](/files/-Ml9UiuQpMx0FfEJv-_8)

1. Go to “**test**” tab in the top menu, then below “**test**” tab change the skill test status from “**Off**” to “**Development**”.

![](/files/-Ml9UiuR6vfQBOaCf-GS)

1. Invoke skill by typing the invocation name (take survey) inserted in the publishing step in Voiceworx. If the invocation is successful, your configured welcome message will be displayed in the developer console.

![](/files/-Ml9UiuSOfw6QWMzGq7d)

Congratulations!

You have successfully completed building a Survey Skill Test on Alexa.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ixhello.com/ixhc/apps/survey-skill-test-on-alexa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.