Enhance Freshdesk component with new actions and properties (#19127)

* Enhance Freshdesk component with new actions and properties

- Added new actions: `createMessageForThread`, `createReply`, and `createThread` to facilitate message handling in threads and replies.
- Introduced new properties for `fromEmail` and `threadId` in the Freshdesk app.
- Updated existing methods for improved functionality and consistency.
- Incremented package version to 0.7.0 in package.json.

* Update Freshdesk action versions for consistency and improvements

- Incremented version numbers for multiple Freshdesk actions and sources to reflect recent updates.
- Updated versions include:
  - `add-note-to-ticket` to 0.0.4
  - `add-ticket-tags` to 0.0.5
  - `assign-ticket-to-agent`, `assign-ticket-to-group`, `close-ticket`, `set-ticket-priority`, `set-ticket-status` to 0.0.6
  - `create-agent`, `create-solution-article`, `create-company`, `create-contact`, `create-ticket-field`, `download-attachment`, `get-contact`, `get-solution-article`, `list-agents`, `list-category-folders`, `list-folder-articles`, `list-solution-categories`, `list-ticket-conversations`, `list-ticket-fields`, `remove-ticket-tags`, `update-agent`, `update-contact`, `update-solution-article`, `update-ticket-field` to 0.0.3
  - `create-ticket` to 0.0.10
  - `list-all-tickets` to 0.2.7
  - `list-ticket-fields` to 0.0.3
  - `new-contact` and `new-ticket` to 0.0.9
  - `contact-updated`, `ticket-updated` to 0.0.2
- Ensured all updates align with the latest API documentation for improved functionality.

Author: luancazarine

components/freshdesk/actions/add-note-to-ticket/add-note-to-ticket.mjs

@@ -5,7 +5,7 @@ export default {
   key: "freshdesk-add-note-to-ticket",
   name: "Add Note to Ticket",
   description: "Add a note or conversation to an existing ticket. [See the documentation](https://developers.freshdesk.com/api/#add_note_to_a_ticket).",
-  version: "0.0.3",
+  version: "0.0.4",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/freshdesk/actions/add-ticket-tags/add-ticket-tags.mjs

@@ -6,7 +6,7 @@ export default {
   name: "Add Ticket Tags",
   description: "Add tags to a ticket (appends to existing tags). [See the documentation](https://developers.freshdesk.com/api/#update_ticket)",
   type: "action",
-  version: "0.0.4",
+  version: "0.0.5",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

components/freshdesk/actions/assign-ticket-to-agent/assign-ticket-to-agent.mjs

@@ -4,7 +4,7 @@ export default {
   key: "freshdesk-assign-ticket-to-agent",
   name: "Assign Ticket to Agent",
   description: "Assign a Freshdesk ticket to a specific agent. [See the documentation](https://developers.freshdesk.com/api/#update_ticket).",
-  version: "0.0.5",
+  version: "0.0.6",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

components/freshdesk/actions/assign-ticket-to-group/assign-ticket-to-group.mjs

@@ -4,7 +4,7 @@ export default {
   key: "freshdesk-assign-ticket-to-group",
   name: "Assign Ticket to Group",
   description: "Assign a Freshdesk ticket to a specific group [See the documentation](https://developers.freshdesk.com/api/#update_ticket).",
-  version: "0.0.5",
+  version: "0.0.6",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

components/freshdesk/actions/close-ticket/close-ticket.mjs

@@ -4,7 +4,7 @@ export default {
   key: "freshdesk-close-ticket",
   name: "Close Ticket",
   description: "Set a Freshdesk ticket's status to 'Closed'. [See docs](https://developers.freshdesk.com/api/#update_a_ticket)",
-  version: "0.0.5",
+  version: "0.0.6",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,

components/freshdesk/actions/create-agent/create-agent.mjs

@@ -5,7 +5,7 @@ export default {
   key: "freshdesk-create-agent",
   name: "Create Agent",
   description: "Create an agent in Freshdesk. [See the documentation](https://developers.freshdesk.com/api/#create_agent)",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/freshdesk/actions/create-company/create-company.mjs

@@ -4,7 +4,7 @@ export default {
   key: "freshdesk-create-company",
   name: "Create a Company",
   description: "Create a company. [See the documentation](https://developers.freshdesk.com/api/#create_company)",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/freshdesk/actions/create-contact/create-contact.mjs

@@ -5,7 +5,7 @@ export default {
   key: "freshdesk-create-contact",
   name: "Create a Contact",
   description: "Create a contact. [See the documentation](https://developers.freshdesk.com/api/#create_contact)",
-  version: "0.0.8",
+  version: "0.0.9",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/freshdesk/actions/create-message-for-thread/create-message-for-thread.mjs

@@ -0,0 +1,66 @@
+import { parseObject } from "../../common/utils.mjs";
+import freshdesk from "../../freshdesk.app.mjs";
+
+export default {
+  key: "freshdesk-create-message-for-thread",
+  name: "Create Message For Thread",
+  description: "Create message for a thread. [See the documentation](https://developers.freshdesk.com/api/#create_message_for_thread).",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  type: "action",
+  props: {
+    freshdesk,
+    ticketId: {
+      propDefinition: [
+        freshdesk,
+        "ticketId",
+      ],
+      label: "Ticket ID",
+      description: "ID of the ticket to create the message for.",
+    },
+    threadId: {
+      propDefinition: [
+        freshdesk,
+        "threadId",
+        ({ ticketId }) => ({
+          ticketId,
+        }),
+      ],
+      label: "Thread ID",
+      description: "ID of the thread to create the message for.",
+    },
+    body: {
+      type: "string",
+      label: "Body",
+      description: "Content of the note in HTML format.",
+      optional: true,
+    },
+    participants: {
+      type: "string[]",
+      label: "Participants",
+      description: "List of the participants to be added to the message.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.freshdesk.createMessageForThread({
+      $,
+      data: {
+        body: this.body,
+        participants: {
+          email: {
+            to: parseObject(this.participants),
+          },
+        },
+        thread_id: this.threadId,
+      },
+    });
+
+    $.export("$summary", `Message created successfully with ID: ${response.id}`);
+    return response;
+  },
+};

components/freshdesk/actions/create-reply/create-reply.mjs

@@ -0,0 +1,111 @@
+import { getFileStreamAndMetadata } from "@pipedream/platform";
+import FormData from "form-data";
+import { parseObject } from "../../common/utils.mjs";
+import freshdesk from "../../freshdesk.app.mjs";
+
+export default {
+  key: "freshdesk-create-reply",
+  name: "Create a Reply",
+  description: "Create a reply to a ticket. [See the documentation](https://developers.freshdesk.com/api/#reply_ticket).",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  type: "action",
+  props: {
+    freshdesk,
+    ticketId: {
+      propDefinition: [
+        freshdesk,
+        "ticketId",
+      ],
+    },
+    body: {
+      type: "string",
+      label: "Body",
+      description: "Content of the note in HTML format.",
+    },
+    attachments: {
+      type: "string[]",
+      label: "Attachments",
+      description: "The total size of all the ticket's attachments (not just this note) cannot exceed 20MB.",
+      optional: true,
+    },
+    fromEmail: {
+      propDefinition: [
+        freshdesk,
+        "fromEmail",
+      ],
+      optional: true,
+    },
+    userId: {
+      propDefinition: [
+        freshdesk,
+        "agentId",
+      ],
+      label: "User ID",
+      description: "ID of the agent who is adding the note.",
+      optional: true,
+    },
+    ccEmails: {
+      type: "string[]",
+      label: "CC Emails",
+      description: "Email address added in the 'cc' field of the outgoing ticket email.",
+      optional: true,
+    },
+    bccEmails: {
+      type: "string[]",
+      label: "BCC Emails",
+      description: "Email address added in the 'bcc' field of the outgoing ticket email.",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const formData = new FormData();
+    formData.append("body", this.body);
+
+    if (this.fromEmail) {
+      formData.append("from_email", this.fromEmail.label);
+    }
+    if (this.userId) {
+      formData.append("user_id", this.userId);
+    }
+    const parsedCcEmails = parseObject(this.ccEmails);
+    if (parsedCcEmails) {
+      parsedCcEmails.forEach((ccEmail) => {
+        formData.append("cc_emails[]", ccEmail);
+      });
+    }
+    const parsedBccEmails = parseObject(this.bccEmails);
+    if (parsedBccEmails) {
+      parsedBccEmails.forEach((bccEmail) => {
+        formData.append("bcc_emails[]", bccEmail);
+      });
+    }
+
+    const parsedAttachments = parseObject(this.attachments);
+    if (parsedAttachments) {
+      for (const attachment of parsedAttachments) {
+        const {
+          stream, metadata,
+        } = await getFileStreamAndMetadata(attachment);
+        formData.append("attachments[]", stream, {
+          contentType: metadata.contentType,
+          knownLength: metadata.size,
+          filename: metadata.name,
+        });
+      };
+    }
+    const response = await this.freshdesk.createReply({
+      $,
+      ticketId: this.ticketId,
+      data: formData,
+      headers: formData.getHeaders(),
+    });
+
+    $.export("$summary", `Reply created successfully with ID: ${response.id}`);
+    return response;
+  },
+};