Add comprehensive props to all Zoho Desk ticket and contact actions

sicarius97 · claude · sicarius97 · commit 1a1245b0c240 · 2025-10-24T15:17:36.000-05:00
Extended all Zoho Desk actions with complete prop definitions to enable AI assistants and users to leverage the full capabilities of the Zoho Desk API. App file (zoho_desk.app.mjs) enhancements: - Added accountId propDefinition with dynamic options from accounts - Added productId propDefinition for product association - Added category propDefinition for ticket categorization - Added subCategory propDefinition for sub-categorization - Added classification propDefinition with dynamic options - Added dueDate propDefinition for deadline management Ticket actions enhancements: create-ticket (v0.0.6 → v0.0.7): - Added status, priority, assigneeId, channel props (using propDefinitions) - Added classification, category, subCategory props - Added dueDate for deadline tracking - Added email and phone contact fields - Added productId for product association - Updated to conditionally include optional fields update-ticket (v0.0.6 → v0.0.7): - Made subject optional (was required) - Added status, priority, assigneeId props - Added departmentId, contactId, channel props - Added classification, category, subCategory props - Added dueDate and productId props - Updated to conditionally include optional fields - Now supports updating any ticket field Contact actions enhancements: create-contact (v0.0.6 → v0.0.7): - Added accountId prop using dynamic propDefinition - Added title prop for job title - Added description prop for contact notes - Updated to conditionally include optional fields update-contact (v0.0.6 → v0.0.7): - Made lastName optional (was required) - Added accountId, title, description props - Updated to conditionally include optional fields - Now supports updating any contact field Email reply action fix: send-email-reply (v0.0.6 → v0.0.7): - Replaced hardcoded static status options with dynamic ticketStatus propDefinition - Renamed ticketStatus prop to status for consistency - Updated to conditionally include optional fields - Now uses organization-specific status values All changes verified against Zoho Desk API documentation and tested for syntax errors. Related to #18798 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
diff --git a/components/zoho_desk/actions/create-contact/create-contact.mjs b/components/zoho_desk/actions/create-contact/create-contact.mjs
@@ -5,7 +5,7 @@ export default {
   name: "Create Contact",
   description: "Creates a contact in your help desk portal. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Contacts#Contacts_CreateContact)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -48,6 +48,27 @@ export default {
       description: "Mobile number of the contact",
       optional: true,
     },
+    accountId: {
+      propDefinition: [
+        zohoDesk,
+        "accountId",
+        ({ orgId }) => ({
+          orgId,
+        }),
+      ],
+    },
+    title: {
+      type: "string",
+      label: "Title",
+      description: "Job title of the contact",
+      optional: true,
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "Description about the contact",
+      optional: true,
+    },
   },
   async run({ $ }) {
     const {
@@ -57,19 +78,29 @@ export default {
       email,
       phone,
       mobile,
+      accountId,
+      title,
+      description,
     } = this;
 
+    const data = {
+      lastName,
+    };
+
+    // Add optional fields
+    if (firstName) data.firstName = firstName;
+    if (email) data.email = email;
+    if (phone) data.phone = phone;
+    if (mobile) data.mobile = mobile;
+    if (accountId) data.accountId = accountId;
+    if (title) data.title = title;
+    if (description) data.description = description;
+
     const response = await this.zohoDesk.createContact({
       headers: {
         orgId,
       },
-      data: {
-        lastName,
-        firstName,
-        email,
-        phone,
-        mobile,
-      },
+      data,
     });
 
     $.export("$summary", `Successfully created a new contact with ID ${response.id}`);
diff --git a/components/zoho_desk/actions/create-ticket/create-ticket.mjs b/components/zoho_desk/actions/create-ticket/create-ticket.mjs
@@ -5,7 +5,7 @@ export default {
   name: "Create Ticket",
   description: "Creates a ticket in your helpdesk. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Tickets#Tickets_Createaticket)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -48,6 +48,75 @@ export default {
       description: "Description in the ticket",
       optional: true,
     },
+    status: {
+      propDefinition: [
+        zohoDesk,
+        "ticketStatus",
+      ],
+    },
+    priority: {
+      propDefinition: [
+        zohoDesk,
+        "ticketPriority",
+      ],
+    },
+    assigneeId: {
+      propDefinition: [
+        zohoDesk,
+        "assigneeId",
+        ({ orgId }) => ({
+          orgId,
+        }),
+      ],
+    },
+    channel: {
+      propDefinition: [
+        zohoDesk,
+        "channel",
+      ],
+    },
+    classification: {
+      propDefinition: [
+        zohoDesk,
+        "classification",
+      ],
+    },
+    category: {
+      propDefinition: [
+        zohoDesk,
+        "category",
+      ],
+    },
+    subCategory: {
+      propDefinition: [
+        zohoDesk,
+        "subCategory",
+      ],
+    },
+    dueDate: {
+      propDefinition: [
+        zohoDesk,
+        "dueDate",
+      ],
+    },
+    email: {
+      type: "string",
+      label: "Email",
+      description: "Email address for the ticket",
+      optional: true,
+    },
+    phone: {
+      type: "string",
+      label: "Phone",
+      description: "Phone number for the ticket",
+      optional: true,
+    },
+    productId: {
+      propDefinition: [
+        zohoDesk,
+        "productId",
+      ],
+    },
   },
   async run({ $ }) {
     const {
@@ -56,18 +125,44 @@ export default {
       contactId,
       subject,
       description,
+      status,
+      priority,
+      assigneeId,
+      channel,
+      classification,
+      category,
+      subCategory,
+      dueDate,
+      email,
+      phone,
+      productId,
     } = this;
 
+    const data = {
+      departmentId,
+      contactId,
+      subject,
+    };
+
+    // Add optional fields
+    if (description) data.description = description;
+    if (status) data.status = status;
+    if (priority) data.priority = priority;
+    if (assigneeId) data.assigneeId = assigneeId;
+    if (channel) data.channel = channel;
+    if (classification) data.classification = classification;
+    if (category) data.category = category;
+    if (subCategory) data.subCategory = subCategory;
+    if (dueDate) data.dueDate = dueDate;
+    if (email) data.email = email;
+    if (phone) data.phone = phone;
+    if (productId) data.productId = productId;
+
     const response = await this.zohoDesk.createTicket({
       headers: {
         orgId,
       },
-      data: {
-        departmentId,
-        contactId,
-        subject,
-        description,
-      },
+      data,
     });
 
     $.export("$summary", `Successfully created a new ticket with ID ${response.id}`);
diff --git a/components/zoho_desk/actions/send-email-reply/send-email-reply.mjs b/components/zoho_desk/actions/send-email-reply/send-email-reply.mjs
@@ -5,7 +5,7 @@ export default {
   name: "Send E-Mail Reply",
   description: "Sends an email reply. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Threads#Threads_SendEmailReply)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -73,16 +73,12 @@ export default {
       description: "Content of the thread",
       optional: true,
     },
-    ticketStatus: {
-      type: "string",
-      label: "Ticket Status",
-      description: "Type of ticket resolution status. The values supported are `OPEN` and `ON HOLD` and `CLOSED`.",
-      optional: true,
-      options: [
-        "OPEN",
-        "ON HOLD",
-        "CLOSED",
+    status: {
+      propDefinition: [
+        zohoDesk,
+        "ticketStatus",
       ],
+      description: "Type of ticket resolution status to set after sending the email reply.",
     },
   },
   async run({ $ }) {
@@ -93,23 +89,27 @@ export default {
       to,
       content,
       contentType,
-      ticketStatus,
+      status,
     } = this;
 
+    const data = {
+      fromEmailAddress,
+      to,
+      channel: "EMAIL",
+      isForward: "true",
+    };
+
+    // Add optional fields
+    if (content) data.content = content;
+    if (contentType) data.contentType = contentType;
+    if (status) data.ticketStatus = status;
+
     const response = await this.zohoDesk.sendReply({
       ticketId,
       headers: {
         orgId,
       },
-      data: {
-        fromEmailAddress,
-        to,
-        content,
-        contentType,
-        ticketStatus,
-        channel: "EMAIL",
-        isForward: "true",
-      },
+      data,
     });
 
     $.export("$summary", `Successfully sent email reply with ID ${response.id}`);
diff --git a/components/zoho_desk/actions/update-contact/update-contact.mjs b/components/zoho_desk/actions/update-contact/update-contact.mjs
@@ -5,7 +5,7 @@ export default {
   name: "Update Contact",
   description: "Updates details of an existing contact. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Contacts#Contacts_Updateacontact)",
   type: "action",
-  version: "0.0.6",
+  version: "0.0.7",
   annotations: {
     destructiveHint: true,
     openWorldHint: true,
@@ -32,6 +32,7 @@ export default {
       type: "string",
       label: "Last Name",
       description: "Last name of the contact",
+      optional: true,
     },
     firstName: {
       type: "string",
@@ -57,6 +58,27 @@ export default {
       description: "Mobile number of the contact",
       optional: true,
     },
+    accountId: {
+      propDefinition: [
+        zohoDesk,
+        "accountId",
+        ({ orgId }) => ({
+          orgId,
+        }),
+      ],
+    },
+    title: {
+      type: "string",
+      label: "Title",
+      description: "Job title of the contact",
+      optional: true,
+    },
+    description: {
+      type: "string",
+      label: "Description",
+      description: "Description about the contact",
+      optional: true,
+    },
   },
   async run({ $ }) {
     const {
@@ -67,20 +89,29 @@ export default {
       email,
       phone,
       mobile,
+      accountId,
+      title,
+      description,
     } = this;
 
+    const data = {};
+
+    // Add optional fields
+    if (lastName) data.lastName = lastName;
+    if (firstName) data.firstName = firstName;
+    if (email) data.email = email;
+    if (phone) data.phone = phone;
+    if (mobile) data.mobile = mobile;
+    if (accountId) data.accountId = accountId;
+    if (title) data.title = title;
+    if (description) data.description = description;
+
     const response = await this.zohoDesk.updateContact({
       contactId,
       headers: {
         orgId,
       },
-      data: {
-        lastName,
-        firstName,
-        email,
-        phone,
-        mobile,
-      },
+      data,
     });
 
     $.export("$summary", `Successfully updated contact with ID ${response.id}`);
diff --git a/components/zoho_desk/actions/update-ticket/update-ticket.mjs b/components/zoho_desk/actions/update-ticket/update-ticket.mjs
diff --git a/components/zoho_desk/zoho_desk.app.mjs b/components/zoho_desk/zoho_desk.app.mjs
