Teams Messaging Integration

Teams can be configured to send messages directly from Oleria. Follow the pre-requisites and the steps below to set up the Teams messaging integration. 

The setup involves three parts:

1. Entra ID App Registration — for Oleria to discover your teams, channels, and users
2. Oleria Bot App Deployment — for delivering notifications to channels and direct messages
3. Oleria Console Configuration — connecting everything together

Prerequisites

Part 1: Entra ID App Registration

Choose the path that matches your situation:

• Option A — Create a new dedicated App Registration for Oleria (Recommended)
• Option B — Use an existing App Registration

Option A: Create a New App Registration (Recommended)

Who: Azure/Entra ID Admin

Why this is recommended: A dedicated App Registration follows the principle of least privilege. It only has the 5 read-only permissions Oleria needs, making it easy to audit, rotate secrets independently, and revoke access cleanly if needed.

Step 1: Register the application

1. Sign in to the Azure Portal
2. Navigate to Microsoft Entra ID → App registrations → New registration
3. Configure the following:

‍

4. Click Register

Step 2: Generate a client secret

1. In the new App Registration, navigate to Certificates & secrets
2. Click Client secrets → New client secret
3. Configure:

‍

4. Click Add
5. Copy the secret Value immediately — it will not be displayed again after you leave this page

Important: The secret value is only visible at the time of creation. If you lose it, you will need to generate a new one.

Step 3: Add API permissions

1. Navigate to API permissions → Add a permission
2. Select Microsoft Graph → Application permissions
3. Search for and add each of the following permissions:

‍

4. After adding all 5 permissions, click Grant admin consent for [Your Organization]
5. Confirm by clicking Yes
6. Verify all 5 permissions show a green checkmark under the Status column

Step 4: Record your credentials

Collect the following values — you will need them in Part 3:

‍

Proceed to Part 2.

Option B: Use an Existing App Registration

Who: Azure/Entra ID Admin

When to use this: If your organization already has an Entra App Registration (for example, for another Oleria integration or a shared integration app) and you prefer to reuse it rather than create a new one.

Important: Ensure the existing App Registration is not shared with services that have conflicting lifecycle requirements (e.g., different secret rotation schedules or different decommissioning timelines).

Step 1: Verify the App Registration type

1. Sign in to the Azure Portal
2. Navigate to Microsoft Entra ID → App registrations
3. Find and select your existing App Registration
4. On the Overview page, confirm:

Step 2: Verify or add API permissions

1. Navigate to API permissions
2. Check if the following Application permissions are already granted:

‍

3. If any permission is missing:

• Click Add a permission → Microsoft Graph → Application permissions
• Search for and add the missing permission(s)
• Click Grant admin consent for [Your Organization]
• Verify all required permissions show a green checkmark

Step 3: Verify or create a client secret

1. Navigate to Certificates & secrets → Client secrets
2. You may either:

• Use an existing secret — if you have the value and it has sufficient remaining validity (at least 3 months recommended)
• Create a new secret — click New client secret, set description to Oleria integration, choose an expiry, click Add, and copy the value immediately

Note: If the existing App Registration already has other permissions beyond the 5 listed above, those extra permissions are not used by Oleria's Teams messaging integration. They will not interfere, but you may want to review them for your own security posture.

Step 4: Record your credentials

Collect the following values — you will need them in Part 3:

‍

Proceed to Part 2.

Part 2: Deploy the Oleria Bot App

Who: Microsoft Teams Admin

The Oleria bot app is a pre-built Teams application provided by Oleria. It is separate from the Entra App Registration configured in Part 1. The bot handles the delivery of notification messages to your Teams channels and direct messages.

Step 1: Obtain the Oleria Teams app package

1. Your Oleria account team will provide the bot app package as a .zip file
2. If you have not received this, contact your Oleria representative

Step 2: Upload the app to Teams Admin Center

1. Sign in to the Teams Admin Center
2. Navigate to Teams apps → Manage apps
3. Click Upload new app → Upload
4. Select the Oleria .zip package and confirm the upload
5. The app will appear in the app list once uploaded

Step 3: Allow the app

1. In Manage apps, search for the Oleria app
2. Click on the app name to open its details
3. Ensure the Status is set to Allowed

Step 4: Configure app availability

Choose one of the following deployment strategies based on your organization's needs:

‍

Important for Direct Messages: The bot can send direct messages to any user who has access to the app via the setup policy. Users do not need to manually install the app — the bot creates conversations automatically.

Step 5: Verify deployment

1. Open Microsoft Teams as a user covered by the setup policy
2. Go to Apps in the left sidebar
3. Search for "Oleria" — the app should appear and show as available

Part 3: Configure in Oleria Console

Who: Oleria Workspace Admin

Step 1: Enter Teams credentials

1. Log in to the Oleria management console
2. Navigate to Settings → Messaging → Add Messaging System
3. Select Microsoft Teams
4. Enter the credentials collected in Part 1:

‍

5. Click Authenticate
6. Oleria will validate the credentials against your Azure AD tenant

Step 2: Select your team and default channel

1. After successful authentication, a list of your teams will appear
2. Select the team where Oleria should deliver notifications
3. Select the default channel for notifications (e.g., General or a dedicated channel like #oleria-alerts)
4. Click Save

Step 3: Test the integration

1. Use the Send Test Message option in the Oleria console
2. Verify the test message appears in the selected Teams channel
3. Optionally, test a direct message by entering a user email address

‍

Contact us

For questions about this integration, please contact us at support@oleria.com.

‍