Zoom¶
The Zoom modules enable you to monitor, create, update, retrieve, or delete meetings and webinars, manage meeting and webinar registrants, or manage cloud recordings, phone calls, and chats in your Zoom account.
To get started with the Zoom app, create an account at zoom.us/signup.
Connecting Zoom to Ibexa Connect¶
You need to obtain a Client ID and Client Secret values from Zoom Marketplace by creating an app and inserting them in the Ibexa Connect module.
1. Go to https://marketplace.zoom.us/ and create an account.
2. Click Develop > Build App > OAuth > Create.
3. Enter the following details and click Create.
App Name | Enter the name of your app. |
Choose App Type | Select Account-level app. |
Would you like to publish this app on Zoom App Marketplace? | Select whether you want to publish the app on the Zoom App marketplace. |
4. Open the app, enter the details as follows, and click Continue.
Redirect URL for OAuth |
|
Add Allow Lists |
https://www.make.com https://www.integromat.com |
Note
Please ensure to whitelist the URL address, https://www.integromat.com
as it may affect the connection.
5. Enter the basic information about the app.
App name |
Enter the name of the app. |
Short Description |
Enter the short description of the app. |
Long Description |
Enter the long description of the app. |
Preview Content |
Add the images to show the app's content. You can upload a maximum of six images. If you are uploading a video, then you can upload a maximum of five images and a video. |
Category |
Select the category of the app. |
Vertical |
Select a vertical if your app has been built with industry vertical-specific compliance such as HIPAA, FedRAMP, or is specific to Higher Education or K-12. |
Company Name |
Enter the name of the company app. This name will appear on the marketplace homepage and on the app’s detail page. |
Developer Contact Information |
Add the developer details:
|
6. Select the subscriptions for the app and click Continue.
7. Click Add Scopes and select at least one scope for your app and click Continue. For example, meetings, users. etc.,
Note: You must add scope for users to establish the connection and must keep the app private.
8. On the left menu, click App Credentials and copy the Client ID and Client Secret to a safe place.
9. Go to Ibexa Connect, and open the Zoom module's Create a connection dialog.
10. In the Connection name field, enter a name for the connection.
11. In the Client ID and Client Secret fields, enter the details copied in step 8 and click Continue.
12. Confirm the access by clicking Authorize.
The connection has been established. You can proceed with setting up the module.
Meeting¶
Watch Meetings¶
Triggers when a specified meeting event occurs.
Webhook name | Enter the name for the webhook, e.g., Participant Joined |
Trigger by specific events | Enable this option to select specific events (below) you want to trigger the module. Disable this option to trigger the module when any of the meeting events occur. |
Events | Select events that will trigger the Watch Meetings module. |
Now, every time the specified events occur, the Watch Meetings module in your Ibexa Connect scenario is triggered.
Create a Meeting¶
Creates a meeting for a user.
Only 100 Create a Meeting API requests are permitted within a 24-hour window for a user.
User ID |
Select the user or enter the ID of the user who creates the meeting. |
||||||||||
Topic |
Enter a topic or name for your meeting. |
||||||||||
Type |
Select the meeting type. |
||||||||||
Use Personal Meeting ID |
Enable this option to use Personal Meeting ID instead of an automatically generated meeting ID. It can only be used for scheduled meetings, instant meetings, and recurring meetings with no fixed time. |
||||||||||
Start Time |
Enter the start date and time for your meeting. You can start your meeting at any time before the scheduled time. Please refer to the list of supported date and time formats. |
||||||||||
Duration in Minutes |
Enter the duration of the meeting (in minutes). This applies to scheduled meetings only. |
||||||||||
Join Before Host |
Select the Yes option to allow participants to join the meeting before the host starts the meeting. Only for scheduled or recurring meetings. |
||||||||||
Recurrence |
Set up the meeting recurrence.
|
||||||||||
Registration Type |
Select the type of attendee registration |
||||||||||
Schedule for User ID or Email |
Enter the email address or Zoom User ID to schedule this meeting for someone else in your account. |
||||||||||
Password |
Define the passcode to join the meeting. By default, the passcode may only contain the following characters: [a-z A-Z 0-9 @ - _ *] and can have a maximum of 10 characters. |
||||||||||
Agenda |
Enter the meeting description. |
Get a Meeting¶
Retrieves meeting details.
User ID | Select the user or enter the ID of the user who created the meeting. |
Meeting ID | Enter (map) or select the meeting you want to retrieve details. |
Occurrence ID | Enter (map) or select the occurrence to retrieve details of the recurring meeting. |
Show Previous Occurrences | Select the Yes option to retrieve meeting details of all previous occurrences of recurring meetings. |
List Meetings¶
Retrieve meetings in your Zoom account.
User ID |
Select the user or enter the ID of the user who created the meeting. |
Category |
Select the type of meeting:
|
Limit |
Set the maximum number of meetings Ibexa Connect will return during one execution cycle. |
Update a Meeting¶
Updates an existing meeting.
User ID | Select the user or enter the ID of the user who created the meeting. |
Meeting ID | Enter (map) or select the meeting you want to update. |
Please find the descriptions of the fields in the Create a Meeting section above.
End a Meeting¶
Updates the status of a meeting.
User ID | Select the user or enter the ID of the user who created the meeting. |
Meeting ID | Enter (map) or select the meeting you want to end. |
Delete a Meeting¶
Deletes a meeting
User ID | Select the user or enter the ID of the user who created the meeting. |
Meeting ID | Enter (map) or select the meeting you want to delete. |
Occurrence ID | Enter (map) the meeting occurrence ID to remove a single occurrence. |
Schedule for Reminder | Select the Yes option to notify the host and alternative host about the meeting cancellation via email. |
Add a Meeting Registrant¶
Registers a participant for a meeting.
User ID | Select the user or enter the ID of the user who created the meeting. |
Meeting ID | Enter (map) or select the meeting you want to register the participant. |
Occurrence IDs | Enter (map) the meeting occurrence ID of the occurrence(s) where you want to register the participant. |
Enter a valid email for the registrant. | |
First Name | Enter the first name of the registrant. |
Last Name | Enter the registrant's last name. |
List Meeting Registrants¶
Retrieves all meeting registrants.
User ID |
Select the user or enter the ID of the user who created the meeting. |
Meeting ID |
Enter (map) or select the meeting whose registrant details you want to retrieve. |
Occurrence IDs |
Enter (map) the meeting occurrence ID of the occurrence to retrieve registrants. |
Status |
Select the registrant status to filter results by.
|
Limit |
Set the maximum number of registrants Ibexa Connect will return during one execution cycle. |
Update Meeting Registrants Status¶
Updates registrant's status for a meeting.
User ID |
Select the user or enter the ID of the user who created the meeting. |
Meeting ID |
Enter (map) or select the meeting whose registrant status you want to update. |
Occurrence IDs |
Enter (map) the meeting occurrence ID of the occurrence to update registrants. |
Status |
Set the status for the meeting registrants (specified below).
|
Registrants |
Specify registrants whose status you want to update. |
Webinar¶
Watch Webinars¶
Triggers when a specified webinar event occurs.
Webhook name | Enter the name for the webhook, e.g., Webinar Created or Updated |
Trigger by specific events | Enable this option to select specific events (below) you want to trigger the module. Disable this option to trigger the module when any of the webinar events occur. |
Events | Select events that will trigger the Watch Webinars module. |
Now, every time the specified events occur, the Watch Webinars module in your Ibexa Connect scenario is triggered.
Create a Webinar¶
Creates a webinar for a user.
Requires a Pro or higher plan with a webinar add-on.
User ID |
Select the user or enter the ID of the user who is creating the webinar. |
||||||||||
Topic |
Enter a topic or name for the webinar. |
||||||||||
Type |
Select the meeting type. |
||||||||||
Start Time |
Enter the start date and time for the webinar. You can start your webinar at any time before the scheduled time. Please refer to the list of supported date and time formats. |
||||||||||
Duration in Minutes |
Enter the duration of the webinar (in minutes). This is for scheduled webinars only. |
||||||||||
Recurrence |
Set up the webinar recurrence.
|
||||||||||
Registration Type |
Select the type of attendee's registration. |
||||||||||
Password |
Define the passcode to join the meeting. By default, the passcode may only contain the following characters: [a-z A-Z 0-9 @ - _ *] and can have a maximum of 10 characters. |
||||||||||
Agenda |
Enter the webinar description. Max. 2000 characters. |
Get a Webinar¶
Retrieves webinar details.
User ID | Select the user or enter the ID of the user who created the webinar. |
Webinar ID | Enter (map) or select the webinar whose details you want to retrieve. |
Occurrence ID | Enter (map) or select the occurrence to retrieve details of the recurring webinar. |
Show Previous Occurrences | Select the Yes option to retrieve the webinar details of all previous occurrences of a recurring webinar. |
List Webinars¶
Retrieve webinars in your Zoom account.
User ID | Select the user or enter the ID of the user who created the webinar. |
Limit | Set the maximum number of webinars Ibexa Connect will return during one execution cycle. |
Update a Webinar¶
Updates an existing webinar.
User ID | Select the user or enter the ID of the user who created the meeting. |
Webinar ID | Enter (map) or select the webinar you want to update. |
Please find the descriptions of the fields in the Create a Webinar section above.
Delete a Webinar¶
Deletes a webinar.
User ID | Select the user or enter the ID of the user who created the webinar. |
Webinar ID | Enter (map) or select the webinar you want to delete. |
Occurrence ID | Enter (map) the webinar occurrence ID to remove a single occurrence. |
Add a Webinar Registrant¶
Registers a participant for a webinar.
User ID | Select the user or enter the ID of the user who created the webinar. |
Webinar ID | Enter (map) or select the webinar you want to register the participant for. |
Occurrence IDs | Enter (map) the meeting occurrence ID of the occurrence(s) you want to register the participant for. |
Enter a valid email address for the registrant. | |
First Name | Enter the first name of the registrant. |
Last Name | Enter the registrant's last name. |
List Webinar Registrants¶
Retrieves all webinar registrants.
User ID |
Select the user or enter the ID of the user who created the webinar. |
Webinar ID |
Enter (map) or select the webinar you want to retrieve registrants for. |
Occurrence IDs |
Enter (map) the webinar occurrence ID of the occurrence to retrieve registrants for. |
Status |
Select the registrant status to filter results by.
|
Limit |
Set the maximum number of registrants Ibexa Connect will return during one execution cycle. |
Update Webinar Registrant Status¶
Updates registrants status for a webinar.
User ID |
Select the user or enter the ID of the user who created the webinar. |
Webinar ID |
Enter (map) or select the webinar you want to update registrants for. |
Occurrence IDs |
Enter (map) the webinar occurrence ID of the occurrence to update registrants for. |
Status |
Set the status for the webinar registrants (specified below).
|
Registrants |
Specify registrants whose status you want to update. |
Add Webinar Panelist¶
Registers panelists for a webinar.
User ID | Select the user or enter the ID of the user who created the webinar. |
Webinar ID | Enter (map) or select the webinar you want to register a panelist for. |
Panelist | Enter the person's name and email to add the panelist. |
List Webinar Panelist¶
Retrieves a list of the panelist of a webinar.
User ID | Select the user or enter the ID of the user who created the webinar. |
Webinar ID | Enter (map) or select the webinar you want to list panelists for. |
Limit | Set the maximum number of panelists Ibexa Connect will return during one execution cycle. |
Remove a Webinar Panelist¶
Removes a panelist from a webinar.
User ID | Select the user or enter the ID of the user who created the webinar. |
Webinar ID | Enter (map) or select the webinar you want to remove the panelist from. |
Panelist ID | Enter (map) the ID of the panelist you want to remove from the webinar. |
Cloud Recording¶
Caution
Requires a Pro or higher plan, and cloud recording must be enabled on the user’s account.
Watch Recordings¶
Triggers when a specified recording event occurs.
Webhook name | Enter the name for the webhook, e.g., Recording Started |
Trigger by specific events | Enable this option to select specific events (below) you want to trigger the module. Disable this option to trigger the module when any of the recording events occur. |
Events | Select events that will trigger the Watch Recordings module. |
Now, every time the specified events occur, the Watch Recordings module in your Ibexa Connect scenario is triggered.
List Cloud Recordings¶
Returns cloud recordings from a webinar or a meeting.
User ID | Select the user or enter the ID of the user who created the recording. |
Start Date | Enter the start date and time from which you want to filter results. Please refer to the list of supported date and time formats. |
End Date | Enter the end date and time to which you want to filter results. Please refer to the list of supported date and time formats. |
List Recordings from Trash | Enable this option to retrieve recordings from the trash. |
Limit | Set the maximum number of recordings Ibexa Connect will return during one execution cycle. |
Download a Cloud Recording¶
Downloads a cloud recording (as an MP4 file).
Download URL | Enter (map) the download URL of the recording. It can be mapped from the List Cloud Recordings module. |
Download Token | Enter the token if needed. |
File Name | Enter the file name. |
Delete a Cloud Recording¶
Deletes a webinar or meeting recording.
User ID | Select the user or enter the ID of the user who created the webinar. |
Meeting ID | Enter (map) or select the meeting you want to delete the recording from. |
Recording ID | Enter (map) the ID of the recording you want to delete. |
Phone Call¶
Caution
Requires a Pro or higher plan with Zoom phone license.
Watch Phone Calls¶
Triggers when a specified phone call event occurs.
Webhook name | Enter the name for the webhook, e.g., Caller Connected |
Event Type | Select the type of event. |
Events | Select events that will trigger the Watch Phone Calls module. |
Now, every time the specified events occur, the Watch Phone Calls module in your Ibexa Connect scenario is triggered.
List Phone Numbers¶
Retrieves all Zoom phone numbers in a Zoom account based on filter settings.
Type |
Filter the result by type:
|
Extension Type |
Select the type of assignee to whom the number is assigned. |
Number Type |
Select the type of phone number. |
Include Pending Numbers |
Select the Yes option to include pending numbers in the response. |
Site ID |
Unique identifier of the site. Use this query parameter if you have enabled multiple sites and would like to filter the response of this API call by a specific phone site. |
Limit |
Set the maximum number of phone numbers Ibexa Connect will return during one execution cycle. |
List Call Logs¶
Retrieves a user’s call logs.
User ID | Select the user or enter the ID of the user who created the phone call. |
Start Date | Enter the start date of the date range. This should only be one month, as the report includes only one month's worth of data. Please refer to the list of supported date and time formats. |
End Date | Enter the end date of the date range. This should only be one month, as the report includes only one month worth's of data. Please refer to the list of supported date and time formats. |
Only show missed calls | Enable this option to retrieve return missed calls only. |
Limit | Set the maximum number of call logs Ibexa Connect will return during one execution cycle. |
Chat¶
Watch Chat Channels¶
Triggers when a specified chat channel event occurs.
Webhook name | Enter the name for the webhook, e.g., Member Joined |
Event Type | Select the type of event. |
Events | Select events that will trigger the Watch Chat Channels module. |
Now, every time the specified events occur, the Watch Chat Channels module in your Ibexa Connect scenario is triggered.
Watch Chat Messages¶
Triggers when a specified chat message is sent, updated, replied, or deleted.
Webhook name | Enter the name for the webhook, e.g., Message Sent |
Event Type | Select the type of event. |
Events | Select events that will trigger the Watch Chat Messages module. |
Now, every time the specified events occur, the Watch Chat Messages module in your Ibexa Connect scenario is triggered.
Send a Chat Message¶
Sends a message to the chat channel or the contact.
User ID
Select the user or enter the ID.
Target
Select whether to send a message to the channel or to the particular contact.
Email Address of the Contact
Enter the email address of the contact you want to send the message to. You can use the Search button () to find the desired contact.
Channel ID
Enter (map) the channel ID or select the channel you want to send the message to.
Message
Enter the content of the message.
Other¶
Make an API Call¶
Allows you to perform a custom API call.
URL |
Enter a path relative to For example: | For the list of available endpoints, refer to the Zoom API Documentation. |
Method
Select the HTTP method you want to use:
-
GET: to retrieve information for an entry.
-
POST: to create a new entry.
-
PUT: to update/replace an existing entry.
-
PATCH: to make a partial entry update.
-
DELETE: to delete an entry.
Headers
Enter the desired request headers. You don't have to add authorization headers; we've already added those for you.
Query String
Enter the request query string.
Body
Enter the body content for your API call.
Example of Use - List Users¶
The following API call returns all users in your Zoom account:
URL:
/v2/contacts
Method:
GET
The result can be found in the module's Output under Bundle > Body > contacts.
In our example, 2 contacts were returned:
Uninstalling the Ibexa Connect App From a Zoom Account¶
1. Log in to your Zoom account, and navigate to the Zoom App Marketplace.
2. Click Manage (top-right corner) > Installed Apps.
3. Click the Uninstall button for the Ibexa Connect app.