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

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.