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 package | Teams app from Virto’s server | |
|---|---|---|
| Who installs it | A SharePoint Administrator, in the App Catalog | A Teams Administrator, in the Teams admin center |
| Who approves the permissions | A Global Administrator, in SharePoint admin center → API access | A Global Administrator, as the app’s admin consent in the Teams admin center |
| Where it runs | SharePoint pages | Teams 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
- Open the SharePoint App Catalog of your tenant and upload the Virto Desk & Room Booking App package (
.sppkg). - 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.
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.
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.

What people see until the admin consent is granted 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.
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.

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.
| Message | What to do |
|---|---|
| Microsoft Graph permissions are not approved yet | A 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 yet | The 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 organization | A 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 buildings | A 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 read | Microsoft 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 calendar | The 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 office | Rooms 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 role | A 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 read | The 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 401 | The sign-in token of this window is older than the approval. Sign out and in, or open a new InPrivate window. |