Skip to content

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.

61d6bf8072991.png

3. Enter the following details and click Create.

61d6bf81c129e.png

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

https://www.integromat.com/oauth/cb/zoom2

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.

61d6bf82e5046.png

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:

  • Name Enter the name of the developer.

  • Email address Enter the email address of the developer.

61d6bf8430b47.png

6. Select the subscriptions for the app and click Continue.

61d6bf85635ef.png

7. Click Add Scopes and select at least one scope for your app and click Continue. For example, meetings, users. etc.,

61d6bf86b38c1.png

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.

61d6bf88155e8.png

9. Go to Ibexa Connect, and open the Zoom module's Create a connection dialog.

61d6bf8950054.gif

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.

61d6bf8ba4920.png

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.

61d6bf8ce3039.gif

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.

Type

Select the recurrence meeting type.

Repeat Interval

Define the interval at which the meeting should recur. For instance, if you would like to schedule a meeting that recurs every two months, you must set the value of this field as `2` and the value of the Type parameter as Monthly. For a Daily meeting, the maximum interval you can set is `90` days. For a Weekly meeting, the maximum interval that you can set is `12` weeks. For a Monthly meeting, there is a maximum of `3` months.

End Type

  • Number of Occurrence – Enter how many times the meeting should recur before it is canceled in the End Times field below.

  • Specific Date – Enter the final date on which the meeting will recur before it is canceled in the End Date Time field below. Please refer to the list of supported date and time formats.

Weekly Days

Select days in a week when the monthly meeting should recur.

Repeat Type

  • Day in a Month – Define which day in a month the meeting should recur in the Monthly Day field below. The value range is from 1 to 31.

  • Weekday in a Month – Define which day(s) of the week the meeting should repeat in the Monthly Week field below. The value for this field can be between 1 and 7.

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:

  • Scheduled - This includes all valid past meetings (unexpired), live meetings, and upcoming scheduled meetings. It is equivalent to the combined list of Previous Meetings and Upcoming Meetings displayed in the user's Meetings page on the Zoom Web Portal.

  • Live - All the meetings currently happening.

  • Upcoming - All upcoming meetings, including live meetings.

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.
Email 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.

  • Pending - Registrant's status is pending.

  • Approved - Registrant's status is approved.

  • Denied - Registrant's status is denied.

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).

  • Pending - Registrant's status is pending.

  • Approved - Registrant's status is approved.

  • Denied - Registrant's status is denied.

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.

61d6bf8f232e8.gif

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.

Type

Select the recurrence webinar type.

Repeat Interval

Define the interval at which the webinar should recur. For instance, if you would like to schedule a webinar that recurs every two months, you must set the value of this field as `2` and the value of the Type parameter as Monthly. For a Daily meeting, the maximum interval you can set is `90` days. For a Weekly meeting, the maximum interval that you can set is `12` weeks. For a Monthly webinar, there is a maximum of `3` months.

End Type

  • Number of Occurrences – Enter how many times the webinar should recur before it is canceled in the End Times field below.

  • Specific Date – Enter the final date on which the webinar will recur before it is canceled in the End Date Time field below. Please refer to the list of supported date and time formats.

Weekly Days

Select the days in a week when the monthly webinar should recur.

Repeat Type

  • Day in a Month – Define which day in a month the webinar should recur in the Monthly Day field below. The value range is from 1 to 31.

  • Weekday in a Month – Define which day(s) of the week the webinar should repeat in the Monthly Week field below. The value for this field can be between 1 and 7.

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.
Email 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.

  • Pending - Registrant's status is pending.

  • Approved - Registrant's status is approved.

  • Denied - Registrant's status is denied.

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).

  • Pending - Registrant's status is pending.

  • Approved - Registrant's status is approved.

  • Denied - Registrant's status is denied.

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.

61d6bf9138330.gif

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.

61d6bf934daaa.gif

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:

  • Assigned: The number has been assigned to either a user, a call queue, an auto-receptionist, or a common area phone in an account.

  • Unassigned: The number is not assigned to anyone.

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.

61d6bf9574c10.gif

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.

61d6bf978c66d.gif

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 (61d6bf9995022.png) 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 https://api.zoom.us

For example: /v2/users/me

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

61d6bf9a617b7.png

The result can be found in the module's Output under Bundle > Body > contacts.

In our example, 2 contacts were returned:

61d6bf9b67db3.png

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.

61d6bf9c78a87.gif

3. Click the Uninstall button for the Ibexa Connect app.

61d6bf9f2a340.png