Guide to set up the new BitaBIZ Exchange integration
This article is for BitaBIZ customers, who have already activated the BitaBIZ Exchange integration and now need to update to the new "modern" Exchange integration.
The new Exchange integration is set up via our BitaBIZ Azure AD app, which must be added to your Azure Active Directory.
If your company have set up single sign-on to your BitaBIZ account, your company have already installed our BitaBIZ Azure AD app. Follwo the guide below to activate Exchange integration to the app.
If your company have not set up single sign-on, it means that the BitaBIZ Azure AD app is not yet installed. Therefore you need to install the app before you continue follow this guide to install the app
💁 Do you need help with the installation? Book a meeting with BitaBIZ and we will guide you. It takes about 15 minutes. Click here to book a meeting with BitaBIZ
Configure Exchange integration to your BitaBIZ Azure app
1. In the Azure portal, on the left navigation panel, click Azure Active Directory icon
2. Select App registrations from the Manage section.
3. Do the following:
Select All applications,
In the search box, type BitaBIZ (or the name of your BitaBIZ enterprise application)
select the application from result panel.
4. Select API permissions from the Manage section and click the + Add a permission button.
5. Select Microsoft APIs and then click Microsoft Graph.
6. Do the following:
Click Application permissions,
In the search box, type Calendars,
Click Add permissions
7. click the + Add a permission button again.
8. Select Microsoft APIs and then click Microsoft Graph.
9. Do the following:
Click Application permissions
In the search box, type MailboxSettings
Click Add permission
10. Select Grant admin consent for bitabiz and click Yes.
💁 The 2 API permissions have now been added!
11. Add new Client secret:
Select Certificate & secrets from the Manage section
Click the + New client secret button
Type a description for the new client secret ie. "BitaBIZ Exchange integration client secret"
Select the expiring period for the client secret
💁 The expiration period should be 12 months. Do not select a period longer than 12 months, otherwise the integration will not work.
💁 The client secret has now been created!
12. Copy the Value text string from the newly created Client secret, which needs to be inserted into your BitaBIZ account later.
13. Do the following:
copy the Application (client) ID
copy the Directory (tenant) ID
Application (client) ID and Directory (tenant) ID needs to be inserted into your BitaBIZ account later.
Log in to your BitaBIZ account
Setup admin -> Integration -> Microsoft integrations.
In the Microsoft Exchange Integration section, click the link:
Access Modern Exchange authentication settings.
To configure the Exchange integration in BitaBIZ, perform the following steps:
Copy and paste Application (client) ID into Client Id
Copy and paste Directory (tenant) ID into TenantId
Copy and paste Client secret Value into Client secret
Activate the Exchange integration by turning button to ON
Click Save Exchange
💁 Saving the new Exchange integration will disable the old Exchange integration automatically.
💁 The new Exchange integration is now ACTIVE. Test the integration by registering a sick day. The sick leave event will within max. 4 minuts be updated to your Outlook calendar. Remember to delete the sick leave event after testing