With the Cisco Webex Room Kit integration, Joan is able to automatically book and release meeting rooms when you enter/leave them, with you not having to worry about anything.

In order to make this integration work, you will need the following:

- A [Cisco Webex Admin account](https://admin.webex.com/)
- A [Cisco Webex Room Kit with an integrated camera](https://www.cisco.com/c/en/us/products/collaboration-endpoints/webex-room-series/index.html#~stickynav=1)
- A [A MyJoan account](https://my.getjoan.com/)
- A [Joan device](https://getjoan.com/shop/)

## How to integrate Joan with Cisco Webex Room Kit

Please make sure the Cisco Webex Room Kit is running on version 9.12.0 or higher. Once you have all the equipment ready, follow the instructions below to set it up:

1. Log in to your [Cisco Webex Admin account](https://admin.webex.com/)
2. Navigate to “**Devices**” in the left-hand side menu

![Screenshot 2020 06 12 at 13.52.39](https://getjoan.com/help/api/media/file/Screenshot-2020-06-12-at-13.52.39.png)

3. Here you will be able to configure the connected Cisco Webex Room Kit. Select a device and in the bottom-right corner click on "**Launch web portal**"

![Screenshot 2020 06 12 at 13.53.07](https://getjoan.com/help/api/media/file/Screenshot-2020-06-12-at-13.53.07.png)

4. After clicking on the link, you will be redirected to the Cisco Webex Room Kit "**Set up**" interface
5. Click “**Integration**”
6. Followed by “**Macro Editor**”

![Screenshot 2020 06 12 at 13.53.26](https://getjoan.com/help/api/media/file/Screenshot-2020-06-12-at-13.53.26.png)

7. In the top left corner click “**Import from file**” and upload this [file here.](https://getjoan.com/r/cisco-download)
8. When uploaded you will need to configure the following:

- Connect your Joan account with Cisco device by creating a new API client id and secret under [https://portal.getjoan.com/settings/integrations/](https://portal.getjoan.com/settings/integrations/)
- Copy/paste client id and secret to the uploaded macro file, under the variables:\
    **JOAN\_CLIENT\_ID** and **JOAN\_CLIENT\_SECRET**
- Copy/paste room id to **ROOM\_ID** variable. You can find it here: [https://portal.getjoan.com/manage/resources/](https://portal.getjoan.com/manage/resources/) by clicking on a room

![Screenshot 2020 06 12 at 14.13.12](https://getjoan.com/help/api/media/file/Screenshot-2020-06-12-at-14.13.12.png)

- Edit **MIN\_BEFORE\_BOOK** and **MIN\_BEFORE\_RELEASE** variables (set in minutes) to suit your needs. Those two variables set the threshold for how many minutes does the room need to be occupied or empty before an action (auto book/release/check-in) occurs. We recommend setting those two numbers lower for a huddle space (e.g. 2 or 5 minutes) and higher for large boardrooms (5 or 10 minutes).

9. When you have all the variables set up, you can turn the integration ON by toggling the button.

![presence](https://getjoan.com/help/api/media/file/presence.png)

10. If everything is set up correctly you should see the logs starting to populate.

![Screenshot 2020 06 12 at 14.20.26](https://getjoan.com/help/api/media/file/Screenshot-2020-06-12-at-14.20.26.png)

And that’s it! You have successfully integrated Joan with your Cisco Webex Room Kit. You can now simply walk into your meeting room, and it will automatically be booked.
