Manage Skills in Alexa for Hospitality

Enable or disable skills for a room

You can use the Alexa for Hospitality Skill Management API to enable or disable skills for a property's rooms. You can enable skills that are published in the Alexa Skills Store. In addition, you can use the Alexa Skills Kit to create and publish property-specific skills.

To enable a skill for a room, call the enable a skill API. To disable a skill for a room, call the disable a skill API.

After you've enabled a skill in a room, your property's end users can use it on endpoints installed in the room.

Build and publish a property skill

A property skill is a hidden skill that isn't available in the Alexa Skill Store. To enable a property skill, a user must have the room administrator (A4H.RoomAdmin) role and have the skill ID for the skill.

Hidden skills are similar to public skills in many ways. Like public skills, hidden skills are developed using the Alexa Skills Kit. They can use account linking to map users to a backend system, and they must go through the same certification process as other custom skills.

You build a property skill as you would a public skill, except that after you publish the skill, you immediately mark it as hidden. You accomplish this by completing the following steps.

To build and publish a property skill

  1. Build your skill by using the ASK developer console. If you are new to skill development, see Getting Started with ASK.
  2. Submit your skill for certification following the steps in Alexa Skills Certification Requirements. After the certification review, you'll receive an email at the address associated with your Amazon developer account.
  3. After your skill is certified and published, you must mark it as hidden as soon as possible to make sure it's not discoverable in the Alexa Skills Store. For details, see Hide or remove a skill (skill suppression).

After you've hidden your property skill, your administrator users will need the skill ID to enable or disable it.

To get the skill ID for your property skill

  1. Open your skill in the developer console.
  2. Find the skill in the list and click View Skill ID below the skill name. Copy the ID from the popup.

Provide a unit-specific response to a skill request

Skill requests now include the unit ID associated with the endpoint that the end user is speaking to. Your skill can use the unit ID to provide a unit-specific response. For details, see the unit field of the System object in the Request and Response JSON Reference.