Freshdesk - add support for notes (#17598)

* fix issues

* Refactor Freshdesk: Create separate add-note-to-ticket action

- Created dedicated add-note-to-ticket action for better separation of concerns
- Removed note functionality from update-ticket action to maintain single responsibility
- Added addNoteToTicket method to freshdesk.app.mjs
- Bumped update-ticket version to 0.0.3

This provides a cleaner API where each action has a clear, single purpose.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

* Update pnpm-lock.yaml

* Update update-ticket.mjs

* whitespace

* fix: Address PR review comments

- Add JSDoc documentation to addNoteToTicket method
- Add error handling for missing tickets in getTicketName (returns null for 404)
- Add validation for user_id parameter to ensure valid number
- Add email validation for notify_emails array
- Update ticket name handling to use fallback when null

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

* pnpm

* bump version

* bump version

---------

Co-authored-by: Job Nijenhuis <[email protected]>
Co-authored-by: Claude <[email protected]>
Co-authored-by: Job <[email protected]>
Co-authored-by: Andrew Chuang <[email protected]>

Author: 4 people

components/brave_search_api/brave_search_api.app.mjs

@@ -8,4 +8,4 @@ export default {
       console.log(Object.keys(this.$auth));
     },
   },
-};
+};

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

@@ -0,0 +1,104 @@
+import freshdesk from "../../freshdesk.app.mjs";
+import { ConfigurationError } from "@pipedream/platform";
+
+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.1",
+  type: "action",
+  props: {
+    freshdesk,
+    ticketId: {
+      propDefinition: [
+        freshdesk,
+        "ticketId",
+      ],
+    },
+    body: {
+      type: "string",
+      label: "Note Body",
+      description: "Content of the note in HTML format",
+    },
+    private: {
+      type: "boolean",
+      label: "Private Note",
+      description: "Set to true if the note is private (internal)",
+      default: false,
+    },
+    incoming: {
+      type: "boolean",
+      label: "Incoming",
+      description: "Set to true if the note should be marked as incoming (false for outgoing)",
+      default: false,
+      optional: true,
+    },
+    user_id: {
+      propDefinition: [
+        freshdesk,
+        "agentId",
+      ],
+      label: "User ID",
+      description: "ID of the user creating the note (defaults to the API user)",
+      optional: true,
+    },
+    notify_emails: {
+      type: "string[]",
+      label: "Notify Emails",
+      description: "Array of email addresses to notify about this note",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      freshdesk,
+      ticketId,
+      body,
+      private: isPrivate,
+      incoming,
+      user_id,
+      notify_emails,
+    } = this;
+
+    if (!body || !body.trim()) {
+      throw new ConfigurationError("Note body cannot be empty");
+    }
+
+    const ticketName = await freshdesk.getTicketName(ticketId) || "Unknown Ticket";
+
+    const data = {
+      body,
+      private: isPrivate,
+    };
+
+    if (incoming !== undefined) {
+      data.incoming = incoming;
+    }
+
+    if (user_id) {
+      const userId = Number(user_id);
+      if (isNaN(userId)) {
+        throw new ConfigurationError("User ID must be a valid number");
+      }
+      data.user_id = userId;
+    }
+
+    if (notify_emails && notify_emails.length > 0) {
+      const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+      const invalidEmails = notify_emails.filter((email) => !emailRegex.test(email));
+      if (invalidEmails.length > 0) {
+        throw new ConfigurationError(`Invalid email addresses: ${invalidEmails.join(", ")}`);
+      }
+      data.notify_emails = notify_emails;
+    }
+
+    const response = await freshdesk.addNoteToTicket({
+      $,
+      ticketId: Number(ticketId),
+      data,
+    });
+
+    $.export("$summary", `Note added to ticket "${ticketName}" (ID: ${ticketId})`);
+    return response;
+  },
+};

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.1",
+  version: "0.0.2",
   props: {
     freshdesk,
     ticketId: {

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.2",
+  version: "0.0.3",
   type: "action",
   props: {
     freshdesk,

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.2",
+  version: "0.0.3",
   type: "action",
   props: {
     freshdesk,

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.2",
+  version: "0.0.3",
   type: "action",
   props: {
     freshdesk,

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.5",
+  version: "0.0.6",
   type: "action",
   props: {
     freshdesk,

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.5",
+  version: "0.0.6",
   type: "action",
   props: {
     freshdesk,

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

@@ -4,7 +4,7 @@ export default {
   key: "freshdesk-create-ticket",
   name: "Create a Ticket",
   description: "Create a ticket. [See the documentation](https://developers.freshdesk.com/api/#create_ticket)",
-  version: "0.0.6",
+  version: "0.0.7",
   type: "action",
   props: {
     freshdesk,

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

@@ -4,7 +4,7 @@ export default {
   key: "freshdesk-get-ticket",
   name: "Get Ticket Details",
   description: "Get details of a Ticket. [See the documentation](https://developers.freshdesk.com/api/#view_a_ticket)",
-  version: "0.1.3",
+  version: "0.1.4",
   type: "action",
   props: {
     freshdesk,