*Version: 1.0 | Last Updated: 2025-02-25* ## Overview - **Integration Name:** Zoom - **Purpose:** Integrating Google meet to initiate a meeting using webhook from the MoovingON AI platform - **Audience:** Support team, TAM - **Prerequisites:** - A valid Zoom account - MoovingON AI account access with integration permissions --- ## Table of Contents - [[#Setup Instructions]] - [[#Configuration]] - [[#Testing the Integration]] - [[#Related Links]] --- ## Setup Instructions 1. Step 1: In MoovingON AI, navigate to Settings -> Integrations. **** 2. Step 2: On the right side of the page, select "Add Webhook."  3. Step 3: Enter an integration name for the webhook and click "Submit."  4. Step 4: A webhook basic authentication (Username and Token) will be created after submission. **** - Save the generated Username and Token for use in Zoom --- ## Configuration 1. **Step 1**: Sign in to [zoom App Marketplace](https://marketplace.zoom.us/), to create an App.   2. **Step 2**: In the top right side, navigate to Develop and choose Build App.   3. **Step 3**:  Choose Server-to-Server OAuth App and click on Create.  4. **Step 4**:  App Credentials.  5. **Step 5**: Add Scopes. Required Scopes: 1. meeting:write:meeting:admin. 2. meeting:write:poll:admin 3. meeting:write:registrant:admin Navigate to the + Add Scopes button and select the relevant scopes accordingly. 6. **Step 6**: To generate a meeting link, you should use: 1. ZOOM_ACCOUNT_ID 2. ZOOM_CLIENT_ID 3. ZOOM_CLIENT_SECRET 4. Use this API to generate a token: https://zoom.us/oauth/token 5. Use this API to create a meeting: [https://api.zoom.us/v2/users/me/meetings](https://api.zoom.us/v2/users/me/meetings)  You can find those values in App Credentials. You should run a Python script using a Lambda Function to generate a new token, create a Zoom meeting, and return a meeting link. 7. **Step 7**: Scopes for Zoom meeting to create a meeting **** 8. **Step 8**: Create a Lambda function: **** - Select func name - Choose Python runtime. - Create function **** You can upload a ZIP file from your local machine on the right side. **** After uploading the lambda script, you need to configure the Environment variables: - Navigate to the configuration - Environment variables - Edit, and add your variables & values **** 9. **Step 9**: Now we need to create an API to invoke the lambda from our system. - Navigate to Add Trigger - Choose API Gateway - If you already have an API gateway, you can use it; if not, follow the next step - Create a new API > IAM - Navigate to Routes > Create > Choose the method (POST, GET, PUT, DELETE) > Choose the path > Create - Navigate to Stages > Create > Enter your Stage name and Enable automatic deployment > Create > in the top right, Deploy. - Go again to Routes, click Deploy, and choose the stages you created > Deploy. **** **** **** **** **** After that, you can use the API gateway to invoke the Lambda, On our side, you need to use this API while you are creating the Webhook. (URL = API gateway ) When invoking the lambda, it will create a new token and create a new meeting with its link. After that, it will create an alert in our system that includes a Zoom link --- ## Testing the Integration - **Test Cases:**  Navigate to Audit and open the Webhook Request. Here, you can see the Output on the API Request with the Meeting Link.  Here you can use the meeting link to open a meeting. --- ## Related Links - **External Resources**: [Zoom Documentation](https://developers.zoom.us/docs/)