Content
Table of Contents | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Create a User in TOPDesk
1️⃣ Create an Authorisation group with the name ROOMZ-API
and assign the following rights to the group:
Ruprik | Settings | Read | Change | Create |
...
Delete | |||||
Reservation-management | Reservation requests | x | x | x |
|
reservations | x | x | x |
| |
reports about reservations | x |
|
|
| |
reports about object reservations | x |
|
|
| |
reports for rooms | x |
|
|
| |
report assistant services | x |
|
|
| |
KPIs for reservations | x | x | x |
| |
KPIs for object reservations | x | x | x |
| |
KPIs for room reservations | x | x | x |
| |
KPIs for services | x | x | x |
| |
setup reservations management | x |
|
|
| |
Report-API | REST API | x |
|
|
|
Data access for extended reporting | x |
|
|
| |
use application passwords |
| x |
|
| |
reservation overview API | x |
|
|
|
2️⃣ Create a new editor
and link him with the authorisation group created before, login now in top desk with the new editor and create a new application password (my settings).
Note |
---|
Please not the password, this is only visible once! |
3️⃣ Move to the next step.
Setup
Go to the Portal and navigate to Settings – > Bookingsystem, click on + Add Bookingsystem:
...
Provide the URL of the space you want to connect, e.g.
https://topdesk.yourdomain.com/tas/api
Paste Username and password
Click 'Save.'
Setup Instant booking
To be able to book and release meetings with the ROOMZ Display, you need to follow these steps:
Create a new
person
, with this person the ROOMZ Server is able to create bookings (Instant books). It is important that this person is able to reserve the meeting rooms, check the permissions for the self-service portal.To get the UUID (requester ID) you need to go to:
the settings of the person you would like to get the ID
click to
more
select
print
now a new page will open, you can see the UUID in the URL, copy the UUID and format it like it is requested from the ROOMZ Portal:
XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX (8 digits / 4 / 4 / 4 / 12)
Enter this number as
requester ID
in the settings of the booking system in ROOMZ:use a ROOMZ Display to check if an instant book is working, if the book button is not visible make sure that the room is free for at least 15' and instant book is active in the option set
Add resources
Fetching resources:
Click on the booking system
On the top right, click on fetch resources
...