Connecting your Alexa Skill
You can enable voice interactions using Alexa Skill by taking the following steps.
Create Alexa Skill
Register as Amazon Developer
Sign-up as a developer on https://developer.amazon.com
Create a new Alexa Skill
Go to Alexa Skills dashboard and click the Create Skill button
- Skill Name is what would be displayed to your users
- Default language should be English (US)
- Skill Type is Custom Interaction Model
Click on Create Skill button
- Choose Start from scratch
Click on Choose button
Build Your Alexa Skill
On the left panel, go to Interaction Model -> JSON Editor
Insert our Pre-Defined model
Make sure to change the invocationName field
{ "interactionModel": { "languageModel": { "invocationName": "<your skill invocation name>", "intents": [ { "name": "AMAZON.CancelIntent", "samples": [] }, { "name": "AMAZON.HelpIntent", "samples": [] }, { "name": "AMAZON.StopIntent", "samples": [] }, { "name": "AnyWord", "slots": [ { "name": "anything", "type": "phrase" } ], "samples": [ "{anything}" ] }, { "name": "AMAZON.NavigateHomeIntent", "samples": [] } ], "types": [ { "name": "phrase", "values": [ { "name": { "value": "AnyWord asdf {anything}" } } ] } ] } } }Click on Save Model
Click on Build Model
Configuration
- On the left panel, go to Endpoint
- Set Service Endpoint Type to HTTPS
- Set Default Address to https://healthbotskillsprod.azurewebsites.net/api/HealthAgentSkillFunction?code=OEW1J40971cfINu2fYzyNyDU9HjILa7f4JaPsQDuiGIUempiuF1XDQ==
- Select My development endpoint is a sub-domain of a domain that has a wildcard certificate from a certificate authority
Test
On this tab you can test your Skill integration by sending messages to your bot as if they were sent through an Alexa device.
Publishing Your Skill
Follow this Amazon tutorial to learn how to publish your skill.
Register Alexa Skill on Health Agent Dashboard
- Go to the main Alexa Skills page where you can find a list of all your skills
- Under your newly created skill, click View Skill ID
- Copy the Application Id (e.g. amzn1.echo-sdk-ams.app.deadbeaf-a1a1-b2b2-c3c3-deadbeaf1234)
- Go to Health Bot Service Management Portal
- On the left navigation pane, go to Integration -> Skills
- Paste Alexa Skill Application Id under Skills and click the Save icon
Additional Information
That's it! Your users are now able to perform voice interactions with your bot using Alexa.
Please refer to Amazon's developer documentation for best practices on how to build skills, and apply these guidelines to your bot scenarios.