> For the complete documentation index, see [llms.txt](https://help.rhythms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rhythms.ai/getting-started/getting-started-in-microsoft-teams/install-rhythms-in-microsoft-teams.md). # Install Rhythms in Microsoft Teams Rhythms in Microsoft Teams is a personal tab called **OKRs** that opens your Rhythms OKRs inside Teams, plus Rhythms notifications in the Teams **Activity** feed. There is no Rhythms bot in Teams: you cannot chat with Rhythms in a Teams channel or chat. A Rhythms Admin installs the app once from **Settings › Workspace › Collaboration platforms**, a Microsoft Global Administrator grants consent, and Rhythms then adds the app for every user it can match by email. ## Before you start * You are a **Rhythms Admin** in the Rhythms workspace. * The person who accepts the Microsoft consent screen is a **Global Administrator** (or **Privileged Role Administrator**) in your Microsoft Entra tenant. The consent is tenant-wide and covers application permissions, which a Teams Administrator alone cannot grant. This can be a different person from the Rhythms Admin: the Rhythms Admin starts the install and the Microsoft admin signs in on the consent screen. * Your users have the same email address in Rhythms and in Microsoft 365. Rhythms matches people by email (or by their Entra ID user principal name for workspaces provisioned from Entra ID) to install the app for them. ## Step 1: Start the install from Rhythms 1. Sign in to Rhythms as a Rhythms Admin. 2. Open **Settings › Workspace › Collaboration platforms**. 3. On the **Microsoft Teams** card, click **Install**. 4. You are sent to Microsoft's **Permissions requested** screen. ![The Collaboration Platforms page in Rhythms Settings with Slack and Microsoft Teams cards, each showing an Install button](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-4473b5c63b0582afc4ce5d871ce3ab3dc3a03f96%2Ffc0a7b17-c137-4731-a443-0dfaaffc715a-Collaboration_Platforms.png?alt=media) ## Step 2: Grant consent in Microsoft Sign in on the Microsoft screen as a Global Administrator and review the permissions. Accepting grants them for your whole organisation, so nobody else is prompted later. The app asks for: | Permission on the consent screen | What Rhythms uses it for | | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | | Read all app catalogs | Finds the Rhythms app in your organisation's Teams app catalog so it can be installed for users. | | Allow the app to manage itself for all users | Installs the Rhythms tab for each matched user, so they do not have to add it themselves. | | Send a teamwork activity to any user | Posts Rhythms notifications to the Teams Activity feed. | | Read organization information | Reads your tenant's display name when the connection is created. | | Read all users' full profiles | Looks each Rhythms user up by email to find their Microsoft account. | | Read user mailbox settings | Reads each user's mailbox time zone so their Rhythms profile time zone is correct. | | Sign in and read user profile; Maintain access to data you have given it access to | Standard Microsoft sign-in permissions shown on every consent screen. | Click **Accept**. If you cancel, or the signed-in Microsoft account is not a Global Administrator, Rhythms shows **Failed to setup integration for Teams** and nothing is installed; ask a Global Administrator to run Step 1 again. ## Step 3: Confirm the install in Rhythms Back on **Settings › Workspace › Collaboration platforms**, the Microsoft Teams card shows **Installed** and a message confirms that all members of the organisation can now see and access Rhythms in Teams. ![The Collaboration Platforms page with the Microsoft Teams card showing an Installed badge](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-95f27e3e97043b9b671f3d9e854c5af009925fec%2Ff680cb7f-b0d6-4ea5-925d-f719fa5f982b-Collaboration_Platforms.png?alt=media) ## Step 4: What your users see Rhythms matches each Rhythms user to a Microsoft account by email and installs the Rhythms app for them. It also installs the app for a user the first time it sends them a Teams notification. Users can then open it: 1. In Teams, search for **Rhythms** in the top search bar or in **Apps**. 2. Click the Rhythms app. The **OKRs** tab opens with the user's Rhythms OKRs. If they are not already signed in, sign-in opens in a small pop-up window. 3. Right-click the Rhythms icon in the left rail and choose **Pin** so it stays in the sidebar. ![Searching for Rhy in the Microsoft Teams search bar, with the Rhythms app shown in the results](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-fc66de40e0efdd826e3fa21c2c6c4c6ce4609fdf%2F42cecbc7-5426-42ec-ba91-2368a72bd7cd-Activity.png?alt=media) ![The right-click menu on the Rhythms app icon in Teams, with Pin highlighted](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-302fe4d2bccc7cf9a8f25f3ac4c6a5bc391c0215%2F932aff83-7472-431b-8cde-572c7e3243c1-Q_Search_for_apps.png?alt=media) ## What the Teams app does, and does not do The Rhythms app in Teams is a personal tab that loads the Rhythms OKRs page inside Teams. In the tab, users can do what they can do on the OKRs page in the web app: browse and filter OKRs, open a goal, and record check-ins. Rhythms notifications, such as check-in reminders, arrive in the Teams **Activity** feed and open the OKRs tab on the relevant goals. The Teams app has no bot. Users cannot message Rhythms in a Teams chat or channel, and Rhythms does not read Teams conversations. For conversational use, open Rhythms in the browser or use [Rhythms in Slack](/getting-started/getting-started-in-slack/getting-started-with-rhythms-in-slack.md). ## Reinstall or uninstall On **Settings › Workspace › Collaboration platforms**, open the menu on the Microsoft Teams card. **Reinstall** runs the consent flow again and keeps everyone's history; use it when permissions change. **Uninstall** removes the connection for the whole workspace and ends Rhythms notifications in Teams; reinstalling later does not restore what was lost. ## Troubleshooting * **A user cannot find Rhythms in Teams.** Confirm the card shows **Installed**, that the user has a Rhythms account on the same email as their Microsoft account, and that your organisation's Teams policies allow third-party apps. Restarting Teams refreshes the app list. * **The tab asks the user to sign in or shows an access error.** The user must sign in to Rhythms with the same email as their Teams account. Sign-in opens in a pop-up; allow pop-ups for Teams if it is blocked. * **The tab opens but shows no OKRs.** The user sees the same OKRs as in the web app. Check their role, team membership and the visibility of the OKRs they expect. * **Consent failed.** Rhythms shows **Failed to setup integration for Teams** when consent is cancelled or the Microsoft account is not a Global Administrator. Ask a Global Administrator to repeat Step 1. ## FAQ **Do all Rhythms users get the Teams app automatically?** Yes, once a Rhythms Admin completes the install. Rhythms installs the app for every user it can match by email, and again the first time it notifies a user who does not have it yet. Users still need to open and pin the app the first time. **Do users have to accept permissions individually?** No. The Global Administrator's consent applies to the whole organisation and individual users are not prompted. **Who needs which admin role?** A Rhythms Admin starts the install in Rhythms. A Microsoft Global Administrator (or Privileged Role Administrator) accepts the consent screen. Regular users need only their normal Teams access. **Does it work for external collaborators?** Only for people who are members of your Rhythms workspace and have a matching account in your Microsoft 365 tenant. Add external collaborators to Rhythms first. **Can I chat with Rhythms in Teams?** No. The Teams app is a tab showing your OKRs and delivers notifications to the Activity feed. Chat with Rhythms in the web app or in Slack. ## Related articles * [Connect Rhythms to Your Favorite Collaboration Platforms](/connectivity/connect-rhythms-to-your-favorite-collaboration-platforms.md) * [Getting started with Rhythms in Slack](/getting-started/getting-started-in-slack/getting-started-with-rhythms-in-slack.md) * [Sign in to Rhythms](/getting-started/basics/sign-in-to-rhythms.md) * [User Management in Rhythms](/workspace-settings-and-administration/team-users-and-access/add-and-manage-users.md) * [Troubleshooting and Support](/workspace-settings-and-administration/troubleshooting-and-support.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.rhythms.ai/getting-started/getting-started-in-microsoft-teams/install-rhythms-in-microsoft-teams.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.