Microsoft Teams Bridge
Microsoft Teams Bridge is an app that connects collaborators across Rocket.Chat and Microsoft Teams. It acts as a bridge between Teams and Rocket.Chat to enable cross-platform messaging among users in an organization. This way, users can send and receive messages from their workspace or Teams account.
It supports other message formats, such as emojis, files, and links. Furthermore, operations like editing or deleting a message are also supported.
The Microsoft Teams Bridge app is only available for workspaces on version
As an administrator, ensure you have access to the Rocket.Chat admin account and Teams admin account for your organization before installing.
To install Microsoft Teams Bridge,
- Go to Administration > Apps > Marketplace.
- Search for the Microsoft Teams Bridge app.
- Click Install. Confirm that the app is enabled.
- On the Microsoft Teams Bridge App Info screen, navigate to Details > API and copy the
GET auth endpoint URL.
If it's a localhost URL, exposing the localhost port to the internet requires a tunnel service like Ngrok.
To set up an Azure Active Directory App for your organization,
- Find and click Azure Active Directory.
- Click Add. Then, select App registration.
- Give the app a name. Select Accounts in this organizational directory only as the Supported account type.
- Select Web as the Redirect URI platform. Paste the
GET auth endpoint URLyou copied from the Microsoft Teams Bridge App Info as the value.
- Click Register. Copy the Application (client) ID and Directory (tenant) ID shown on the overview page.
- Click Add a certificate or secret > New Client Secret. Fill in the description and expiration timeline. Then, click Add.
- After the client secret is created, copy the Client Secret Value.
- Navigate to API permissions > Select Add a permission > Select "Microsoft Graph".
- Add the set of required permissions. The table below outlines the required permissions you'll need to set.
- After setting all permissions, click on Grant admin consent for org.
- Navigate to Microsoft Teams Bridge App Info > Settings.
- Update the Directory (tenant) ID, Application (client) ID, and Client Secret with the values you copied earlier. Then, click Save Changes.
Ensure you use the correct credentials and set the appropriate API permissions on the Azure Active Directory.
If you intend to exchange more than 500 messages, here are some important details to note:
- Check if the API is metered. Microsoft Teams has free and metered APIs that are billed based on usage. Know the metering unit to estimate API costs. There's a limit of 500 messages per month. Exceeding this limit means Teams messages won't show in Rocket.Chat, but it can still be sent.
- To monitor message count, set up an Azure budget to track messages against the threshold. Configure alerts to ensure you stay within the 500 messages monthly spending limit. For example, your organizational spending limit is 500 messages per month; email notifications are sent if the budget threshold is exceeded.
This app was developed in partnership with Yuqing Bian during Google Summer of Code 2022.