Add comprehensive tag management for Freshdesk tickets

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

@@ -0,0 +1,44 @@
+import freshdesk from "../../freshdesk.app.mjs";
+
+export default {
+  key: "freshdesk-add-ticket-tags",
+  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",
+  props: {
+    freshdesk,
+    ticketId: {
+      propDefinition: [
+        freshdesk,
+        "ticketId",
+      ],
+    },
+    ticketTags: {
+      propDefinition: [
+        freshdesk,
+        "ticketTags",
+      ],
+      description: "Array of tags to add to the ticket. These will be added to any existing tags.",
+    },
+  },
+  async run({ $ }) {
+    const {
+      ticketId,
+      ticketTags,
+    } = this;
+
+    if (!ticketTags || ticketTags.length === 0) {
+      throw new Error("At least one tag must be provided");
+    }
+
+    const response = await this.freshdesk.addTicketTags({
+      ticketId,
+      tags: ticketTags,
+      $,
+    });
+
+    $.export("$summary", `Successfully added ${ticketTags.length} tag(s) to ticket ${ticketId}`);
+    return response;
+  },
+};

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

@@ -0,0 +1,44 @@
+import freshdesk from "../../freshdesk.app.mjs";
+
+export default {
+  key: "freshdesk-remove-ticket-tags",
+  name: "Remove Ticket Tags",
+  description: "Remove specific tags from a ticket. [See the documentation](https://developers.freshdesk.com/api/#update_ticket)",
+  type: "action",
+  version: "0.0.1",
+  props: {
+    freshdesk,
+    ticketId: {
+      propDefinition: [
+        freshdesk,
+        "ticketId",
+      ],
+    },
+    ticketTags: {
+      propDefinition: [
+        freshdesk,
+        "ticketTags",
+      ],
+      description: "Array of tags to remove from the ticket. Only these specific tags will be removed.",
+    },
+  },
+  async run({ $ }) {
+    const {
+      ticketId,
+      ticketTags,
+    } = this;
+
+    if (!ticketTags || ticketTags.length === 0) {
+      throw new Error("At least one tag must be provided");
+    }
+
+    const response = await this.freshdesk.removeTicketTags({
+      ticketId,
+      tags: ticketTags,
+      $,
+    });
+
+    $.export("$summary", `Successfully removed ${ticketTags.length} tag(s) from ticket ${ticketId}`);
+    return response;
+  },
+};

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

@@ -0,0 +1,44 @@
+import freshdesk from "../../freshdesk.app.mjs";
+
+export default {
+  key: "freshdesk-set-ticket-tags",
+  name: "Set Ticket Tags",
+  description: "Set tags on a ticket (replaces all existing tags). [See the documentation](https://developers.freshdesk.com/api/#update_ticket)",
+  type: "action",
+  version: "0.0.1",
+  props: {
+    freshdesk,
+    ticketId: {
+      propDefinition: [
+        freshdesk,
+        "ticketId",
+      ],
+    },
+    ticketTags: {
+      propDefinition: [
+        freshdesk,
+        "ticketTags",
+      ],
+      description: "Array of tags to set on the ticket. This will replace all existing tags.",
+    },
+  },
+  async run({ $ }) {
+    const {
+      ticketId,
+      ticketTags,
+    } = this;
+
+    if (!ticketTags || ticketTags.length === 0) {
+      throw new Error("At least one tag must be provided");
+    }
+
+    const response = await this.freshdesk.setTicketTags({
+      ticketId,
+      tags: ticketTags,
+      $,
+    });
+
+    $.export("$summary", `Successfully set ${ticketTags.length} tag(s) on ticket ${ticketId}`);
+    return response;
+  },
+};

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

@@ -90,6 +90,13 @@ export default {
       description: "Custom fields as key-value pairs (make sure types match your config)",
       optional: true,
     },
+    tags: {
+      propDefinition: [
+        freshdesk,
+        "ticketTags",
+      ],
+      description: "Array of tags to set on the ticket. This will replace all existing tags.",
+    },
   },
   async run({ $ }) {
     const {

components/freshdesk/freshdesk.app.mjs

@@ -116,6 +116,12 @@ export default {
           }));
       },
     },
+    ticketTags: {
+      type: "string[]",
+      label: "Tags",
+      description: "Array of tags to apply to the ticket. Each tag must be 32 characters or less.",
+      optional: true,
+    },
   },
   methods: {
     setLastDateChecked(db, value) {
@@ -266,5 +272,73 @@ export default {
       }
       return input;
     },
+    /**
+     * Set tags on a ticket (replaces all existing tags)
+     * @param {object} args - Arguments object
+     * @param {string|number} args.ticketId - The ticket ID
+     * @param {string[]} args.tags - Array of tags to set
+     * @returns {Promise<object>} API response
+     */
+    async setTicketTags({
+      ticketId, tags, ...args
+    }) {
+      return this._makeRequest({
+        url: `/tickets/${ticketId}`,
+        method: "PUT",
+        data: {
+          tags,
+        },
+        ...args,
+      });
+    },
+    /**
+     * Add tags to a ticket (appends to existing tags)
+     * @param {object} args - Arguments object
+     * @param {string|number} args.ticketId - The ticket ID
+     * @param {string[]} args.tags - Array of tags to add
+     * @returns {Promise<object>} API response
+     */
+    async addTicketTags({
+      ticketId, tags, ...args
+    }) {
+      // Get current ticket to merge tags
+      const ticket = await this.getTicket({
+        ticketId,
+        ...args,
+      });
+      const currentTags = ticket.tags || [];
+      const newTags = [...new Set([...currentTags, ...tags])]; // Remove duplicates
+
+      return this.setTicketTags({
+        ticketId,
+        tags: newTags,
+        ...args,
+      });
+    },
+    /**
+     * Remove specific tags from a ticket
+     * @param {object} args - Arguments object
+     * @param {string|number} args.ticketId - The ticket ID
+     * @param {string[]} args.tags - Array of tags to remove
+     * @returns {Promise<object>} API response
+     */
+    async removeTicketTags({
+      ticketId, tags, ...args
+    }) {
+      // Get current ticket to filter tags
+      const ticket = await this.getTicket({
+        ticketId,
+        ...args,
+      });
+      const currentTags = ticket.tags || [];
+      const tagsToRemove = new Set(tags);
+      const remainingTags = currentTags.filter(tag => !tagsToRemove.has(tag));
+
+      return this.setTicketTags({
+        ticketId,
+        tags: remainingTags,
+        ...args,
+      });
+    },
   },
 };