How do I Publish the interaction model to Amazon Alexa

Owned by Rajkiran Alla (Deactivated), created
Last updated: Aug 25, 2021
5 min read

This document outlines the steps needed to link your interaction model to Amazon Alexa.

 

Project properties

Invocation name

You can set the invocation name while creating/editing the project in Orbita.

Account linking

If you want Account linking, you have to select an OAuth provider of your choice from the dropdown.

Refer https://orbita.atlassian.net/wiki/spaces/OCS/pages/7176586 to can configure OAuth providers.

When the user enables the skill, Alexa will ask the user to link the account with Orbita or any other third-party provider chosen here.

The “Allow Amazon Alexa users to enable skill without account linking“ checkbox determines if the Account Linking is required to use the skill or not.
If this option is checked, the user will not be prompted for third-party authentication to use the skill.

Amazon Developer Account

You should have an active Amazon developer account that you want to link with Orbita.

  1. Go to https://developer.amazon.com/ and click on Developer Console.

     

  2. Log in to your developer account. (You can create a new account by clicking on the “Create your Amazon Developer Account“ button)

     

  3. After the login is successful, click Alexa > Alexa Skills Kit.

     

  4. You can view all the Alexa Skills here.

Experience Manager

  1. In the Experience Manager, select a project and navigate to the Side Navigation menu > Develop > Deployment.

     

  2. In the Deployment screen > Alexa tab, click Authenticate to get the Amazon sign-in page.

     

  3. Sign in with your Amazon Developer Account credentials.

     

  4. After successful sign-in, the pop-up window will be closed, and the “Authenticated Successfully“ message is displayed on the Deployment screen.

     

  5. Click Deploy > Publish to link your interaction model with Amazon Alexa.

     

  6. After the skill is published, you will get the “Build Successful” message on the Deployment screen.

Testing your skill

You can test your skill using Voice Assistant, your own Amazon developer account, or enable Beta testing for the skill and add beta testers.

Voice Assistant

You can test the skill in your voice assistant by enabling the skill and then using the utterance

“open/launch <invocation name>”

To enable your skill

  1. Go to https://alexa.amazon.com/ and login when prompted.

  2. Select Skills from the left side menu.

     

  3. Select Your skills from the top right corner of the page

     

  4. Find your skill and click on it.

     

  5. Click on Enable.
    If the skill is already in Enabled status, Disable and re-enable it.

     

  6. Choose the permissions you would like to add to the skill and click on “Save Permissions”.
    Refer https://orbita.atlassian.net/wiki/spaces/OCS/pages/7471835 to know about Reminders.

     

  7. Orbita Login page will open in a new tab. (for account linking)

     

  8. Provide the email and password of your Orbita account and click Sign In to receive a confirmation message from Alexa.

  9. You can now use your voice assistant to invoke and test the skill.

Developer account

In the Amazon Developer Account, (https://developer.amazon.com/alexa/console/ask)

  1. Choose the skill you wanted to test and select Test from the action dropdown.

     

  2. Ensure you are in the Test tab and select Development from the dropdown on the top.

     

  3. Choose the Alexa simulator tab and type Open/Launch <invocation name> in the input field. You can also use the mic to speak to the chatbot.

     

Beta Testing

You can enable beta testing on your Alexa skill and assign other Alexa users as beta testers.

  1. Go to https://developer.amazon.com/alexa/console/ask.

  2. Select Distribute from the actions dropdown against your skill|

     

  3. Fill in all the details on the Skill Preview and Privacy & Compliance pages and click Save.

     

  4. In the Availability Page, click on the Beta Test to expand that section of the page.
    Add your email as the Beta test administrator.

     

  5. Add Beta testers' email and click Add.
    Click on Enable Beta testing.

  6. You can also copy the invite URL and give it to the beta testers.

     

As a Beta tester

  1. Enter the URL in a browser and Login when prompted.

  2. You will be greeted with a pop-up window as shown below. Click on “I Accept”.

     

  3. The skill will be added to your account. You have to enable the skill to use it for testing. (See Voice Assistant section above)