# Event Integration with Zoom

### Overview

The integration between MangoApps and Zoom is designed to streamline organizing and participating in online meetings directly within MangoApps. This out-of-the-box capability allows event organizers to set up Zoom meetings effortlessly without accessing the Zoom desktop or web applications.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F6G9CCnkSSXbI0nXmo3m1%2Flogo_ZM_wordmark_bloom.png?alt=media&#x26;token=b51d91f7-2619-4dd9-9131-2eb43ef958fe" alt="" width="375"><figcaption></figcaption></figure>

With this integration, event organizers can automatically generate a Zoom link for attendees, easily scheduling meetings. This functionality enhances productivity, simplifies workflows, and ensures a smooth user experience for both organizers and participants.

***

### Role Prerequisites

* **MangoApps Domain Admin Role**: Required to enable event integration.

***

### Enable the Integration in MangoApps

To get started on the MangoApps side, **Log in** to your MangoApps domain using your preferred sign-in method.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FunfJnLPN6mKAZiHa4RK4%2Fehsers.png?alt=media&#x26;token=5242a713-ea25-45b9-8a9a-d756e578bb91" alt="" width="563"><figcaption></figcaption></figure>

After log in, we will first configure the admin portal settings for the integration.

Click your **profile picture** in the top-right corner to open the options menu. Select the **Manage Domain**  option from the menu <mark style="color:red;">(visible</mark> <mark style="color:red;"></mark><mark style="color:red;">**only**</mark> <mark style="color:red;"></mark><mark style="color:red;">for users with the Network Admin role)</mark>.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FySSXIA61RTZXIg6WUqa0%2Fhresthsert.png?alt=media&#x26;token=1b0ecdfb-82df-4316-81ed-e5711c5e0948" alt="" width="563"><figcaption></figcaption></figure>

In the **Admin Portal**, click **Modules** on the left-hand navigation menu and navigate to **Calendar**. Click the **Module Settings button** to access the **Calendar** module settings.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FuuQ8FHZbKfNYKRCHkEp1%2Fhrthstr.png?alt=media&#x26;token=5a9a737a-2458-486c-a3d0-52ae445fbccf" alt="" width="563"><figcaption></figcaption></figure>

In the **Calendar Module Settings**, go to the **Integration tab** and toggle **Zoom Meeting** to **ON**.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FkOZtWapypuWglOOiomBG%2F05-12-2024-10-50-44.png?alt=media&#x26;token=39256358-050c-40c4-b1ec-512624288cd7" alt="" width="563"><figcaption></figcaption></figure>

A confirmation message will appear at the top of the page, indicating that Zoom Meeting integration is enabled.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FqBIXvl1hOV9xxMYoCzfB%2Fryjdtyj.png?alt=media&#x26;token=ba01086a-7260-4723-b5a0-279fbfb7248d" alt="" width="563"><figcaption></figcaption></figure>

***

### Scheduling an Event Using a Zoom Link

Next, we will schedule an event which will be using a Zoom link.

Navigate to the **User Portal**. If currently viewing the Admin Portal, click your profile picture in the top right corner and select **Go to User Portal**.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2Fv8CjWIvwkUL3BBVXyXSR%2Fghdfhs.png?alt=media&#x26;token=53214c2a-67fc-4eaf-8827-32eb002163cd" alt="" width="563"><figcaption></figcaption></figure>

Once in the **User Portal**, click the **global compose button** and select **Event**.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2Fc7Ff3VbBYPzfbAUchA3y%2Fgfwargawe.png?alt=media&#x26;token=5b507000-2488-4467-9a51-8f7279406868" alt="" width="563"><figcaption></figcaption></figure>

Or navigate to the **Calendar module** and click **Create an Event** from the **Calendar Tools** drop down menu on the right hand side.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FDdO9BIR83ycWbsjr6Xve%2F05-12-2024-10-20-34.png?alt=media&#x26;token=63ad2619-9d9c-4b5a-9692-a1e634e9a2f1" alt="" width="563"><figcaption></figcaption></figure>

In the **Create Event** dialog box, set the **Event Type** to **“Online”** and set the **Event Link** as **Zoom Meeting**.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FrXVCMRApcAtrCnuoD9r9%2F05-12-2024-10-23-16.png?alt=media&#x26;token=c0c1ef46-fa7a-431c-ba0d-c5af9a8de12a" alt="" width="563"><figcaption></figcaption></figure>

If not already logged in to Zoom, you will be prompted to log in and authenticate your Zoom account.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2Fa85M6cjnjH27DXIs7HbU%2F05-12-2024-10-23-16a.png?alt=media&#x26;token=19479253-ec16-4c98-aefe-a6f0db89f02e" alt="" width="563"><figcaption></figcaption></figure>

Clicking on **Login required** will redirect you to the zoom account login page. Follow the prompts to log in to your Zoom account and grant the necessary permissions.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FXr0hlyIYvC0VcJ6e7GqJ%2Fukfytukrfuyt.png?alt=media&#x26;token=e600594e-bf7f-49e2-a18e-656e37cc0782" alt="" width="563"><figcaption></figcaption></figure>

After authentication, MangoApps will configure the event link as a Zoom meeting. In order for the process to continue, make sure to consent to the MangoApps permission request in Zoom by clicking the **Allow** button.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FDMVdnPoM8npwVhrHXSje%2Fkjdtykj.png?alt=media&#x26;token=5de6041e-31f8-42c0-a3cf-74ca50f76d5e" alt="" width="563"><figcaption></figcaption></figure>

On granting permission, you will be redirected back to MangoApps event creation. The **Event Link** will now show as below, indicating the link has configured to set a Zoom meeting for the respective event.&#x20;

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FuXkIefyvXJQHy5nBEUrE%2F05-12-2024-10-34-01.png?alt=media&#x26;token=d61d4b07-bcdc-402f-9a91-123b43a42434" alt="" width="563"><figcaption></figcaption></figure>

From this point, event organizers can complete event creation by filling in the rest of the detail fields and clicking the **Create** button. Once successfully created, the event will show with the Zoom meeting link in both the **Calendar** module and widget.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FVGPGVK93k61M1uJhePgS%2F05-12-2024-10-37-44.png?alt=media&#x26;token=6218fd92-44eb-4582-a943-d657ff5232c5" alt="" width="557"><figcaption></figcaption></figure>

***

### **End-User Experience in MangoApps**

#### **Event Notification**

Participanting users will see the event invite in their MangoApps newsfeed.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FvKlLsau3J6UDnH8emtYR%2F05-12-2024-10-41-25.png?alt=media&#x26;token=808ad3fc-e18b-4bb1-9d1c-e15ae2a201cf" alt="" width="563"><figcaption></figcaption></figure>

#### **Joining the Meeting**

At the scheduled date/time, participants can click the provided Zoom link to join the meeting directly in Zoom.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FldKsI33jryW0xMiBGUyI%2Fhrsthsrt.png?alt=media&#x26;token=3eba31d0-12df-43ee-9c29-27c872663f01" alt="" width="563"><figcaption></figcaption></figure>

***

### Deauthorize Connected MangoApps from Zoom

This app is designed to give users the flexibility to remove it at any time, based on their requirements.&#x20;

Users can achieve this through two methods:

1. Deauthorizing the app via the Zoom web account.
2. Revoking the app's authorization from their MangoApps user profile.

***

#### Steps to Deauthorize the Zoom access in MangoApps

Zoom Admins can use the following link to navigate to the **Zoom Martketplace**:  <https://marketplace.zoom.us/user/installed>&#x20;

From this link, click on **Added Apps** in the laft hand navigation menu.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F7WjOfttfy3nUupB39owu%2Fwaef.png?alt=media&#x26;token=7732cf44-1828-4734-b3aa-a8bd8ada6438" alt="" width="563"><figcaption></figcaption></figure>

Under the Apps in Production tab, locate the **MangoApps** app. Click the **Remove** button.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F1sY7Y9BxMpYRHZ8LmbWR%2Fthsdtfh.png?alt=media&#x26;token=1b4b7e03-aaa8-4504-ac05-61f66724072f" alt="" width="563"><figcaption></figcaption></figure>

Optionally, the admin can **Select a  Reason for Removal**.&#x20;

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2F2kqayw6xrPhJYD9ZHGs5%2Fegresdrfs.png?alt=media&#x26;token=3cab28b3-05da-496d-be58-8d657086ff5a" alt="" width="563"><figcaption></figcaption></figure>

Click on the **Remove** button to finalize the deauthorization of the MangoApps connected user account with Zoom.

***

#### Deauthorize connected MangoApps from Zoom

If you no longer wish to connect Zoom to your MangoApps account, follow these steps to revoke access.

**Access Your Profile Settings**

Log in to MangoApps and navigate to the top-left corner of the screen. Click on your profile picture or name. Form the dropdown menu, select the **Change My Settings** option.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FBUYG61tvbx8Q49hQqfC0%2Fergsfd.png?alt=media&#x26;token=9c70ca9b-5d00-4a58-94df-265bdac2c1b2" alt=""><figcaption></figcaption></figure>

**Locate Authorized Apps**

In the settings menu, look for the **Authorized Apps** link on the navigation panel. Click on it to view the apps connected to your MangoApps account.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FzGBrwyhl2mnTd4weUkWQ%2Frehsretdh.png?alt=media&#x26;token=a1c3bcdf-2f3b-4c16-b66e-aeb5306c4fda" alt="" width="563"><figcaption></figcaption></figure>

**Revoke Zoom Access**

In the list of connected apps, locate **Zoom**. Click on the **Revoke** button next to Zoom to start the deauthorization process.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FMGJJuRzZdSPEWXqHxRcY%2Faergse.png?alt=media&#x26;token=7332f8e9-766c-4795-bbc7-4ba1b889133a" alt="" width="563"><figcaption></figcaption></figure>

A confirmation dialogue box will appear. Click on the **Revoke** button in the confirmation prompt.

<figure><img src="https://1627138357-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LjKbJ2ssjhlUZRcGOXW%2Fuploads%2FWK6c7sHkYnuqlGHqjdwG%2Faergseww.png?alt=media&#x26;token=89ab1504-f9bd-4bfc-97ee-40430d3b071a" alt="" width="563"><figcaption></figcaption></figure>

**Reload and Verify**

The page will reload automatically. Zoom will no longer appear under the list of authorized apps, confirming that the access has been successfully revoked.

***

#### Notes on Deauthorization&#x20;

* Deauthorizing Zoom will **disconnect** it from your MangoApps account. A<mark style="color:red;">**ny Zoom-related features within MangoApps will no longer function unless reconnected.**</mark>
* You can always reauthorize Zoom later if needed by following the connection process outlined above.

For further assistance, contact your system administrator or MangoApps support team.
