Microsoft Teams: Integration Setup

Bring YAROOMS into Microsoft Teams with the YAROOMS app. You do not need to register an Azure AD app.

YAROOMS for Microsoft Teams is the YAROOMS app for Microsoft Teams on desktop, web, and mobile. It gives your users:

  • A YAROOMS app in Teams with the pages you choose, such as the floor map, the day view, bookings, and your custom pages.
  • Single sign-on with their Microsoft work account. There is no separate password.
  • YAROOMS notifications as Teams chat messages: booking confirmations and changes, approval requests and decisions, check-in and check-out reminders, invitation answers, and visitor arrivals.

You do not register an Azure AD app, and you do not handle a client ID, a client secret, or a manifest.

Note: The app is not in the Microsoft Teams store yet. Until it is, ask your Customer Success Manager for the .zip package. Your Teams administrator uploads it to your organization. We will update this article when you can install the app from the store.

Note: If your workspace runs in a dedicated environment, see Microsoft Teams: Custom Teams Integration.

Before you start

You need:

  • A YAROOMS administrator account that can manage integrations.
  • Login with Microsoft active in YAROOMS. YAROOMS for Microsoft Teams finds and creates users through it. Until it is active, the settings page shows a warning with a Set up Login with Microsoft link. See Login with Microsoft.
  • A Microsoft account with the Global Administrator or Teams Administrator role in your Microsoft tenant. You need it to connect the tenant and to upload the app.

1. Get the YAROOMS app package

Ask your Customer Success Manager for the YAROOMS for Microsoft Teams .zip package.

Do not unzip or change the file. Teams accepts the package only as you receive it.

2. Connect your Microsoft tenant

  1. In YAROOMS, go to Settings → Integrations → YAROOMS for Microsoft Teams.
  2. In Connection, click Connect Microsoft tenant. The Microsoft sign-in opens in a new browser tab.
  3. Sign in with a Microsoft account that has the Global Administrator or Teams Administrator role. The YAROOMS administrator and the Microsoft administrator can be two people at the same computer.
  4. On the Microsoft consent page, click Accept. This lets YAROOMS read the Microsoft profile and photo of each user who signs in.
  5. Go back to the YAROOMS tab. When the connection is complete, YAROOMS shows Microsoft tenant connected, and the Connected Microsoft tenant field shows your tenant ID.

Finish the Microsoft sign-in within 20 minutes, in the same browser. If you need more time, click Connect Microsoft tenant again.

Note: If you decline the consent, the tenant still connects. Users can sign in, but YAROOMS does not show their Microsoft profile photo. You can grant the consent later in the Microsoft Entra admin center, under Enterprise applications → YAROOMS → Permissions.

If the page shows Ask YAROOMS support to connect your Microsoft tenant, or if no one in your organization has one of the two Microsoft roles, contact YAROOMS support. Support can connect the tenant for you. Send your tenant ID from the Microsoft Entra admin center (Overview → Tenant ID).

3. Choose the options and pages

On the same page, under Options:

  • Personal app and tabs: shows the YAROOMS app with your pages in Teams.
  • Teams notifications: sends booking and visitor notifications as Teams chat messages.

Under Pages:

  • Default page: the page that opens first in the YAROOMS app.
  • The list of pages that users can open in the app. Use the arrows to change the order and the trash icon to remove a page. Use Add a page to add a YAROOMS page or a published custom page. If the list is empty, the app shows Map, Day, and Bookings.

Click Save changes.

YAROOMS for Microsoft Teams Options and Pages sections with the notification switches, the default page, and the page list

You can change the pages at any time. The YAROOMS app in Teams shows the new pages without a new app package.

4. Upload the app to Microsoft Teams

A Teams administrator uploads the package in the Teams admin center:

  1. Open Teams admin center → Teams apps → Manage apps.
  2. Select Actions → Upload new app, click Upload, and select the .zip package from your Customer Success Manager.
  3. Make sure that the YAROOMS app is Allowed for your users.
  4. Optional: to show YAROOMS in the Teams sidebar for everyone, open Teams apps → Setup policies and add YAROOMS to the installed apps and the pinned apps of a policy.

For screenshots of these steps, see Adding YAROOMS to your Teams sidebar.

5. What your users see

  • Users open YAROOMS from Apps in Teams, or from the sidebar if you pinned it. Teams signs them in with their Microsoft work account.
  • If your Microsoft tenant is connected to more than one YAROOMS workspace, users choose a workspace the first time. YAROOMS remembers the choice.
  • Users choose their Teams notifications in My account → Notifications, in the Microsoft Teams column. Administrators set the defaults for everyone in Settings → Account → Notifications. See Notification settings.
  • A user gets Teams messages only after they open the Chat tab of the YAROOMS app once. The first message is a welcome message.

Disconnect the Microsoft tenant

In Settings → Integrations → YAROOMS for Microsoft Teams, click Disconnect next to Connected Microsoft tenant, then confirm.

Warning: Disconnecting forgets the connected Microsoft tenant, the users who signed in through it, and the Teams chats that the app opened. Your users keep the app in Microsoft Teams, but they cannot sign in until an administrator connects the tenant again. You cannot undo this.

Troubleshooting

What you seeWhat to do
The app shows No YAROOMS workspace found and asks for your workspace address.Your Microsoft tenant is not connected yet. Do step 2. The Configure here link in the app opens the settings page of the workspace that you typed.
The connection fails with Sign in with a Global Administrator or Teams Administrator account.Sign in with a Microsoft account that has one of these roles.
The connection page says that the link is invalid or expired.More than 20 minutes passed, or you used another browser. Click Connect Microsoft tenant again.
The YAROOMS app in Teams says that the link is invalid or expired.Close the YAROOMS app and open it again.
A user cannot sign in because provisioning is disabled.The user has no YAROOMS account. Create the account, or turn on user provisioning in Login with Microsoft.
A user gets no Teams notifications.Check that Teams notifications is on, that the user turned on the notification in the Microsoft Teams column, and that the user opened the Chat tab of the app once.

Can't find what you're looking for?

Our support team is here to help. Reach out and we'll get back to you quickly.

Contact Support

We use cookies to analyze traffic and improve your experience.

Cookie preferences

Essential

Required for the site to function

Always on
Analytics

Help us understand how visitors use the site

Marketing

Used to deliver relevant ads

Talk to Sales or Support