Alexa for Business
Administration Guide

Link Alexa for Business to Office 365

There are two methods to link Alexa for Business to your Office 365 account. Linking using application permissions allows you to set up the calendar one time and not have to update permissions when you add Alexa to more rooms. You must sign in as a global administrator user to link your Office 365 account to Alexa for Business. You can also link your Office 365 account by using a service account that has permissions to read your room calendars. This provides you with more control over the calendar resources that Alexa for Business can access.

Method 1: Link with Delegate Permissions (Recommended)

To link with delegate permissions

  1. Open the Alexa for Business console at https://console.aws.amazon.com/a4b/.

  2. Choose Calendar, Office 365.

  3. Create a service account for Alexa for Business in your Office 365 tenant:

    1. Sign into Office 365 as an administrator.

    2. Add a user in your Office 365 account that will use a service account. For more information, see Add users individually or in bulk to Office 365.

      For example, if your domain is "mycompany.com" and you add a user with the user name of "alexaforbusiness," the email address is "alexaforbusiness@mycompany.com".

  4. Open PowerShell and connect to Exchange Online. For more information, see Connect to Exchange Online PowerShell.

  5. Run the following PowerShell command to create a service account with access to the calendars in your organization:

    New-Mailbox -UserPrincipalName alexaforbusiness@your_domain -Alias “AlexaforBusiness” -Name alexaforbusiness -OrganizationalUnit Users -FirstName Alexa -LastName “Service Account” -DisplayName "Alexa for Business Service Account"

    Note

    Make sure that "your_domain" is the domain of your organization, and enter your password when prompted.

  6. To look up meeting dial-in information from your resource mailboxes, configure them to include descriptions. Run one of the following commands to keep the descriptions in the meeting invites of your resource mailboxes:

    For a single room mailbox:

    Set-CalendarProcessing “<room name>” -DeleteComments $FALSE

    For all room mailboxes:

    Get-Mailbox -ResultSize unlimited -RecipientTypeDetails “RoomMailbox” | Set-CalendarProcessing -DeleteComments $FALSE

  7. Run one of the following commands to give the service account permissions to access the room calendars in your organization:

    For a single room mailbox:

    Add-MailboxFolderPermission <room name>:\Calendar -User alexaforbusiness -AccessRights ReadItems

    For all room mailboxes:

    Get-Mailbox -ResultSize unlimited -RecipientTypeDetails “RoomMailbox” | ForEach-Object {Add-MailboxFolderPermission $_":\calendar" -user alexaforbusiness -AccessRights ReadItems}

  8. Choose Service account using delegate access and Link account, sign in with the service account you created in step 4, and accept the user consent.

Now you can associate the email address of your resource mailboxes with your rooms in Alexa for Business.

To complete room setup

  1. Associate the email address of your resource mailboxes in Office 365 to your Alexa for Business rooms.

    1. In the Alexa for Business console, choose Rooms and choose the room to which to add the email address.

    2. Choose Edit and enter the email address of your resource mailbox to associate to the Alexa for Business room.

    3. Choose Save.

  2. Test the calendar integration.

    1. Create a new meeting invite in your Microsoft Outlook client.

    2. Add the room as the resource, add meeting dial-in information to your meeting invite, and send the invite to book the room.

    3. Say “Alexa, start my meeting” to the Echo device assigned to the room.

Your Echo device automatically dials into your meeting without prompting you for a meeting ID.

Method 2: Link with Application Permissions

To link with application permissions

  1. Open the Alexa for Business console at https://console.aws.amazon.com/a4b/.

  2. Choose Calendar, Office 365.

  3. Choose Application permissions and Link account, then sign in with the Office 365 account that belongs to the Global Administrators group.

  4. Give consent that Alexa for Business has read access to the calendars in your Office 365 organization.

To complete room setup

  1. Associate the email address of your resource mailboxes in Office 365 to your Alexa for Business rooms.

    1. In the Alexa for Business console, choose Rooms and choose the room to which to add the email address.

    2. Choose Edit and enter the email address of your resource mailbox to associate to the Alexa for Business room.

    3. Choose Save.

  2. Test the calendar integration.

    1. Create a new meeting invite in your Microsoft Outlook client.

    2. Add the room as the resource, add meeting dial-in information to your meeting invite, and send the invite to book the room.

    3. Say “Alexa, start my meeting” to the Echo device assigned to the room.

Your Echo device automatically dials into your meeting without prompting you for a meeting ID.