Exchange Online (Office 365)

Fishbowl integrates with your Exchange Online Room and Equipment Mailboxes.

Note: When a meeting is created in Microsoft Exchange, it exists in the Room calendar separately from the Organizer's calendar. Fishbowl can only access the Room calendar, and not the calendars of Organizers. While this is good from a privacy perspective, it unfortunately means that if Fishbowl ends or extends a meeting, this is not propagated to the Organizer or Attendees' calendars. Usually this is not a problem though, because only ongoing meetings can be extended or ended early. Attendees would be attending the ongoing meeting and would be aware of any changes that are made on your Fishbowl tablet.

1. Create a Room Mailbox

  1. Log into the Microsoft 365 admin center with an Administrator account.
  2. Select Resources > Rooms & equipment from the menu on the left, then click the + Add button to add a new meeting room.
  3. Enter your room details, and make a note of the email address of the mailbox.
  4. Click Add

2. Set up a user with editor permissions to the Room Mailbox

Important: Fishbowl uses Microsoft EWS to communicate with your calendars. EWS is not currently compatible with two-step authentication. If your organization uses two-step authentication, then you'll need to set an App Password for the relevant user. Please see this Microsoft Help page for more information.

When setting up Fishbowl, you'll need to provide user credentials of a user with Editor permissions.

The easiest is to simply assign a password to the room mailbox that you created in Step 1. To do this:

  1. Log into the Microsoft 365 admin center with an Administrator account.
  2. Select Users > Active users from the menu on the left.
  3. Click on the room mailbox that you created in Step 1.
  4. Click on the Reset Password button
  5. Select Let me create the password
  6. Enter a password, and make sure that Make this user change their password when they first sign in is not selected.
  7. Click on Reset
  8. It is not recommended that you send this password via email, so you can skip this option if prompted.

3. Allow meeting subject display

Office 365 does not allow access to the meeting subject (title), and the organizer's name is shown instead. If you do not wish to display the meeting subject (e.g. due to privacy concerns), you may skip this step.

This setting is not retrospective, i.e. existing meetings will still have their subject hidden.

Note: You will need Windows PowerShell and an Administrator account to perform this step

  1. Download and install the following PowerShell modules
    1. Microsoft Online Services Sign-in Assistant
    2. Azure Active Directory (AD) Module
    For additional information, refer to the relevant PowerShell support page
  2. Open PowerShell, and enter
    $credential = get-credential
  3. Enter credentials of an Office 365 administrator and click OK
  4. Enter the following one line at a time:
    Import-Module MSOnline
    Connect-MsolService -Credential $credential
    $ExchangeSession = New-PSSession -ConfigurationName Microsoft.Exchange -ConnectionUri "https://outlook.office365.com/powershell-liveid/" -Credential $credential -Authentication "Basic" -AllowRedirection
    Import-PSSession $ExchangeSession
    
    For additional information, refer to the relevant PowerShell support page
  5. If you get an error indicating that Files cannot be loaded because running scripts is disabled on this system, then you need to first run PowerShell as an administrator and enter
    Set-ExecutionPolicy RemoteSigned
    You only need to run this command once.
  6. While in PowerShell, allow meeting subjects to be visible by entering the following
    Set-CalendarProcessing -Identity room@example.com -DeleteSubject $False -AddOrganizerToSubject $False

    Note: room@example.com is the mailbox that was configured for each meeting room in Step 1.

    For additional information, refer to the relevant Microsoft support page
  7. Disconnect the remote PowerShell session by executing
    Remove-PSSession $Session

4. Configure Fishbowl

  • When configuring Fishbowl, on the Select server type page, select Microsoft.
  • On the Connect to your server page, check the I am using Office 365 option.
  • Enter the email address and password of the room mailbox that you created in Step 2, then tap on Next.
  • On the Set up your room mailbox page, enter the email address of the room mailbox that you created in Step 2, then tap on Next.
  • (Android only) Scan your Fishbowl license QR code, or enter your license code manually, and tap on Next.
  • Configure your logo and colour settings and tap on Next.