Connect to Office 365

Choose how you want to connect

Administrators can connect Robin with Office 365 using one of two methods; via a service account, or installing the Robin application directly on your team's domain. 

Application

Installing the application allows teams to set it and forget it. This method, which requires connection with the O365 Global Admin account, installs the app for the entire O365 tenant -- the benefit being you don't have to keep updating permissions as you add new calendars. 

Service Account

A service account is more configurable and is good for teams that want to maintain the highest level of control over permissions, access logs, etc. This approach may feel more comfortable for folks familiar with Exchange. The service account should have impersonation access for all of the room calendars. This enables creating and editing events through Robin. 

 

Connect O365 service account

1
Navigate to the Settings tab within Robin's web dashboard
2
 Select the Integrations tab, and click "Connect" Office 365. 
3
You will be provided a pop up window to choose how to connect to Office 365. For our purposes you will choose "Connect Service Account".
4
You will be prompted to enter your credentials. Robin will then ask for permission to access calendar information in order to sync events. Accept permissions to proceed and complete your connection.

Install the app to Office 365

New to Office 365? Microsoft has a great guide to administering apps like Robin


Here's how to install Robin's syncing app onto your Office 365 account, which will allow you to connect room calendars to spaces in Robin. This will install a domain-level app which has permission to manage room resources within your account. You can see a list of other apps you've installed this way here.

You must be a global administrator to complete this step

This app will be installed for your entire organization, so you will need a global administrator to complete this step. If you'd like to understand more about why a Global Admin is needed, start with this article.

1
Navigate to the Settings tab within Robin's web dashboard. 
2
Select the Integrations tab, and click "Connect" Office 365. 

3
This will start the OAuth flow to connect to your account and install the app. The window will prompt you to enter account credentials or show you a list of your Microsoft Accounts. Since this will be an app for your entire domain, you will need to use a global administrator account to complete this step.

Common pitfall

If you see the screen below after pressing "Accept", it means your account is not a Global Admin. You will need to log in using a different account or have your IT department temporarily change your user permissions until you've completed the installation.

4
Robin will ask for permission to access calendar information in order to sync events. Accept permissions to proceed. 

"Why does it ask for full access to all mailboxes?"

Robin uses an authentication method called OAuth to securely install the app onto your Office 365 account. OAuth is a way for apps to request very specific rights for your account. For Office 365/EWS, Microsoft (for some inexplicable reason) requires that all OAuth apps request this permission, whether or not you use it. Robin does not. Once installed, the Robin app only interacts with your calendars.

You can read more about app privileges in Office 365 here.

5
You're all set! You can now pair calendars managed by this account to your spaces. You can confirm by seeing if Robin is visible from your domain's app overview: http://myapps.microsoft.com

Next up

Now that you've connected the app, let's connect a room calendar to a space in Robin.
Did this article help?
Powered by Zendesk