Jump to:
This article covers the Microsoft Teams integration: making YAROOMS views available as tabs inside the Teams app, both desktop and web. The integration generates a Teams app package (manifest + icons) that you upload to your Teams tenant.
Until the Teams integration is configured, users who open a YAROOMS Teams tab will see an “Inactive Teams Integration” message.
1. Requirements
You need:
- Admin access to your Microsoft Entra ID tenant (Azure Portal).
- Admin access to your YAROOMS workspace.
- Permission to upload a custom app package to your Microsoft Teams tenant.
2. Register the app in Azure Portal
In Azure Portal go to Manage Microsoft Entra ID → App Registrations and click + New Registration.
Under Supported account types, choose Single tenant.
Certificates and secrets
Open the Certificates & Secrets tab, create a New Client Secret, and copy the string from the Value column.
Warning: The client secret value is only shown at creation time. Store it securely before leaving the page, then paste it into YAROOMS in step 3. Copy the Value, not the Secret ID.
Authentication
Open the Authentication tab and click + Add a platform → Single-page application.
- Redirect URI:
https://[domain].yarooms.com/account/login(replace[domain]with your YAROOMS subdomain). - Under Implicit grant and hybrid flows, check Access tokens and ID tokens.
- Under Advanced settings, set Allow public client flows to Yes.
API Permissions
Open API permissions and configure the following Microsoft Graph API permissions:
Application Permissions:
Directory.Read.AllUser.Read.All
Delegated permissions:
emailoffline_accessopenidprofile
Expose an API
Open the Expose an API tab.
Set Application ID URI to:
api://[subdomain].yarooms.com/[application-client-id]
For example: api://CompanyName.yarooms.com/9ff10a06-077d-46a3-ad9d-3a42dfe5f1b1.
Click + Add a scope and fill in:
- Scope name:
User.Read - Who can consent?: Admins only
- Admin consent display name: Read user details
- Admin consent description: Read user details
- State: Enabled
Under Authorized client applications, add the Teams client IDs with the scope you just created checked:
| Client ID | Application |
|---|---|
5e3ce6c0-2b1f-4285-8d4b-75ee78787346 | Teams web application |
1fec8e78-bce4-4aaf-ab1b-5451cc387264 | Teams mobile or desktop application |
3. Configure the integration in YAROOMS (Teams Add-in)
Log in to YAROOMS as an administrator and navigate to Settings → Integrations → Microsoft Teams Add-in.
In the Options tab, configure the Microsoft 365 app section:
- Integration active: turn on.
- Tenant ID: the Directory (tenant) ID from step 2.
- Client ID: the Application (client) ID from step 2.
- Client secret: the secret Value (not Secret ID) from step 2.
Under Emails, use Hide email links to control booking links in confirmation emails. When enabled, confirmations for bookings created from the add-in do not include the booking link. This setting does not mean confirmation emails are disabled.
Click Save.
4. Customize the Teams Add-in app package
Open the Design tab to customize how YAROOMS appears in Teams.
Under Application, configure:
- Name: short app name users will see in the Teams app bar (e.g., “YAROOMS”).
- Description: short description shown during installation.
- Logo: upload a 192x192 PNG. Used as the Teams app icon.
Under Tabs, configure the pages users can open inside the Teams app. Each row has a Tab name and a Path. The screenshot includes Map (
/workplace/map), Timeline (/workplace/timeline), Calendar (/calendar/calendar), and Bookings (/workplace/bookings).
Use the up and down arrows to reorder entries, and the trash icon to remove an entry. Use Add tab to the list to add another tab. A path can identify a YAROOMS page; the example also includes a full URL for training content.
Note: The Chat tab is fixed. The editable list controls the other pages shown as tabs inside the Teams app.
Click Save to persist your changes, then click Download application to generate the Teams app package.
Finalize the app name, logo, and tab list before downloading the package. If you change the design later, download an updated package and use it when updating the app in Teams.
5. Install YAROOMS in Teams
You have two ways to surface YAROOMS inside Microsoft Teams:
Option A. Install the Teams Add-in custom app package (recommended)
Upload the app package you downloaded in step 4 to your Teams tenant. Once installed, YAROOMS appears as an app with the tabs you configured.
For step-by-step instructions, see Adding YAROOMS to your Teams sidebar.
Option B. Add individual website tabs
Alternatively, open any Teams channel or chat, click + to add a tab, choose Website, and enter one of the URLs below:
https://[domain].yarooms.com/workplace/maphttps://[domain].yarooms.com/workplace/timeline
Replace [domain] with your YAROOMS subdomain. A website tab can only display one view, so create multiple tabs if users need quick access to several YAROOMS screens.
