Before you start
Make sure you have:
- An AWS account
- A supported device – includes Amazon Echo and Polycom Trio
- Either the Account Owner or IT Support user role in OnLocation
Step 1: Set up your Alexa account in AWS
Set up your Alexa for Business account in AWS. Contact your IT team if you need help accessing these settings.
You’ll need to set up access permissions, configure your devices, and create rooms. Make sure you use us-east-1 as the region for these settings. Note that the AWS setup tool only runs on Microsoft Windows.
Follow the AWS documentation to complete the setup:
- Set up an IAM profile with Alexa for Business permissions. Make a note of your IAM access key ID and secret access key, you’ll need them when setting up the integration with OnLocation.
- Set up your shared devices.
- Create a room profile. You must give your devices a US address, the devices do not have to be located there.
- Create a room.
For more information, check out these AWS videos on YouTube:
- Alexa for Business: How to Set Up Echo Devices
- Alexa for Business: How to Configure Rooms and Room Profiles
Step 2: Set up the integration in OnLocation
Once your Alexa for Business settings are configured in AWS, set up the integration in OnLocation:
- Log in to OnLocation.
- Go to Tools > Account.
- Select Integrations from the left-side menu.
- Select Alexa for Business.
- Click Enable, then click Confirm to activate the integration.
- Next to Alexa for Business, click Manage Settings.
- Complete the IAM key and IAM Secret fields. These access keys were provided in AWS while setting up your IAM profile.
- To test the connection with your device, click Test.
- Click Save, then click Back to Integrations.
You can now set up your announcements by creating triggers in OnLocation.
Fix a credential error
If you receive the ‘Invalid credentials or IAM permissions for Alexa for Business’ error message while entering your Alexa settings, check that your IAM credentials have permission to use Alexa for Business.