Contact us

Installation and setup

There are two ways to install the app. Both show the same screens and the same bookings, which are kept on Virto’s server, and they can be used side by side in one tenant.

SharePoint packageTeams app from Virto’s server
Who installs itA SharePoint Administrator, in the App CatalogA Teams Administrator, in the Teams admin center
Who approves the permissionsA Global Administrator, in SharePoint admin center → API accessA Global Administrator, as the app’s admin consent in the Teams admin center
Where it runsSharePoint pagesTeams channel, chat and meeting tabs, the Teams personal app, Outlook and the Microsoft 365 app

The SharePoint Administrator and the Teams Administrator can be different people.

SharePoint package

1. Upload the package

  1. Open the SharePoint App Catalog of your tenant and upload the Virto Desk & Room Booking App package (.sppkg).
  2. Deploy it to the tenant.

2. Approve the Microsoft Graph permissions

The package asks for three Microsoft Graph permissions. A Global Administrator approves them once in SharePoint admin center → Advanced → API access; a SharePoint Administrator cannot. It can take up to an hour, or a new sign-in, before an approval is active. What each permission is for is listed in Permissions and data.

At start-up the app checks which permissions are approved. If one is missing, it says so at the top of the page, with a link to API access and a ready message for the administrator. Admin → Permissions lists all three.

3. Add the web part

Add the Virto Desk & Room Booking web part to a page of any SharePoint site. To use the whole window, put it in a full-width section or on an App page. Nothing else needs to be set up on the site: the bookings are not kept there, and people need no permissions on it beyond opening the page.

Owners of that site administer the app by right; see Administrators.

Teams app from Virto’s server

This app loads from Virto’s server and signs people in with their Microsoft 365 account. No package goes to the SharePoint App Catalog.

  1. Teams Administrator: in the Teams admin center, open Teams apps → Manage apps → Upload new app and upload the Teams app package of Virto Desk & Room Booking App.

  2. Global Administrator: in Manage apps, open the app, then Permissions → Grant admin consent. Until then, people who open the app see “Your organization has not approved the app yet”. It can take up to an hour before the approval is active.

    The message of Virto Desk & Room Booking App when the admin consent is missing: the three permissions, what does not work, Open Manage apps (Teams admin center) and Copy a request for the administrator
    What people see until the admin consent is granted
  3. People: open the app as a Teams personal app, or in Outlook or the Microsoft 365 app, where it appears once it is installed in Teams. Nothing to set up: the app finds your organisation from the sign-in.

  4. Team owner or meeting organiser: to give a channel, a group chat or a meeting its own tab, press + next to the tabs, search for “Virto Desk & Room Booking” and add it. The tab opens the app at once, with no set-up step.

A guest opens the app from the tab in the team or chat of the inviting organisation.

Virto Desk & Room Booking App as a tab in a Microsoft Teams meeting chat: the Desk & Room Booking tab next to Chat, Shared and Recap, with Book a desk open
The app as a tab in a Teams meeting chat

Set up Microsoft Places

The app books only what Microsoft Places and Exchange already have. If Microsoft Places has no buildings yet, follow Setting up Microsoft Places, or start with the Demo office wizard. It opens by itself when Microsoft Places has no buildings at all, and any time from Demo office in the menu. It creates a small demo building and removes it again.

Subscription and administrators

The first visit from your tenant starts a trial, and a note at the top of the app says how many days are left. Admin → Subscription shows the licence and links to the purchase. See Subscription and trial.

Global Administrators, SharePoint Administrators and the owners of the SharePoint site of the page administer the app by right. To let other people manage it, name them in Admin → Administrators. See Administrators.

If something does not work

The app says at the top of the page what is missing. Help → Messages in the app lists every message with what to do.

MessageWhat to do
Microsoft Graph permissions are not approved yetA Global Administrator approves them: in API access for the SharePoint package, or with Grant admin consent in the Teams admin center for the Teams app. Reload after the approval; it can take up to an hour.
Your organization has not approved the app yetThe Teams app from Virto’s server is not consented yet. A Global Administrator grants the admin consent in Teams admin center → Manage apps → the app → Permissions.
Your account is not in this organizationA guest opens the app from the tab in the team or chat of the inviting organisation.
No offices in Microsoft Places yet / Microsoft Places shows no buildingsA Places Administrator adds buildings in Microsoft Places, or buildings are switched off for the organisation: run the PowerShell lines shown in the note (up to 12 hours). See Setting up Microsoft Places.
The offices could not be readMicrosoft 365 did not answer, usually a service incident on Microsoft’s side that passes by itself. Press Try again after a few minutes. If it lasts, an administrator checks Service health (Exchange Online) in the Microsoft 365 admin center.
You have no Exchange Online mailbox / No calendarThe person has no licence with Exchange Online. An administrator assigns one in the Microsoft 365 admin center. Until then, rooms and equipment cannot be booked, and desk and parking bookings are saved without a calendar entry.
No meeting rooms are linked to this office / No equipment is linked to this officeRooms and equipment are Exchange mailboxes that Microsoft Places links to a building, which can take up to 24 hours. See Meeting rooms and Equipment.
Publishing a map needs the Exchange Administrator or Places Administrator roleA Global Administrator assigns the role in Microsoft 365 admin center → Roles and approves Place.ReadWrite.All. Reload and try again.
The license could not be readThe app works as licensed meanwhile. Check the network and press Refresh in Admin → Subscription; if it repeats, send the time of the attempt to Virto support.
Places diagnostics says HTTP 401The sign-in token of this window is older than the approval. Sign out and in, or open a new InPrivate window.
Updated on November 17, 2026