Use the Alexa for Hospitality Management Console

Use the Alexa for Hospitality management console to manage your Alexa for Hospitality organization, properties, rooms, devices, and skills.

Prerequisites

Before you use the Alexa for Hospitality management console, you should perform the following tasks:

The console is available in the US, UK, and FR marketplaces at the following links:

Manage your Alexa for Hospitality experience

You can use the Alexa for Hospitality management console to add organization and property administrator users, and to manage your organization's properties, rooms, devices, skills, and contacts.

Manage your organization

When you register with Alexa for Hospitality, Amazon creates an Alexa for Hospitality organization for you. In the Alexa for Hospitality management console, you can add and remove organization users. Organization users are members of your Amazon Business account who can perform the role of Organization administrator. Organization administrators have full control over all properties in your Alexa for Hospitality organization.

To add an organization user

  1. Open the Alexa for Hospitality management console.
  2. In the left navigation pane, choose Organization Users.
  3. Enter the user's Amazon Business email address.
  4. Choose Add User.
  5. The user appears in the list of users on the page.

To remove organization users

  1. Open the Alexa for Hospitality management console.
  2. In the left navigation pane, choose Organization Users.
  3. From the list of users, choose the users to remove.
  4. Choose Remove User.
  5. In the dialog box, choose OK.
  6. The users disappear from the list of users on the page.

Manage properties

Use your Properties page in the Alexa for Hospitality console to add and remove property users, and to create, delete, and update properties. Property users perform the Property administrator role. For more details about this role, see About Managing Properties, Room Types, and Rooms.

To create a property

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. From the Actions drop-down menu, choose Add a property.
  3. In the dialog box, enter a valid property name and address.
  4. Choose Create.
  5. If the console doesn't recognize the address, the console displays a warning that the address can't be recognized. In some cases, you can choose the address anyway, if it's a valid address (for example, a new address that's not yet in our database). In the case of an invalid address (for example, one that has an invalid city name or postal code), the console displays an error message, and you can't create the property until you provide a valid address.

To change a property name

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. In the Property details page, choose Edit.
  4. Edit the property name.
  5. Choose Save.

To delete a property

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property to delete.
  3. Choose Delete Property.

To add a property user

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. In the left navigation pane, choose Property Users.
  4. Enter the email address of the user to add.
  5. Choose Add User.
  6. (Optional) Choose Assign the user as Property Admin.

To remove property users

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. In the left navigation pane, choose Property Users.
  4. From the list of users, choose the users to remove.
  5. Choose Remove User.
  6. In the dialog box, choose OK.

Manage rooms

Use the Rooms page for your property in the Alexa for Hospitality console to create, get, list, update, and delete rooms. Only users with the Room administrator role can perform these operations.

A room name can contain letters or numbers and the following special characters, with no spaces or periods: _ - = # ; : ? @ &. The room name can't exceed 256 characters. Room names must be unique to a property, and they should be meaningful to your organization's users.

To create a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. Choose Create room.
  5. In the Room name field, enter a unique room name.
  6. (Optional) To add an Alexa device to the room, choose one or more Alexa devices from the Devices list. Note: Only devices that aren't already associated with a room are available in the Devices list.
  7. Choose Create.

To change a room name

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. In the list of rooms, choose the room.
  5. Choose Edit.
  6. Edit the room name.
  7. Choose Save.

To associate devices with a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. Choose the room to edit.
  5. Choose Edit.
  6. Choose one or more devices to associate with the room.
  7. From the Actions menu, choose Associate device.

To disassociate devices from a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. In the room list, choose the room name.
  5. In the Room settings page, choose Edit.
  6. Choose one or more devices to disassociate from the room.
  7. From the Actions menu, choose Disassociate from room.

To delete a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. In the room list, choose the checkbox next to the room.
  5. Choose Delete.
  6. In the dialog box, choose Confirm.

Manage room templates

To simplify the process of managing rooms, you can define a room template. A room template contains settings, skill enablements, and skill disablements to apply to registered devices in a group of rooms in your property. For example, VIP suites can have their own room template with unique settings and skills.

You can apply a room template to a room (or group of rooms) at any time. Note that applying a room template is a point-in-time action. This means that when you apply the room template to a given room, only devices that are in the room at that time get the settings and skill actions in the template. If you add new devices to the room later, you must apply the room template again, so the newly added devices get the settings and skill actions.

After you create a room template, you can't change it. To change settings and skill actions for a group of rooms, you must create a new room template and apply it to the rooms.

To create a room template

  1. Open the Alexa for Hospitality management console and navigate to the Room Templates page for your property.
  2. Choose Create from the Actions drop-down menu.
  3. In the Name field, enter a name for the room template.
  4. In the Device Settings pane, choose settings from the following drop-down menus:
    • Default Music Provider and Default Music Station – Choose the default music provider and music station that Alexa plays when guests say, "Alexa, play music."
    • Language – Choose the language that users can use to interact with devices in the room. See the Endpoint API documentation for supported languages.
    • Wake Word – Choose the voice command that turns on the device. To avoid user confusion, leave this option set to Alexa.
    • Max volume – Choose a value between one and ten to limit the volume output of Alexa devices to this value. The default setting is six. Note: Echo Show devices don't support this setting.
    • Temperature Unit – Choose Fahrenheit or Celsius.
    • Distance Unit – Choose US (feet, inches) or Metric (meters).
    • Timezone – Choose the time zone setting for devices in the room.
    • Do Not Disturb Mode – Choose On to turn on Alexa.DoNotDisturb, or Off otherwise. When this setting is On, devices in the room don't receive notifications or calls.
    • Follow Up Mode – Choose On to enable follow-up mode, or Off to disable it. When follow-up mode is enabled, users can ask Alexa follow-up questions without saying the wake word.
    • Skills – Choose skills to enable or disable for the room. For more details about enabling and disabling skills, see Manage Skills.
  5. From the Create Template drop-down menu, choose one of the following options to save the new template:
    • Choose Current property to create the template and apply it to the current property.
    • Choose Select properties to create the template and choose properties to apply it to.

To apply a room template

  1. Open the Alexa for Hospitality management console and navigate to the Room Templates page.
  2. From the Room templates menu, choose the room template to apply.
  3. From the Actions menu, choose Apply.
  4. From the Rooms list, choose rooms to apply the template to.
  5. To apply the template, choose OK.

To clone a room template

  1. Open the Alexa for Hospitality management console and navigate to the Room Templates page.
  2. From the Room templates menu, choose the room template to clone.
  3. Adjust the setting values and skill actions as needed.
  4. From the Save as new Template menu, choose one of the following:
    • Current property to create the template and apply it to the current property.
    • Select properties to create the template and choose properties to apply it to.

To delete a room template

  1. Open the Alexa for Hospitality management console and navigate to the Room Templates page.
  2. From the Room templates list, choose the room template to delete.
  3. From the Actions menu, choose Delete.
  4. In the dialog box, choose Confirm.

Manage Alexa and smart devices

Before you can manage Alexa devices and smart devices, you must first associate them with rooms. After you set up your Alexa devices, you can use the Alexa for Hospitality management console to associate them with rooms. You can also discover smart devices and add them to rooms.

To view Alexa device information

  1. Open the Alexa for Hospitality management console and navigate to the Devices page for your organization.
  2. The console displays a list of your account's registered Alexa devices, with the following information:
    • Device Serial Number – The serial number of the Alexa device.
    • Device Name – The name of the Alexa device, if the device has a name.
    • Device Type – The type of Alexa device (for example, Amazon Echo Dot).
    • Room Name – The room name, if you've associated the Alexa device with a room.
    • Availability – The availability status of the Alexa device.
      • Online – The device is connected to the network.
      • Offline – The device isn't connected to the network. For example, the device is unplugged, or the network isn't available.
    • MAC address – The media access control (MAC) address used to identify a device on a wireless network.
  3. To see a list of Alexa devices registered to your account that are available to associate with a room, choose Associate Devices.

To assign Alexa devices to rooms

  1. Open the Alexa for Hospitality management console and navigate to the Devices page for your property.
  2. Choose the Associate Devices button.
  3. From the Devices list, choose the devices to assign.
  4. For each device, choose a room to associate it with.
  5. Choose Submit.
  6. Use the status bar at top of the page to track the progress of the operation.

To move Alexa devices to different rooms

  1. Open the Alexa for Hospitality management console and navigate to the Devices page for your property.
  2. From the Devices list, choose the devices to move.
  3. From the Actions drop-down menu, choose Move to different room.
  4. For each device, choose the new room to associate it with.
  5. Choose Submit.
  6. Use the status bar at top of the page to track the progress of the operation.

To disassociate Alexa devices from rooms

  1. Open the Alexa for Hospitality management console and navigate to the Devices page.
  2. From the Devices list, choose the devices to unassign.
  3. In the Device Details page, choose Disassociate from room.
  4. Choose Submit.
  5. Use the status bar at top of the page to track the progress of the operation.

To change a device's friendly name

  1. Open the Alexa for Hospitality management console and navigate to the Devices page.
  2. From the Devices list, choose the device to rename.
  3. In the Device Details page, choose Rename.
  4. Enter a new friendly name for the device.
  5. Choose Submit.

To deregister devices

  1. Open the Alexa for Hospitality management console and navigate to the Devices page.
  2. From the Devices list, choose the devices to deregister.
  3. From the Actions menu, choose the Deregister.

To discover smart devices for a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings page, navigate to the Skills section
  6. Choose the Enabled Skills tab.
  7. Locate the smart home skill that corresponds to the smart devices you want to discover.
  8. To begin device discovery, choose Discover Devices.
  9. Wait for the discovery process to complete. This can take up to a minute.

    The console displays the list of smart devices that Alexa for Hospitality has discovered and associated with the room. The discovered smart devices also appear in the Smart Home Devices tab on the Room settings page.

To remove smart devices from a room

  1. Open the Alexa for Hospitality management console and navigate to the Devices page.
  2. Choose the Smart Home Devices tab.
  3. Choose the smart devices to remove.
  4. Choose Forget.

Manage device groups

You can create a device group for a room and add Alexa devices and smart devices to the group. This lets a guest control devices as a logical unit. For example, by saying "Alexa, turn off Kitchen," where "Kitchen" is a device group containing two smart lights and one smart plug, a guest can turn off all three devices at the same time. Only devices that you've associated with the same room can be part of a device group. A device can only belong to one device group at a given time.

To create a device group for a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings page, choose the Groups tab.
  6. Choose Create a New Group.
  7. In the Create device group dialog box, specify the settings as follows:
    1. In the Name field, enter a unique name for the device group.
    2. From the Devices list, choose the devices to be added.
  8. Choose Create.

To add a device to a device group

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings page, choose the Groups tab.
  6. Choose the device group.
  7. Choose Add Devices.
  8. In the dialog box, choose the devices you want to add.
  9. To update the device group, choose Add.

To remove a device from a device group

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings page, choose the Groups tab.
  6. Choose the device group.
  7. Choose Remove Devices.
  8. In the dialog box, choose the devices you want to remove.
  9. To update the device group, choose Remove from group.

To delete a device group

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings page, choose the Groups tab.
  6. Choose the device group.
  7. Choose Delete.
  8. In the dialog box, choose OK.

Manage skills

In the Alexa for Hospitality management console, you specify the skills that guests can use on the registered Alexa devices in your property. You can enable or disable skills for a room directly or in a room template that you apply to one or more rooms.

You can find skills in the Alexa Skills Store, and you can create and enable your own property skills that are unique to your properties.

To enable a skill for a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings pane, choose the Alexa Skills Store tab.
  6. In the Alexa Skills store, locate the skill by browsing the list of available skills, filtering by category, or searching by keyword.
  7. (Optional) Choose the Skill details tab to see more details about the skill.
  8. (Optional) For property skills, choose the Hidden Skills tab and enter the skill ID to retrieve the skill.
  9. Choose Enable.
  10. (Optional) If the skill requires account linking, link your account by following the account linking steps.

To disable a skill for a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the Rooms list, choose the room.
  5. In the Room settings pane, choose the Enabled Skills tab.
  6. Choose the Disable button next to the skill you want to disable.

To link an account to a skill

Some skills require account linking, which links an Alexa for Hospitality account to a user account in another system. When you add a skill that requires account linking, the Alexa for Hospitality console prompts you to open the login page of the skill provider and log in with your user account. After you successfully log in, the skill provider authenticates all registered devices in your Alexa for Hospitality account.

Following are the options for account linking. Which one you use depends on the skill you're trying to enable. Some skills require you to link the same account for all registered devices in all rooms. Others require you to link an account for registered devices in a room.

Smart home or custom skills might require you to configure scope of the skill, so that the skill can recognize which Alexa devices you've associated with each room or partition. For more details about scoping and partitions, see How to use partitions to limit the scope of a smart home skill.

To link the same account for all registered devices in all rooms

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. In the Skills tab, choose Enable.
  5. In the service provider's portal page for the skill, enter your account credentials for that skill (not your Amazon account credentials).

To link an account for registered devices in a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. From the room list, choose the room.
  5. In the Skills tab, choose Enable.
  6. In the dialog box, choose Authorization Flow.
  7. In the service provider's portal page for the skill, enter your account credentials for that skill (not your Amazon account credentials).

To configure scope for a smart home or custom skill

  1. Navigate to the Alexa Skills Store page for the skill, and link your account to the skill.
  2. Open the Alexa for Hospitality management console and navigate to your Properties page.
  3. In the list of properties, choose the property.
  4. Navigate to the Rooms page for the property.
  5. From the room list, choose the room.
  6. In the Skills tab, choose Enable.
  7. In the dialog box, choose Delegation Flow.
  8. In the service provider's portal page for the skill, enter your account credentials for that skill (not your Amazon account credentials).
  9. Return to the Alexa for Hospitality management console.
  10. Choose This skill supports partition.
  11. Enter the scope name.
  12. Choose Enable.

Manage address books and contacts

To create an address book

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. Choose Create Address Book.
  3. In the Name field, enter a unique name for the address book.
  4. Choose Create.

To change an address book name

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. From the list of address books, choose the address book you want to update.
  3. Next to the address book name, choose Edit.
  4. Edit the address book name.
  5. Choose Save.

To associate an address book with rooms

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. Choose the address book you want to associate.
  3. From the Actions menu, choose Associate.
  4. On the Associate Address Books page, choose the property.
  5. From the list of rooms for the property, choose the rooms you want to associate the address book with.
  6. Choose Associate to associate the address book with the rooms.

To disassociate an address book from rooms

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. Choose checkbox next to the address book you want to disassociate.
  3. From the Actions menu, choose Disassociate.
  4. On the Disassociate Address Books page, choose the property.
  5. From the room list, choose the rooms you want to disassociate the address book from.
  6. Choose Disassociate.

To update the address book association for a room

  1. Open the Alexa for Hospitality management console and navigate to your Properties page.
  2. In the list of properties, choose the property.
  3. Navigate to the Rooms page for the property.
  4. Choose the room from the room list.
  5. In the Room settings page, choose Edit.
  6. In the Associated Address Books menu, choose the new address book.
  7. Choose Save.

To delete address books

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. Choose one or more address books to delete.
  3. From the Actions menu, choose Delete.
  4. In the dialog box, choose Confirm.

To add a contact to an address book

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. From the list of address books, choose the address book.
  3. In the Contacts pane, choose Create.
  4. In the Name field, enter the contact name.
  5. Choose the contact type: Phone number or Room.
  6. Enter the contact details as follows:

    • If the contact type is Phone number, add up to three phone numbers for the contact. The phone numbers currently supported are US, UK, and Canada (CA) telephone numbers in E.164 format.
    • If the contact type is Room, choose the Property and Room.
  7. Choose Create.

To update a contact in an address book

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. Choose the address book.
  3. Choose the Contacts pane.
  4. From the Contacts list, choose the contact.
  5. Choose Edit.
  6. In the Contact Details page, make any needed changes.
  7. Choose Save.

To delete contacts from an address book

  1. Open the Alexa for Hospitality management console and navigate to the Address Books page.
  2. Choose the address book.
  3. Choose the Contacts pane.
  4. From the Contacts list, choose the contacts to delete.
  5. Choose Delete.

View analytics in the console

The Alexa for Hospitality management console lets you view aggregated property data analytics for your installed devices and property skills. To view them, open the console and navigate to the Analytics page. This page uses AWS QuickSight to display default data visualizations for the most recent 30 days for which data is available.

Following are the default visualizations in the Dashboard tab:

  • Devices - Total and Percent Active – A gauge chart that shows the total number of unique devices associated with rooms under your account, along with the percentage of devices that are active. Active devices are devices with at least one dialog in the selected time period. A dialog is an interaction with multiple turns in which the user asks questions and Alexa responds with an answer. The default time period is 30 days.
  • Trend of Total Number of Active Devices – An active device trend chart that shows the number of active devices on a daily basis. Choose the graphic to change the time granularity for the data from daily to weekly and vice versa.
  • Top 10 Domains by Number of Dialogs – The top ten dialog categories or domains, ordered by the number of dialogs from device users.
  • Top 10 Skills by Number of Dialogs – The top ten skills, ordered by the number of dialogs from device users.
  • Trend of Total Number of Dialogs – The dialog distribution for customer-owned skills, ordered by intent.
  • Number of Dialogs for Property Skills by Intent – A dialog trend chart showing the number of dialogs for each day or week in the time period. Choose the graphic to change the time granularity for the data from daily to weekly and vice versa.

A user's role determines which property data they can see. For example, the Organization administrator sees data for all their properties by default. They can also view data for individual properties by choosing the property filter in the analytics visualization and selecting the property they wish to view. The Property administrator sees data for their properties.

When there isn't enough aggregated data for a particular time period, the console doesn't display analytics for that period. In that case, you can select a longer time period to see aggregated data. For example, if the time period is one day, you might change it to one week. Here are definitions of common dialog categories:

  • Auto – Dialogs related to local search and navigation, for example "Alexa, how is the traffic on the way to the airport?"
  • Communications – Dialogs related to calling, for example "Alexa, call front desk."
  • Music – Dialogs related to listening to music, for example "Alexa, play country music."
  • Video – Dialogs related to watching videos, for example "Alexa, play cat videos."
  • Books – Dialogs related to reading books or audiobooks, for example "Alexa, read me the Sleeping Beauty."
  • Health – Dialogs related to health information, for example "Alexa, what's the cure for sunburn?"
  • Household – Dialogs related to household tasks like setting timers and adding reminders, for example "Alexa, add a reminder to reserve a table for dinner tomorrow."
  • Information – Dialogs related to general information, including weather, for example "Alexa, what's the capital of Austria?" or "Alexa, will it rain tomorrow morning?"
  • Language Services – Dialogs related to translations, for example "Alexa, how do you say hello in Spanish?"
  • News – Dialogs related to current news and events, for example "Alexa, what's up?"
  • Other – Dialogs that can't be categorized in any other listed categories or domains, for example, "Alexa, connect my phone via Bluetooth." Or "Alexa, stop."
  • Personality – Dialogs related to jokes or chatting with Alexa, for example, "Alexa, tell me a joke."
  • Skills – Dialogs with custom skills enabled on the device, for example "Alexa, let's play Jeopardy." This category includes any custom property skills you've enabled.
  • Smart Home – Dialogs related to controlling smart devices, for example "Alexa, turn on the room lights."