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 matching, so they can book mentoring sessions at the right times

• Users can see the RSVP of their matching 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

Important: If you are using an on-premise configuration for mailboxes and calendars, we cannot integrate as we use Microsoft’s Graph API.

Permissions

Together's Office 365 app requires:

1. Read and Modify calendars

2. View basic user profiles

Data Use

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.

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 the Integration

1. Ensure you have access as an Admin to your organization's Together instance. To confirm, head to this page and verify you can sign in and see the list of eligible integrations within the Settings tab:

2. From your integrations page, click on the Set Up button beside the Calendar Integration:

3. Next you will be presented with 4 steps:

• First, select your vendor, in this case, please select "Outlook 365"

  • You will also see an option to enter an Integration Owner. You may enter an email to be notified in case the integration/connection fails at any point.

  • After filling out an integration owner, click the Continue button:

• Second, you will select your preferred integration method.
  • With the Domain-wide integration, you will be consenting to permissions on all user calendars at once. The domain-wide integration is recommended because it removes any user friction of having to personally install the integration when signing up for the mentoring program, and avoids a mixed experience where only one person out of two in a mentorship matching has their calendar integrated.
  • With the Individual Integration, the permissions are delegated to each user, meaning we will only have permission to access their mailbox. However, every user will have to do this step in order to have an integrated experience. 

• Domain wide integration: For remaining steps, skip ahead to the section below: "Installing domain-wide integrations"
• Individual integration: For remaining steps, skip ahead to the section below: "Installing individual integrations"

Installing domain-wide integrations

• After you hit continue, you will be taken to the third step: authorizing the integration for your Microsoft domain. If you're not currently logged in with an O365 admin account, you will be prompted to log in.
  • Note: only admins with sufficient O365 privileges will be able to authorize this integration, so please ensure you log in to this page with the correct account.

• Once you have signed in as an admin, you will be presented with a page that looks a bit like this. Here you will be shown the permissions Together is requesting in order to facilitate the calendar integration for users on your domain. To authorize the integration, click Accept: 

• Now that you have authorized the integration for your domain, the final step is for Together to run a quick test on a sample of your users to ensure we can access their calendars properly. The test will begin immediately after authorizing the integration and once you have returned back to Together:

• Once the test is complete, you will be shown the number of users successfully accessed, and whether any calendar accounts were inaccessible. Once you've confirmed that the integration should be able to access all the relevant accounts, click the Done button:

• After clicking the Done button, you will see a confirmation that the integration is connected. If you need to edit the configuration or re-test the integration later on, you can do so by clicking either button here:

Installing individual integrations

• You will be prompted to consent to the integration on your own individual mailbox (not any other mailbox in your domain). 
• Allow Together to read/write your calendars. 
• After clicking the Done button, you will see a confirmation that the integration is connected. If you need to edit the configuration or re-test the integration later on, you can do so by clicking the test or configure button.

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.
• 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.

Additional Resources

• Official documentation for an example Graph API endpoint Together uses is available here.
• For an overview of Together calendar integrations, please see our article here.

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 page:

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

Have more questions? Submit a request here and let us know how we can help!