Configuring Office 365 Calendar Integrations

Background

Together Platform is a web application for businesses to run internal mentoring programs for employees. By integrating with Office 365, you give your users several user experience improvements when managing their participation in the mentoring program:

• Users can see free/busy slots for their pairing, so they can book mentoring sessions at the right times

• Users can see the RSVP of their pairing to mentorship sessions because the user is the organizer of their own event

• Users can add a Teams or Skype link automatically to mentorship meetings

• Users can reschedule/cancel directly from Outlook

Please note - If you are using an on-premise configuration or hybrid cloud, you cannot integrate with Together Platform. We support fully cloud Office 365 deployments only.

Booking time with a mentor or mentee

Installation

Step 1: Ensure integrated apps are enabled

1. Visit https://admin.microsoft.com

2. Head to Services & Add-Ins

3. Find Integrated Apps

4. Ensure Integrated Apps are enabled.

Step 2: Authorize
Follow the organization-specific link Together Software support provides you. You will see a consent screen:

Step 3: Viewing/Managing Together’s enterprise permissions

1. Visit https://portal.azure.com/ as an administrator

2. Find the Azure Activity Directory button in the menu

3. Find the Enterprise Applications screen

4. Find "Together Platform" in the list of apps. This will appear once you have consented as an administrator.

Permissions

Together's Office 365 app requires:

• Read and Modify calendars

• View basic user profiles

Data Usage

Only metadata of calendar events tied to mentoring sessions booked in Together Platform, such as event ID and start/end time is used. Together never uses integrations for purposes unrelated to mentoring sessions.

Further Information on Calendar Integrations

• It improves the user experience when users can sign in and are automatically integrated without having to fumble with accepting an integration. It also means the experience is consistent for all employees and they do not need two versions of documentation, should they want to read about booking time with a mentor or mentee.
• The app can be restricted to a security group or dynamic group/list in portal.azure.com if you want to decrease the scope. 
• We have SOC2 independent security audit and take credentials seriously, only ever using them for a signed-in user booking a mentorship session.
• Without the integration, you will not be the organizer of your mentoring sessions, meaning you cannot see RSVPs or manage the invite in Outlook.

Further reading

Official documentation for an example Graph API endpoint Together uses is available here. See an overview of Together calendar integrations here.