Create Property Skills for Alexa Smart Properties
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 unit administrator (A4P.UnitAdmin
) 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.
The following sections contain information about creating skills for Alexa Smart Properties.
Create and publish a property skill
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 create and publish a property skill
- Create a custom skill by using the ASK developer console. If you are new to skill development, see Getting Started with ASK.
- Contact your Solution Architect and provide your skill ID to have your skill ingested for
hidden skill
processing. - Submit your skill for certification by following the steps in Certify and Publish Your Skill. Be sure to include in-room collateral as part of the submission. After the certification review, you'll receive an email at the address associated with your Amazon developer account.
- After your skill is certified and published, your skill will be hidden by the Alexa certification team.
HIPAA Eligible Skills
Refer to Certification Requirements for general requirements that apply to all skills. For HIPAA Eligible skills in Enterprise environments, please refer to the guidelines below.
Requirements for Skills that are HIPAA-Eligible
An Alexa skill can be HIPAA-eligible if the developer is a HIPAA Covered Entity (CE) or Business Associate (BA), uses the means we provide to identify the skill as one that processes Protected Health Information (PHI), and agrees to the Alexa Business Associate Agreement (BAA). HIPAA-eligible Alexa skills must also adhere to the requirements listed below and pass a certification review. Note that these guidelines might change over time.
HIPAA-Eligible skill submission checklist
- The developer account must be owned by the Covered Entity or Business Associate that will publish the skill.
- The developer name of the account must represent the legal name of the Covered Entity or Business Associate that will publish the skill.
- You must indicate in the developer console (requires login) that you intend for your skill to handle protected health information (PHI)
- You must agree to the Alexa Skills Business Associate Agreement (BAA) with Amazon, made available in the developer console (requires log-in).
- Your skill must never have been published prior to when you indicate that you intend for your skill to handle PHI and/or agree to the BAA.
- Your skill will not send Amazon information that includes patient name or other patient personal information, (e.g., Room 101 needs pain meds and not John Smith needs pain meds).
- Your skill must be published live, but hidden from the skill store.
- Your skill must only be made available and distributed in the United States.
- Your skill cannot use PHI for development, testing, or certification purposes.
- Your skill must include a link to a privacy policy URL in the skill description.
- Your skill can only use Approved APIs and services.
- Your skill must not be Child Directed.
Approved APIs
HIPAA-eligible skills can only use the following APIs.
- Account Linking – For more details, see Add Account Linking to Your Alexa Skill. In healthcare contexts, account linking facilitates linking of the skill with the Unit. It does not support linking to an individual user’s account.
- Alexa Dialog API – For more details, see Dialog Interface Reference.
- Alexa Response API – For more details, see Response Building.
- Alexa Presentation Language (APL) – For more details, see Alexa.Presentation.APL Interface Reference.
- Alexa Skill Events API – For more details, Skill Events in Alexa Skills.
- Alexa UI APIs – For more details, see Include a Card in Your Skill Response.
- Permissions – You can only enable permissions for device address and location services. For more details, see Configure Permissions for Customer Information in Your Skill.
- Skill building using the Alexa Skill Management API (SMAPI) – For more details, see Get Started with SMAPI.
Related topics
- Manage Skills for Alexa Smart Properties
- About Alexa Smart Properties
- Get Started with Alexa Smart Properties APIs
Last updated: May 01, 2024