Jump to:
What the integration does
Once connected, Yarvis can interact with YAROOMS on behalf of your team. People can ask Yarvis to book meeting rooms, check room availability, reserve desks, and manage their workspace reservations, all through natural conversation in Microsoft Teams or email.
For example, someone can message Yarvis:
Book a meeting room for 10 people tomorrow at 2 PM
Yarvis checks availability in YAROOMS, finds a suitable room, and makes the booking. Each person’s actions go through their own YAROOMS account, so bookings respect individual permissions and location access.
Prerequisites
- YAROOMS admin access with the Manage integrations permission
- Your YAROOMS plan must include API access
- Yarvis must already be installed and working in Microsoft Teams
Step 1: Find your YAROOMS URL
Yarvis needs your company’s YAROOMS domain to connect to the right account. Your URL follows this format:
- Global:
your-company.yarooms.com - Europe:
your-company.eu.yarooms.com - Canada:
your-company.ca.yarooms.com
To find it, open your browser and log in to YAROOMS. The URL in the address bar is your YAROOMS domain. Copy just the domain part (e.g. acme.eu.yarooms.com) – you will need it in Step 3.
Step 2: Create an API key in YAROOMS
- Log in to your YAROOMS account as an administrator.
- Go to Integrations from the main menu.
- Under Internal Integrations, click YAROOMS API.
- Click Add.
- Enter a name for the key (e.g. “Yarvis Integration”).
- Select an expiry period. Choose a longer duration (e.g. 1 year or 2 years) so the integration does not need frequent reconfiguration.
- Click Submit.
- Click the clipboard icon next to the new key to copy it. Save the key somewhere safe – you will need it in the next step.
Important
The full API key is only shown once. If you lose it, you will need to delete the old key and create a new one. Copy it before leaving the page.
Step 3: Activate the integration in Yarvis
Open Microsoft Teams and send Yarvis a message with your YAROOMS domain and the API key you copied:
Connect to YAROOMS at acme.eu.yarooms.com with API key [paste your key here]
Replace acme.eu.yarooms.com with your actual YAROOMS domain from Step 1. Yarvis will validate the key against your YAROOMS account and enable the integration. Once confirmed, Yarvis replies with a success message and is ready to handle room and desk bookings.
You must be a Yarvis admin to run this command. Yarvis automatically detects Azure AD admin roles (Global Administrator, Teams Administrator), so if you hold one of those roles, you are already a Yarvis admin.
Testing the integration
To verify everything is working, send Yarvis a quick message:
Do I have a desk booked for tomorrow?
Yarvis should check your YAROOMS account and reply with your booking details or let you know that nothing is booked yet. If you get an error instead, see the Troubleshooting section below.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| “API key is invalid” | The key was mistyped or has expired | Create a new API key in YAROOMS and try again |
| “User not found in YAROOMS” | The user does not have a YAROOMS account | Ask your YAROOMS admin to create an account for the user |
| “Account suspended” | The user’s YAROOMS account is suspended | Ask your YAROOMS admin to reactivate the account |
| Yarvis stops booking rooms after a while | The admin API key has expired | Create a new key in YAROOMS with a longer expiry and reconnect |