@pipedream/zoom 0.3.3 → 0.3.4

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

@@ -0,0 +1,31 @@
+// legacy_hash_id: a_67iQp1
+import { axios } from "@pipedream/platform";
+
+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",
+  type: "action",
+  props: {
+    zoom: {
+      type: "app",
+      app: "zoom",
+    },
+    webinarID: {
+      type: "string",
+      label: "Webinar ID",
+      description: "The Zoom Webinar ID of the webinar you'd like to update.",
+    },
+  },
+  async run({ $ }) {
+    const config = {
+      url: `https://api.zoom.us/v2/past_webinars/${this.webinarID}/qa`,
+      headers: {
+        Authorization: `Bearer ${this.zoom.$auth.oauth_access_token}`,
+      },
+    };
+
+    return await axios($, config);
+  },
+};

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

@@ -0,0 +1,46 @@
+// legacy_hash_id: a_k6iKgR
+import { axios } from "@pipedream/platform";
+
+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",
+  type: "action",
+  props: {
+    zoom: {
+      type: "app",
+      app: "zoom",
+    },
+    message: {
+      type: "string",
+      description: "The message to be sent.",
+    },
+    to_contact: {
+      type: "string",
+      description: "The email address of the contact to whom you would like to send the message.",
+      optional: true,
+    },
+    to_channel: {
+      type: "string",
+      description: "The Channel Id of the channel where you would like to send a message.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+  // See the API docs here: https://marketplace.zoom.us/docs/api-reference/zoom-api/chat-messages/sendachatmessage
+    const config = {
+      method: "post",
+      url: "https://api.zoom.us/v2/chat/users/me/messages",
+      data: {
+        message: this.message,
+        to_contact: this.to_contact,
+        to_channel: this.to_channel,
+      },
+      headers: {
+        Authorization: `Bearer ${this.zoom.$auth.oauth_access_token}`,
+      },
+    };
+    return await axios($, config);
+  },
+};

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

@@ -0,0 +1,101 @@
+// legacy_hash_id: a_52iXNQ
+import { axios } from "@pipedream/platform";
+
+export default {
+  key: "zoom-update-meeting",
+  name: "Update Meeting",
+  description: "Updates an existing Zoom meeting",
+  version: "0.1.1",
+  type: "action",
+  props: {
+    zoom: {
+      type: "app",
+      app: "zoom",
+    },
+    meetingId: {
+      type: "string",
+      label: "Meeting ID",
+      description: "The Zoom Meeting ID of the meeting you'd like to update.",
+    },
+    topic: {
+      type: "string",
+      description: "Meeting topic",
+      optional: true,
+    },
+    type: {
+      type: "integer",
+      description: "Meeting type:\n1 - Instant meeting.\n2 - Scheduled meeting.\n3 - Recurring meeting with no fixed time.\n8 - Recurring meeting with fixed time.",
+      optional: true,
+    },
+    start_time: {
+      type: "string",
+      description: "Meeting start time. We support two formats for start_time - local time and GMT.\nTo set time as GMT the format should be yyyy-MM-ddTHH:mm:ssZ.\nTo set time using a specific timezone, use yyyy-MM-ddTHH:mm:ss format and specify the timezone ID in the timezone field OR leave it blank and the timezone set on your Zoom account will be used. You can also set the time as UTC as the timezone field.\nThe start_time should only be used for scheduled and / or recurring webinars with fixed time.",
+      optional: true,
+    },
+    duration: {
+      type: "integer",
+      description: "Meeting duration (minutes). Used for scheduled meetings only.",
+      optional: true,
+    },
+    timezone: {
+      type: "string",
+      description: "Time zone to format start_time. For example, “America/Los_Angeles”. For scheduled meetings only. Please reference our time [zone list](https://marketplace.zoom.us/docs/api-reference/other-references/abbreviation-lists#timezones) for supported time zones and their formats.",
+      optional: true,
+    },
+    password: {
+      type: "string",
+      description: "Password to join the meeting. Password may only contain the following characters: [a-z A-Z 0-9 @ - _ *]. Max of 10 characters.",
+      optional: true,
+    },
+    agenda: {
+      type: "string",
+      description: "Meeting description.",
+      optional: true,
+    },
+    tracking_fields: {
+      type: "any",
+      description: "Tracking fields.",
+      optional: true,
+    },
+    recurrence: {
+      type: "object",
+      description: "Recurrence object",
+      optional: true,
+    },
+    settings: {
+      type: "string",
+      description: "Meeting settings.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+  // API docs: https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/meetingupdate
+    const config = {
+      method: "PATCH",
+      url: `https://api.zoom.us/v2/meetings/${this.meetingId}`,
+      data: {
+        topic: this.topic,
+        type: this.type,
+        start_time: this.start_time,
+        duration: this.duration,
+        timezone: this.timezone,
+        password: this.password,
+        agenda: this.agenda,
+        tracking_fields: typeof this.tracking_fields == "undefined"
+          ? this.tracking_fields
+          : JSON.parse(this.tracking_fields),
+        recurrence: typeof this.recurrence == "undefined"
+          ? this.recurrence
+          : JSON.parse(this.recurrence),
+        settings: typeof this.settings == "undefined"
+          ? this.settings
+          : JSON.parse(this.settings),
+      },
+      headers: {
+        "Authorization": `Bearer ${this.zoom.$auth.oauth_access_token}`,
+        "Content-Type": "application/json",
+      },
+    };
+    return await axios($, config);
+  },
+};

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

@@ -0,0 +1,101 @@
+// legacy_hash_id: a_Q3irlY
+import { axios } from "@pipedream/platform";
+
+export default {
+  key: "zoom-update-webinar",
+  name: "Update Webinar",
+  description: "Update a webinar's topic, start time, or other settings",
+  version: "0.1.1",
+  type: "action",
+  props: {
+    zoom: {
+      type: "app",
+      app: "zoom",
+    },
+    webinarID: {
+      type: "string",
+      label: "Webinar ID",
+      description: "The Zoom Webinar ID of the webinar you'd like to update.",
+    },
+    topic: {
+      type: "string",
+      description: "Webinar topic",
+      optional: true,
+    },
+    type: {
+      type: "integer",
+      description: "Webinar type:\n1 - Instant webinar.\n2 - Scheduled webinar.\n3 - Recurring webinar with no fixed time.\n8 - Recurring webinar with fixed time.",
+      optional: true,
+    },
+    start_time: {
+      type: "string",
+      description: "Webinar start time. We support two formats for start_time - local time and GMT.\nTo set time as GMT the format should be yyyy-MM-ddTHH:mm:ssZ.\nTo set time using a specific timezone, use yyyy-MM-ddTHH:mm:ss format and specify the timezone ID in the timezone field OR leave it blank and the timezone set on your Zoom account will be used. You can also set the time as UTC as the timezone field.\nThe start_time should only be used for scheduled and / or recurring webinars with fixed time.",
+      optional: true,
+    },
+    duration: {
+      type: "integer",
+      description: "Webinar duration (minutes). Used for scheduled webinars only.",
+      optional: true,
+    },
+    timezone: {
+      type: "string",
+      description: "Time zone to format start_time. For example, “America/Los_Angeles”. For scheduled webinars only. Please reference our time [zone list](https://marketplace.zoom.us/docs/api-reference/other-references/abbreviation-lists#timezones) for supported time zones and their formats.",
+      optional: true,
+    },
+    password: {
+      type: "string",
+      description: "Password to join the webinar. Password may only contain the following characters: [a-z A-Z 0-9 @ - _ *]. Max of 10 characters.",
+      optional: true,
+    },
+    agenda: {
+      type: "string",
+      description: "Webinar description.",
+      optional: true,
+    },
+    tracking_fields: {
+      type: "any",
+      description: "Tracking fields.",
+      optional: true,
+    },
+    recurrence: {
+      type: "object",
+      description: "Recurrence object",
+      optional: true,
+    },
+    settings: {
+      type: "string",
+      description: "Webinar settings.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+  // API docs: https://marketplace.zoom.us/docs/api-reference/zoom-api/meetings/meetingupdate
+    const config = {
+      method: "PATCH",
+      url: `https://api.zoom.us/v2/webinars/${this.webinarID}`,
+      data: {
+        topic: this.topic,
+        type: this.type,
+        start_time: this.start_time,
+        duration: this.duration,
+        timezone: this.timezone,
+        password: this.password,
+        agenda: this.agenda,
+        tracking_fields: typeof this.tracking_fields == "undefined"
+          ? this.tracking_fields
+          : JSON.parse(this.tracking_fields),
+        recurrence: typeof this.recurrence == "undefined"
+          ? this.recurrence
+          : JSON.parse(this.recurrence),
+        settings: typeof this.settings == "undefined"
+          ? this.settings
+          : JSON.parse(this.settings),
+      },
+      headers: {
+        "Authorization": `Bearer ${this.zoom.$auth.oauth_access_token}`,
+        "Content-Type": "application/json",
+      },
+    };
+    return await axios($, config);
+  },
+};

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

@@ -0,0 +1,24 @@
+// legacy_hash_id: a_Q3iw4N
+import { axios } from "@pipedream/platform";
+
+export default {
+  key: "zoom-view-user",
+  name: "View User",
+  description: "View your user information",
+  version: "0.1.1",
+  type: "action",
+  props: {
+    zoom: {
+      type: "app",
+      app: "zoom",
+    },
+  },
+  async run({ $ }) {
+    return await axios($, {
+      url: "https://api.zoom.us/v2/users/me",
+      headers: {
+        Authorization: `Bearer ${this.zoom.$auth.oauth_access_token}`,
+      },
+    });
+  },
+};

package/package.json

@@ -1,17 +1,20 @@
 {
-    "name": "@pipedream/zoom",
-    "version": "0.3.3",
-    "description": "Pipedream Zoom Components",
-    "main": "zoom.app.js",
-    "keywords": [
-        "pipedream",
-        "zoom"
-    ],
-    "homepage": "https://pipedream.com/apps/zoom",
-    "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
-    "license": "MIT",
-    "gitHead": "12ad36100ee95629c1b22923c79923bfff156ca7",
-    "publishConfig": {
-        "access": "public"
-    }
-}
+  "name": "@pipedream/zoom",
+  "version": "0.3.4",
+  "description": "Pipedream Zoom Components",
+  "main": "zoom.app.js",
+  "keywords": [
+    "pipedream",
+    "zoom"
+  ],
+  "homepage": "https://pipedream.com/apps/zoom",
+  "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
+  "license": "MIT",
+  "gitHead": "e12480b94cc03bed4808ebc6b13e7fdb3a1ba535",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^1.1.0"
+  }
+}

package/sources/common/common.mjs

@@ -0,0 +1,25 @@
+import zoom from "../../zoom.app.mjs";
+
+export default {
+  props: {
+    zoom,
+  },
+  methods: {
+    sortByDate(objects, field) {
+      return objects.sort((a, b) => (Date.parse(a[field]) > Date.parse(b[field]))
+        ? 1
+        : -1);
+    },
+    monthAgo() {
+      const now = new Date();
+      const monthAgo = new Date(now.getTime());
+      monthAgo.setMonth(monthAgo.getMonth() - 1);
+      return monthAgo.toISOString().slice(0, 10);
+    },
+  },
+  async run(event) {
+    const { payload } = event;
+    const { object } = payload;
+    this.emitEvent(payload, object);
+  },
+};

package/sources/common/constants.mjs

@@ -0,0 +1,110 @@
+const CUSTOM_EVENT_TYPES = [
+  "meeting.alert",
+  "meeting.created.by_me",
+  "meeting.created.for_me",
+  "meeting.updated",
+  "meeting.deleted.by_me",
+  "meeting.deleted.for_me",
+  "meeting.started",
+  "meeting.ended",
+  "meeting.registration_created",
+  "meeting.registration_approved",
+  "meeting.registration_cancelled",
+  "meeting.registration_denied",
+  "meeting.sharing_started.host",
+  "meeting.sharing_started.participant",
+  "meeting.sharing_ended.host",
+  "meeting.sharing_ended.participant",
+  "meeting.participant_jbh_joined",
+  "meeting.participant_jbh_waiting",
+  "meeting.participant_joined",
+  "meeting.participant_left",
+  "meeting.participant_joined_waiting_room",
+  "meeting.participant_admitted",
+  "meeting.participant_put_in_waiting_room",
+  "meeting.participant_left_waiting_room",
+  "recording.started",
+  "recording.paused",
+  "recording.resumed",
+  "recording.stopped",
+  "recording.completed",
+  "recording.trashed.by_me",
+  "recording.trashed.for_me",
+  "recording.deleted.by_me",
+  "recording.deleted.for_me",
+  "recording.recovered.by_me",
+  "recording.recovered.for_me",
+  "recording.transcript_completed",
+  "recording.registration_created",
+  "recording.registration_approved",
+  "recording.registration_denied",
+  "user.updated",
+  "user.settings_updated",
+  "user.signed_in",
+  "user.signed_out",
+  "webinar.created.by_me",
+  "webinar.created.for_me",
+  "webinar.updated",
+  "webinar.started",
+  "webinar.ended",
+  "webinar.alert",
+  "webinar.sharing_started.host",
+  "webinar.sharing_started.participant",
+  "webinar.sharing_ended",
+  "webinar.registration_created",
+  "webinar.registration_approved",
+  "webinar.registration_denied",
+  "webinar.registration_cancelled",
+  "webinar.participant_joined",
+  "webinar.participant_left",
+];
+
+const PHONE_EVENT_TYPES = [
+  "phone.call_log_deleted",
+  "phone.call_log_permanently_deleted",
+  "phone.callee_answered",
+  "phone.callee_call_log_completed",
+  "phone.callee_ended",
+  "phone.callee_hold",
+  "phone.callee_meeting_inviting",
+  "phone.callee_missed",
+  "phone.callee_mute",
+  "phone.callee_rejected",
+  "phone.callee_ringing",
+  "phone.callee_unhold",
+  "phone.callee_unmute",
+  "phone.caller_call_log_completed",
+  "phone.caller_connected",
+  "phone.caller_ended",
+  "phone.caller_hold",
+  "phone.caller_meeting_inviting",
+  "phone.caller_mute",
+  "phone.caller_ringing",
+  "phone.caller_unhold",
+  "phone.caller_unmute",
+  "phone.device_registration",
+  "phone.emergency_alert",
+  "phone.generic_device_provision",
+  "phone.peering_number_cnam_updated",
+  "phone.peering_number_emergency_address_updated",
+  "phone.recording_completed",
+  "phone.recording_deleted",
+  "phone.recording_paused",
+  "phone.recording_permanently_deleted",
+  "phone.recording_resumed",
+  "phone.recording_started",
+  "phone.recording_stopped",
+  "phone.recording_transcript_completed",
+  "phone.sms_received",
+  "phone.sms_sent",
+  "phone.voicemail_deleted",
+  "phone.voicemail_permanently_deleted",
+  "phone.voicemail_received",
+  "phone.voicemail_transcript_completed",
+  "phone.warm_transfer_accepted",
+];
+
+export default {
+  CUSTOM_EVENT_TYPES,
+  PHONE_EVENT_TYPES,
+};

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

@@ -0,0 +1,33 @@
+import zoom from "../../zoom.app.mjs";
+import constants from "../common/constants.mjs";
+
+export default {
+  key: "zoom-custom-event",
+  name: "Custom Events (Instant)",
+  description: "Listen for any events tied to your Zoom user or resources you own",
+  version: "0.0.6",
+  type: "source",
+  props: {
+    zoom,
+    eventNameOptions: {
+      label: "Zoom Events",
+      type: "string[]",
+      options: constants.CUSTOM_EVENT_TYPES,
+    },
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      async eventNames() {
+        return this.eventNameOptions;
+      },
+    },
+  },
+  async run(event) {
+    console.log(event);
+    this.$emit(event, {
+      id: event.payload?.object?.id,
+      summary: event.event,
+      ts: Date.now(),
+    });
+  },
+};

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

@@ -0,0 +1,55 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  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.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on meeting ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "meeting.created.by_me",
+        "meeting.created.for_me",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { meetings } = await this.zoom.listMeetings({
+        page_size: 25,
+      });
+      if (!meetings || meetings.length === 0) {
+        return;
+      }
+      const objects = this.sortByDate(meetings, "created_at");
+      for (const object of objects) {
+        this.emitEvent({
+          object,
+        }, object);
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "meeting.created",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: `Meeting ${object.topic} created`,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,38 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  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.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on meeting ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "meeting.deleted.by_me",
+        "meeting.deleted.for_me",
+      ],
+    },
+  },
+  methods: {
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "meeting.deleted",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: `Meeting ${object.topic} deleted`,
+        ts: +new Date(object.start_time),
+      };
+    },
+  },
+};

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

@@ -0,0 +1,65 @@
+import common from "../common/common.mjs";
+
+export default {
+  ...common,
+  key: "zoom-meeting-ended",
+  name: "Meeting Ended (Instant)",
+  description: "Emit new event each time a meeting ends where you're the host",
+  version: "0.0.4",
+  type: "source",
+  dedupe: "unique", // Dedupe based on meeting ID
+  props: {
+    ...common.props,
+    zoomApphook: {
+      type: "$.interface.apphook",
+      appProp: "zoom",
+      eventNames: [
+        "meeting.ended",
+      ],
+    },
+  },
+  hooks: {
+    async deploy() {
+      const { meetings } = await this.zoom.listMeetings({
+        page_size: 25,
+        type: "previous_meetings",
+      });
+      if (!meetings || meetings.length === 0) {
+        return;
+      }
+      const detailedMeetings = [];
+      for (const meeting of meetings) {
+        try {
+          const details = await this.zoom.getPastMeetingDetails(meeting.id);
+          detailedMeetings.push(details);
+        } catch {
+          // catch error thrown by getPastMeetingDetails if meeting has not ended
+          continue;
+        }
+      }
+      const objects = this.sortByDate(detailedMeetings, "end_time");
+      for (const object of objects) {
+        this.emitEvent({
+          object,
+        }, object);
+      }
+    },
+  },
+  methods: {
+    ...common.methods,
+    emitEvent(payload, object) {
+      const meta = this.generateMeta(object);
+      this.$emit({
+        event: "meeting.ended",
+        payload,
+      }, meta);
+    },
+    generateMeta(object) {
+      return {
+        id: object.uuid,
+        summary: `Meeting ${object.topic} ended`,
+        ts: +new Date(object.end_time),
+      };
+    },
+  },
+};