@pipedream/zoom 0.4.0 → 0.5.0

package/README.md

@@ -1,79 +1,36 @@
-# Zoom API Integrations
+# Overview
+The Zoom API lets you tap into a rich set of functionalities to enhance the video conferencing experience within your own app or workflow. With the Zoom API on Pipedream, you can automatically create meetings, manage users, send meeting notifications, and more, orchestrating these actions within a broader automation. This allows for seamless integration with other services, enabling both data collection and action triggers based on Zoom events.
 
-### Integrate Zoom and thousands of applications with Pipedream. Free for developers.
+**Pipedream [workflows](/workflows/) allow you to run any Node.js code that connects to the Zoom API**. Just [create a new workflow](https://pipedream.com/new), then add prebuilt Zoom [actions](/components#actions) (create a meeting, send a chat message, etc.) or [write your own code](/code/). These workflows can be triggered by HTTP requests, timers, email, or on any app-based event (new tweets, a Github PR, Zoom events, etc). 
 
----
+# Getting Started
 
-Pipedream is a serverless integration and compute platform. We provide a free, hosted platform that makes it easy to connect apps and develop, execute and maintain event-driven workflows.
+1. First, sign up for Pipedream at [https://pipedream.com](https://pipedream.com).
+2. Visit [https://pipedream.com/accounts](https://pipedream.com/accounts).
+3. Click the button labeled **Click Here to Connect an App**.
+4. Search for "Zoom" and select either **Zoom** or **Zoom Admin** ([see the differences below](#zoom-vs-zoom-admin-app)):
 
-**Key Features**:
+This will open up a new window prompting you to authorize Pipedream's access to your Zoom account. Once you authorize access, you should see your Zoom account listed among your apps.
 
-- [Zoom API Event Sources](#github-api-event-sources) - Open source [components](https://github.com/PipedreamHQ/pipedream/tree/master/components) that emit events from Zoom
-- [Workflows](#workflows) - A sequence of linear steps - just Node.js code - triggered by a Zoom event
-- Serverless - No server or cloud resources to manage
-- [Free](#pricing) - No fees for individual developers (see [limits](https://docs.pipedream.com/limits/))
+1. [Create a new workflow](https://pipedream.com/new), [add a new step](/workflows/steps/), search for "Zoom" or "Zoom Admin". Once you've selected either app, you can choose to either "Run Node.js code" or select one of the prebuilt actions for performing common API operations.
+2. At this stage, you'll be asked to link the Zoom account you connected above, authorizing the request to the Zoom API with your credentials.
 
-<a href="https://pipedream.com/sources/new?app=zoom"><img src="https://i.ibb.co/m0bBsSL/deploy-clean.png" height="35"></a>
+## Zoom vs Zoom Admin app
 
-## Zoom API Event Sources
+Zoom users can be classified into two groups: non-admins and admins. Admins have account-level permissions that users do not, and Zoom has corresponding admin-level scopes that aren't relevant for normal users. Therefore, Pipedream exposes two apps — **Zoom** and **Zoom Admin** — to serve the two groups.
 
-- [Custom Events](https://pipedream.com/sources/new?app=zoom) - Build your own event source using one or multiple events ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/custom-event.js))
-- [Meeting Created](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a meeting is created where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/meeting-created.js))
-- [Meeting Deleted](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a meeting is deleted where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/meeting-deleted.js))
-- [Meeting Ended](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a meeting ends where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/meeting-ended.js))
-- [Meeting Started](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a meeting starts where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/meeting-started.js))
-- [Meeting Updated](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a meeting is updated where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/meeting-updated.js))
-- [Meeting Recording Completed](https://pipedream.com/sources?action=create&key=zoom-recording-completed&utm_source=github.com&utm_medium=referral&utm_campaign=zoom) - Emits an event each time a new recording completes for a meeting or webinar where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/recording-completed.js))
-- [Webinar Created](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a webinar is created where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/webinar-created.js))
-- [Webinar Deleted](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a webinar is deleted where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/webinar-deleted.js))
-- [Webinar Ended](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a webinar ends where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/webinar-ended.js))
-- [Webinar Started](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a webinar starts where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/webinar-started.js))
-- [Webinar Updated](https://pipedream.com/sources/new?app=zoom) - Emits an event each time a webinar is updated where you're the host ([code](https://github.com/PipedreamHQ/pipedream/blob/master/components/zoom/webinar-updated.js))
+In the Zoom Marketplace, these apps are named [Pipedream](https://marketplace.zoom.us/apps/jGaV-kRrT3igAYnn-J5v2g), and [Pipedream for Zoom Admins](https://marketplace.zoom.us/apps/tZvUsiucR96SqtvfBsemXg), respectively.
 
-Event sources can also be deployed via the [Pipedream CLI](https://docs.pipedream.com/cli/reference/). Once installed, you can deploy an event source by running:
+Non-admins have [permissions](https://marketplace.zoom.us/docs/guides/authorization/permissions#user-managed-scopes) to manage standard Zoom resources in their account: meetings, webinars, recordings, and more. **If you're a non-admin, you'll want to use the Zoom app**.
 
-```bash
-pd deploy   # prompts you to select a component and pass required options
-```
+Zoom admins have [permissions](https://marketplace.zoom.us/docs/guides/authorization/permissions#account-level-scopes) to manage account-level resources, like users and reports. They can also manage webinars and meetings across their organization. **If you're an admin and need to manage these resources via API, you'll want to use the Zoom Admin app**.
 
-## Workflows
+The [Zoom API docs on permissions](https://marketplace.zoom.us/docs/guides/authorization/permissions) provide detailed information on these permissions and their associated OAuth scopes.
 
-Workflows are a sequence of linear [steps](https://docs.pipedream.com/workflows/steps) - just Node.js code - triggered by an event (via event source, HTTP endpoint, or timer). Workflows make it easy to transform data and integrate with 300+ APIs from various apps and services.
+# Example Use Cases
 
-- Trigger your workflow on any [Zoom event](https://pipedream.com/sources/new?app=github), a different event (e.g. [HTTP requests](https://docs.pipedream.com/workflows/steps/triggers/#http) or a [schedule](https://docs.pipedream.com/workflows/steps/triggers/#cron-scheduler)).
-- Add steps to run [Node.js code](https://docs.pipedream.com/workflows/steps/code/) (using virtually any npm package) and [pre-built actions](https://docs.pipedream.com/workflows/steps/actions/).
-- Steps are executed in the order they appear in your workflow.
-- Data is shared between steps via [step exports](https://docs.pipedream.com/workflows/steps/#step-exports).
+- **Automated Meeting Scheduling and Notifications**: With Pipedream, you can create a workflow that listens for upcoming calendar events in Google Calendar. Once it detects a new event labeled "Zoom Meeting," it can trigger the Zoom API to create a meeting and then automatically send custom email notifications with the meeting details to all the attendees using SendGrid.
 
-Workflow code is [public by default](https://docs.pipedream.com/public-workflows/) so the community can discover and [copy them](https://docs.pipedream.com/workflows/copy/). Your workflow execution and event data is private.
+- **Zoom Webinar Attendee Management**: Build a workflow where new sign-ups from an event management platform like Eventbrite trigger the addition of these attendees to a Zoom webinar. Post-webinar, send a follow-up email via Mailgun with a link to the webinar recording, which you can upload to a cloud storage platform like Dropbox.
 
-You can copy [this example workflow](https://pipedream.com/@tod/use-http-requests-to-trigger-a-workflow-p_6lCy5y/readme) to get started, or review some [community-developed workflows](https://pipedream.com/explore) to see what others are building.
-
-**Example Zoom Workflows**
-
-- [Save Zoom recordings to Amazon S3, then delete Zoom recording](https://pipedream.com/@dylburger/save-zoom-recordings-to-amazon-s3-p_PACKJG/readme)
-
-For a deeper introduction to Pipedream and event sources, see the [root `README` in this repo](/README.md), the [component API](/COMPONENT-API.md), or the [docs](https://docs.pipedream.com/apps/zoom/).
-
-## Other Popular API Integrations
-
-- [Airtable](https://github.com/PipedreamHQ/pipedream/tree/master/components/airtable) ([deploy](https://pipedream.com/sources/new?app=airtable))
-- [AWS](https://github.com/PipedreamHQ/pipedream/tree/master/components/aws) ([deploy](https://pipedream.com/sources/new?app=aws))
-- [Dropbox](https://github.com/PipedreamHQ/pipedream/tree/master/components/dropbox) ([deploy](https://pipedream.com/sources/new?app=dropbox))
-- [Github](https://github.com/PipedreamHQ/pipedream/tree/master/components/github) ([deploy](https://pipedream.com/sources/new?app=github))
-- [Google Calendar](https://github.com/PipedreamHQ/pipedream/tree/master/components/google-calendar) ([deploy](https://pipedream.com/sources/new?app=google-calendar))
-- [Google Drive](https://github.com/PipedreamHQ/pipedream/tree/master/components/google-drive) ([deploy](https://pipedream.com/sources/new?app=google-drive))
-- [RSS](https://github.com/PipedreamHQ/pipedream/tree/master/components/rss) ([deploy](https://pipedream.com/sources/new?app=rss))
-- [Twitter](https://github.com/PipedreamHQ/pipedream/tree/master/components/twitter) ([deploy](https://pipedream.com/sources/new?app=twitter))
-
-## Pricing
-
-Pipedream is currently free, subject to the [limits noted below](https://docs.pipedream.com/limits/). Paid tiers for higher volumes are coming soon.
-
-If you exceed any of these limits, please [reach out](https://docs.pipedream.com/support/).
-
-## Found a Bug? Have a Feature to suggest?
-
-Before adding an issue, please search the [existing issues](https://github.com/PipedreamHQ/pipedream/issues) or [reach out to our team](https://docs.pipedream.com/support/) to see if a similar request already exists.
-
-If an issue exists, please [add a reaction](https://help.github.com/en/github/collaborating-with-issues-and-pull-requests/about-conversations-on-github) or comment on your specific use case.
+- **Meeting Analytics and Reporting**: Combine Zoom's meeting ended webhook with Pipedream's capabilities to create a workflow that captures meeting details upon conclusion. With this data, you can send a summary email to the host, update a Google Sheet with attendance information, and even push the data to a BI tool like Tableau for more in-depth analysis.

package/actions/add-meeting-registrant/add-meeting-registrant.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-add-meeting-registrant",
   name: "Add Meeting Registrant",
   description: "Registers a participant for a meeting. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/meetingRegistrantCreate)",
-  version: "0.3.0",
+  version: "0.3.1",
   type: "action",
   props: {
     app,

package/actions/add-webinar-registrant/add-webinar-registrant.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-add-webinar-registrant",
   name: "Add Webinar Registrant",
   description: "Registers a participant for a webinar. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/webinars/webinarregistrantcreate).",
-  version: "0.3.0",
+  version: "0.3.1",
   type: "action",
   props: {
     app,

package/actions/create-meeting/create-meeting.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-create-meeting",
   name: "Create Meeting",
   description: "Creates a meeting for a user. A maximum of 100 meetings can be created for a user in a day.",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/actions/create-user/create-user.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-create-user",
   name: "Create User",
   description: "Creates a new user in your account.",
-  version: "0.2.1",
+  version: "0.2.2",
   type: "action",
   props: {
     zoom: {

package/actions/delete-user/delete-user.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-delete-user",
   name: "Delete User",
   description: "Disassociates (unlinks) a user from the associated account or permanently deletes a user.",
-  version: "0.2.1",
+  version: "0.2.2",
   type: "action",
   props: {
     zoom: {

package/actions/get-meeting-details/get-meeting-details.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-get-meeting-details",
   name: "Get Meeting Details",
   description: "Retrieves the details of a meeting.",
-  version: "0.3.1",
+  version: "0.3.2",
   type: "action",
   props: {
     zoom: {

package/actions/get-webinar-details/get-webinar-details.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-get-webinar-details",
   name: "Get Webinar Details",
   description: "Gets details of a scheduled webinar. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/webinar).",
-  version: "0.3.0",
+  version: "0.3.1",
   type: "action",
   props: {
     app,

package/actions/list-channels/list-channels.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-list-channels",
   name: "List Channels",
   description: "List a user's chat channels.",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/actions/list-past-meeting-participants/list-past-meeting-participants.mjs

@@ -4,7 +4,7 @@ export default {
   key: "zoom-list-past-meeting-participants",
   name: "List Past Meeting Participants",
   description: "Retrieve information on participants from a past meeting. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/pastMeetingParticipants).",
-  version: "0.2.0",
+  version: "0.2.1",
   type: "action",
   props: {
     app,

package/actions/list-past-webinar-qa/list-past-webinar-qa.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-list-past-webinar-qa",
   name: "List Past Webinar Q&A",
   description: "The  feature for Webinars allows attendees to ask questions during the Webinar and for the panelists, co-hosts and host to answer their questions. Use this API to list Q&A of a specific Webinar.",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/actions/list-user-call-logs/list-user-call-logs.mjs

@@ -0,0 +1,31 @@
+import zoom from "../../zoom.app.mjs";
+
+export default {
+  name: "List User's Call Logs",
+  description: "Gets a user's Zoom phone call logs. [See the documentation](https://developers.zoom.us/docs/zoom-phone/apis/#operation/phoneUserCallLogs)",
+  key: "zoom-list-user-call-logs",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    zoom,
+    userId: {
+      propDefinition: [
+        zoom,
+        "userId",
+      ],
+    },
+  },
+  async run ({ $ }) {
+    const data = await this.zoom.getResourcesStream({
+      resourceFn: this.zoom.listCallLogs,
+      resourceFnArgs: {
+        userId: this.userId,
+      },
+      resourceName: "call_logs",
+    });
+
+    $.export("$summary", `Successfully fetched ${data.length} call log(s)`);
+
+    return data;
+  },
+};

package/actions/list-webinar-participants-report/list-webinar-participants-report.mjs

@@ -1,11 +1,11 @@
-import app from "../../zoom.app.mjs";
 import utils from "../../common/utils.mjs";
+import app from "../../zoom.app.mjs";
 
 export default {
   key: "zoom-list-webinar-participants-report",
   name: "List Webinar Participants Report",
   description: "Retrieves detailed report on each webinar attendee. You can get webinar participant reports for the last 6 months. [See the docs here](https://marketplace.zoom.us/docs/api-reference/zoom-api/methods/#operation/reportWebinarParticipants).",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   props: {
     app,

package/actions/send-chat-message/send-chat-message.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-send-chat-message",
   name: "Send Chat Message",
   description: "Send chat messages on Zoom to either an individual user who is in your contact list or to a  of which you are a member.",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/actions/update-meeting/update-meeting.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-update-meeting",
   name: "Update Meeting",
   description: "Updates an existing Zoom meeting",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/actions/update-webinar/update-webinar.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-update-webinar",
   name: "Update Webinar",
   description: "Update a webinar's topic, start time, or other settings",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/actions/view-user/view-user.mjs

@@ -5,7 +5,7 @@ export default {
   key: "zoom-view-user",
   name: "View User",
   description: "View your user information",
-  version: "0.1.1",
+  version: "0.1.2",
   type: "action",
   props: {
     zoom: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/zoom",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Pipedream Zoom Components",
   "main": "zoom.app.mjs",
   "keywords": [

package/sources/custom-event/custom-event.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-custom-event",
   name: "Custom Events (Instant)",
   description: "Emit new events tied to your Zoom user or resources you own",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-created/meeting-created.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-created",
   name: "Meeting Created (Instant)",
   description: "Emit new event each time a meeting is created where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-deleted/meeting-deleted.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-deleted",
   name: "Meeting Deleted (Instant)",
   description: "Emit new event each time a meeting is deleted where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-ended/meeting-ended.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-ended",
   name: "Meeting Ended (Instant)",
   description: "Emit new event each time a meeting ends where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-started/meeting-started.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-started",
   name: "Meeting Started (Instant)",
   description: "Emit new event each time a meeting starts where you're the host",
-  version: "0.1.0",
+  version: "0.1.2",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/meeting-updated/meeting-updated.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-meeting-updated",
   name: "Meeting Updated (Instant)",
   description: "Emit new event each time a meeting is updated where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/phone-event/phone-event.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-phone-event",
   name: "Zoom Phone Events (Instant)",
   description: "Emit new Zoom Phone event tied to your Zoom user or resources you own",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   props: {
     ...common.props,

package/sources/recording-completed/recording-completed.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-recording-completed",
   name: "Recording Completed (Instant)",
   description: "Emit new event each time a new recording completes for a meeting or webinar where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-created/webinar-created.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-created",
   name: "Webinar Created (Instant)",
   description: "Emit new event each time a webinar is created where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-deleted/webinar-deleted.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-deleted",
   name: "Webinar Deleted (Instant)",
   description: "Emit new event each time a webinar is deleted where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-ended/webinar-ended.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-ended",
   name: "Webinar Ended (Instant)",
   description: "Emit new event each time a webinar ends where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-started/webinar-started.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-started",
   name: "Webinar Started (Instant)",
   description: "Emit new event each time a webinar starts where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/sources/webinar-updated/webinar-updated.mjs

@@ -6,7 +6,7 @@ export default {
   key: "zoom-webinar-updated",
   name: "Webinar Updated (Instant)",
   description: "Emit new event each time a webinar is updated where you're the host",
-  version: "0.1.0",
+  version: "0.1.1",
   type: "source",
   dedupe: "unique",
   props: {

package/zoom.app.mjs

@@ -54,6 +54,31 @@ export default {
       },
       optional: true,
     },
+    userId: {
+      type: "string",
+      label: "User Id",
+      description: "The user ID or email address of the user.",
+      async options({ prevContext }) {
+        const { nextPageToken } = prevContext;
+        const response = await this.listUsers({
+          params: {
+            next_page_token: nextPageToken,
+          },
+        });
+
+        return {
+          options: response.users.map(({
+            name, email, id: value,
+          }) => ({
+            label: `${name} - ${email}`,
+            value,
+          })),
+          context: {
+            nextPageToken: response.next_page_token,
+          },
+        };
+      },
+    },
     includeAudioRecordings: {
       type: "boolean",
       label: "Include Audio Recordings",
@@ -251,6 +276,20 @@ export default {
         ...args,
       });
     },
+    listUsers(opts = {}) {
+      return this._makeRequest({
+        path: "/phone/users",
+        ...opts,
+      });
+    },
+    listCallLogs({
+      userId, ...args
+    }) {
+      return this._makeRequest({
+        path: `/phone/users/${userId}/call_logs`,
+        ...args,
+      });
+    },
     async *getResourcesStream({
       resourceFn,
       resourceFnArgs,