On-Prem Outlook Integration

To integrate Microsoft Outlook with Hivel and enable Meetings Breakdown insights, you must have an admin Azure account. Follow the steps below to obtain the Tenant ID, Client ID, and Client Secret, which you will enter into your Hivel instance.

How to Integrate Microsoft Outlook with Hivel

Prerequisite:

• You must have admin access to your Azure portal.

---

Step 1: Access Azure Portal

• Log in to portal.azure.com using your admin Azure account.

Step 2: Navigate to App Registrations

• In the Azure portal search bar, type App Registrations and open it.

  

Step 3: Create a New App Registration

• Click New Registration.

• Enter any name for your application.

• Set Supported account types to: “Accounts in any organizational directory (Any Microsoft Azure AD tenant - Multitenant)”.

• Click Register.

Step 4: Save Your IDs

• After registration, copy and save the following:

  • Client ID (Application ID)

  • Directory (tenant) ID

Step 5: Generate Client Secret

• In the left menu, click Certificates & Secrets.

• Click New Client Secret.

• Add a description and set an expiry period.

• Click Add.

• Immediately copy the Secret Value — you won’t be able to see it again later.

Step 6: Configure API Permissions

• Click API Permissions in the left menu.

• Delete any existing Delegated permissions.

• Click Add a permission.

• Select Microsoft Graph.

• Choose Application permissions.

• Search and add the following permissions:

  • User.Read.All

  • Calendars.Read

Step 7: Grant Admin Consent

• Click on Grant admin consent for your organization.

• Confirm the action.

---

Step 8: Final Setup in Hivel

• Go to the Integrations page on your Hivel instance.

• Select Outlook Integration.

• Paste the Tenant ID, Client ID, and Client Secret you saved earlier.

• Confirm and save.

---

What’s next?

• Your Outlook data will start syncing automatically and pull historical data for 90 days.

• The data processing will be completed within 2-24 hours depending on the number of users.

• You can now view the Meetings Breakdown insights for your teams within Hivel.

---

Data Collected from Outlook

Once authorization is complete, Hivel will read outlook calendar data for all users under the admin account. The specific data points fetched from each calendar include:

• id: Unique identifier of the calendar event.

• iCalUId: Unique identifier for the event across calendar clients.

• start: Start time of the event.

• end: End time of the event.

• isCancelled: Indicates if the event has been canceled.

• organizer: The person who created or owns the event.

• attendees: List of participants invited to the event.

• sensitivity: The privacy level of the event (e.g., normal, personal, private, confidential).

Sync Frequency

• Initial Sync: Fetches calendar data for the past 90 days.

• Incremental Sync: Nightly updates to fetch events for the past 1 day.

Important

• We do not save any external users’ email addresses.

• If a meeting is marked as private, and Azure does not share invitee details, we do not store them.

If you encounter any issues or need further assistance, feel free to reach out to [email protected]