# Zoom

## Verified Mago App for Zoom Marketplace

If you want to activate the instant meeting feature and Host access to Zoom meetings, you need to authorize the verified Mago app on the Zoom Marketplace.

{% hint style="success" %}
Note: It is not required for **guest access** to Zoom meetings.
{% endhint %}

The app can be reached at the following link:

{% embed url="<https://marketplace.zoom.us/apps/b_8zLZb8QQa-_ray1PWAKg>" %}

## Required features and scopes

| Mago – Feature                                                                                     | Required Scope Permissions                                        |
| -------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| Search for directory users to invite when starting an instant Zoom meeting from the room calendar. | <p>View user contacts</p><p><code>contact:read</code></p>         |
| Start or end an instant Zoom meeting directly from the room calendar.                              | <p>View and manage meetings</p><p><code>meetings:write</code></p> |
| View the room user's email and revoke a token when requested by the user (account logout).         | <p>View user information</p><p><code>user:read</code></p>         |
| Receive a ZAK token when requested by the user.                                                    | <p>View user's ZAK token</p><p><code>user\_zak:read</code></p>    |

{% hint style="info" %}
Before integrating your account in Mago Room it is required to approve the install of the Mago app in the Zoom marketplace, as explained below:
{% endhint %}

1. Visit [**https://marketplace.zoom.us**](https://marketplace.zoom.us) and sign in with the Zoom account used by the room.
2. Search for the "Mago" app and **Approve the install of the app** by activating the corresponding switch.

{% hint style="warning" %}
For Mago **4.1 and above**, please refer to the "Mago Room" app:

<https://marketplace.zoom.us/apps/b_8zLZb8QQa-_ray1PWAKg>

For Mago **4.0 and below (formerly "Valarea")**, please refer to the "Valarea Room 4" app:

<https://marketplace.zoom.us/apps/rYVYMDRKTXm0jc-O1_na7w>
{% endhint %}

<figure><img src="https://2978719120-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M2FbpP2hYI1Myy7hMs_%2Fuploads%2FdFbx4w0SL9PUb6z1CE1S%2FScreenshot%202023-02-11%20alle%2006.57.35.png?alt=media&#x26;token=23394873-5e1c-445b-ad1c-95a94430ba9b" alt=""><figcaption></figcaption></figure>

### How to disconnect a Zoom account from Mago Room (Token revocation)&#x20;

If you want to disconnect a Zoom account from Mago Room, please follow these steps:

* Open the Mago Room Wizard or Settings
* Navigate to the "Instant Meeting" step or section
* Locate the Zoom option and press "Disconnect"

{% hint style="info" %}
Mago Room will automatically revoke the authorization token. In order to enable Zoom instant meetings again, you will have to connect to your account and complete the OAuth process again.
{% endhint %}

### How to deauthorize the app

If you want to deauthorize the Mago or Mago Room app, please follow these steps:

* Visit [**https://marketplace.zoom.us**](https://marketplace.zoom.us) and sign in with the Zoom account used by the room.
* Deauthorize by turning the switch off (see image)

{% hint style="info" %}
You can also manage authorization for single users under the "Manage" section
{% endhint %}