feat(zoho-desk): expand help desk operations

Author: waleedlatif1

apps/docs/content/docs/integrations/zoho-desk-service-account.mdx

@@ -78,8 +78,16 @@ Sim requests the Zoho Desk scopes used by its tools, knowledge connector, organi
 
 ```
 Desk.tickets.READ
+Desk.tickets.CREATE
 Desk.tickets.UPDATE
 Desk.contacts.READ
+Desk.contacts.CREATE
+Desk.contacts.UPDATE
+Desk.accounts.READ
+Desk.accounts.CREATE
+Desk.accounts.UPDATE
+Desk.search.READ
+Desk.departments.READ
 Desk.agents.READ
 Desk.basic.READ
 Desk.articles.READ

apps/docs/content/docs/integrations/zoho_desk.mdx

@@ -1667,38 +1667,20 @@ export const OAUTH_PROVIDERS: Record<string, OAuthProviderConfig> = {
         serviceAccountProviderId: 'zoho-desk-service-account',
         icon: ZohoDeskIcon,
         baseProviderIcon: ZohoDeskIcon,
-        // Kept to what the tools and the webhook trigger exercise. NOTE: Zoho
-        // lists `Desk.organization.READ , Desk.basic.READ` for GET /organizations
-        // and `Desk.departments.READ , Desk.basic.READ` for GET /departments, and
-        // does not document whether that comma means AND or OR. Both bootstrap
-        // endpoints are assumed covered by Desk.basic.READ alone - verify against
-        // a live Desk org and widen here if either returns SCOPE_MISMATCH.
-        // tickets (incl. threads/comments), contacts (get_contact), basic
-        // (list_organizations), agents (the `assigneeId` picker lists agents),
-        // webhook create/delete (the trigger provisions and tears down its own
-        // subscription), and profile (OAuth getUserInfo).
-        // Desk.search.READ, Desk.webhooks.READ and Desk.webhooks.UPDATE were
-        // requested but unused - no tool searches, and the provider never lists
-        // or edits a subscription.
         scopes: [
-          // READ + UPDATE rather than tickets.ALL: no tool creates or deletes a
-          // ticket, and ALL additionally grants ticket DELETE. Threads, comments
-          // and attachments live under the tickets module and are covered by
-          // these two. NOTE: Zoho publishes no scope line for the attachment
-          // content sub-path - verify attachment download against a live account
-          // before merge and widen here if it returns SCOPE_MISMATCH.
           'Desk.tickets.READ',
+          'Desk.tickets.CREATE',
           'Desk.tickets.UPDATE',
           'Desk.contacts.READ',
-          // READ only: the knowledge base connector syncs Help Center articles
-          // via GET /articles and GET /articles/{id}; nothing authors one.
+          'Desk.contacts.CREATE',
+          'Desk.contacts.UPDATE',
+          'Desk.accounts.READ',
+          'Desk.accounts.CREATE',
+          'Desk.accounts.UPDATE',
+          'Desk.search.READ',
+          'Desk.departments.READ',
           'Desk.articles.READ',
-          // GET /organizations documents `Desk.organization.READ , Desk.basic.READ`.
-          // Sibling endpoints spell the same construction "requires X and Y"
-          // (dependencyMappings, roles), so the comma is AND, not OR.
           'Desk.organization.READ',
-          // READ only: the agent picker for `assigneeId` lists agents, and no
-          // tool creates, edits or deletes one.
           'Desk.agents.READ',
           'Desk.basic.READ',
           'Desk.webhooks.CREATE',

apps/sim/blocks/blocks/zoho-desk.ts

@@ -87,8 +87,16 @@ export const SCOPE_DESCRIPTIONS: Record<string, string> = {
   'bookmarks:write': 'Add, edit, and remove Slack channel bookmarks',
   'bookmarks:read': 'View Slack channel bookmarks',
   // Zoho Desk scopes
+  'Desk.tickets.CREATE': 'Create support tickets',
+  'Desk.contacts.CREATE': 'Create contacts',
+  'Desk.contacts.UPDATE': 'Update contacts',
+  'Desk.accounts.READ': 'View customer accounts',
+  'Desk.accounts.CREATE': 'Create customer accounts',
+  'Desk.accounts.UPDATE': 'Update customer accounts',
+  'Desk.search.READ': 'Search tickets, contacts, and accounts',
+  'Desk.departments.READ': 'View departments',
   'Desk.tickets.READ': 'View tickets, threads, comments, and attachments',
-  'Desk.tickets.UPDATE': 'Update tickets and add comments',
+  'Desk.tickets.UPDATE': 'Update tickets, send replies, and manage comments',
   'Desk.contacts.READ': 'View contacts',
   'Desk.articles.READ': 'View knowledge base articles',
   'Desk.organization.READ': 'View organization details',

apps/sim/lib/oauth/oauth.ts

@@ -6457,14 +6457,34 @@ import {
 import { zerobounceGetCreditsTool, zerobounceVerifyEmailTool } from '@/tools/zerobounce'
 import {
   zohoDeskAddCommentTool,
+  zohoDeskCreateAccountTool,
+  zohoDeskCreateContactTool,
+  zohoDeskCreateTicketTool,
+  zohoDeskDeleteCommentTool,
+  zohoDeskGetAccountTool,
+  zohoDeskGetAgentTool,
   zohoDeskGetAttachmentTool,
+  zohoDeskGetCommentTool,
   zohoDeskGetContactTool,
+  zohoDeskGetDepartmentTool,
   zohoDeskGetThreadTool,
   zohoDeskGetTicketTool,
+  zohoDeskListAccountsTool,
+  zohoDeskListAgentsTool,
   zohoDeskListCommentsTool,
+  zohoDeskListContactsTool,
+  zohoDeskListDepartmentsTool,
   zohoDeskListOrganizationsTool,
   zohoDeskListThreadsTool,
   zohoDeskListTicketsTool,
+  zohoDeskMoveTicketTool,
+  zohoDeskSearchAccountsTool,
+  zohoDeskSearchContactsTool,
+  zohoDeskSearchTicketsTool,
+  zohoDeskSendReplyTool,
+  zohoDeskUpdateAccountTool,
+  zohoDeskUpdateCommentTool,
+  zohoDeskUpdateContactTool,
   zohoDeskUpdateTicketTool,
 } from '@/tools/zoho_desk'
 import {
@@ -12325,16 +12345,36 @@ export const tools: Record<string, ExecutableToolConfig> = {
   zendesk_delete_organization: zendeskDeleteOrganizationTool,
   zendesk_search: zendeskSearchTool,
   zendesk_search_count: zendeskSearchCountTool,
-  zoho_desk_list_tickets: zohoDeskListTicketsTool,
-  zoho_desk_get_ticket: zohoDeskGetTicketTool,
-  zoho_desk_update_ticket: zohoDeskUpdateTicketTool,
-  zoho_desk_list_comments: zohoDeskListCommentsTool,
   zoho_desk_add_comment: zohoDeskAddCommentTool,
-  zoho_desk_list_threads: zohoDeskListThreadsTool,
-  zoho_desk_get_thread: zohoDeskGetThreadTool,
+  zoho_desk_create_account: zohoDeskCreateAccountTool,
+  zoho_desk_create_contact: zohoDeskCreateContactTool,
+  zoho_desk_create_ticket: zohoDeskCreateTicketTool,
+  zoho_desk_delete_comment: zohoDeskDeleteCommentTool,
+  zoho_desk_get_account: zohoDeskGetAccountTool,
+  zoho_desk_get_agent: zohoDeskGetAgentTool,
+  zoho_desk_get_attachment: zohoDeskGetAttachmentTool,
+  zoho_desk_get_comment: zohoDeskGetCommentTool,
   zoho_desk_get_contact: zohoDeskGetContactTool,
+  zoho_desk_get_department: zohoDeskGetDepartmentTool,
+  zoho_desk_get_thread: zohoDeskGetThreadTool,
+  zoho_desk_get_ticket: zohoDeskGetTicketTool,
+  zoho_desk_list_accounts: zohoDeskListAccountsTool,
+  zoho_desk_list_agents: zohoDeskListAgentsTool,
+  zoho_desk_list_comments: zohoDeskListCommentsTool,
+  zoho_desk_list_contacts: zohoDeskListContactsTool,
+  zoho_desk_list_departments: zohoDeskListDepartmentsTool,
   zoho_desk_list_organizations: zohoDeskListOrganizationsTool,
-  zoho_desk_get_attachment: zohoDeskGetAttachmentTool,
+  zoho_desk_list_threads: zohoDeskListThreadsTool,
+  zoho_desk_list_tickets: zohoDeskListTicketsTool,
+  zoho_desk_move_ticket: zohoDeskMoveTicketTool,
+  zoho_desk_search_accounts: zohoDeskSearchAccountsTool,
+  zoho_desk_search_contacts: zohoDeskSearchContactsTool,
+  zoho_desk_search_tickets: zohoDeskSearchTicketsTool,
+  zoho_desk_send_reply: zohoDeskSendReplyTool,
+  zoho_desk_update_account: zohoDeskUpdateAccountTool,
+  zoho_desk_update_comment: zohoDeskUpdateCommentTool,
+  zoho_desk_update_contact: zohoDeskUpdateContactTool,
+  zoho_desk_update_ticket: zohoDeskUpdateTicketTool,
   intercom_create_contact: intercomCreateContactTool,
   intercom_create_contact_v2: intercomCreateContactV2Tool,
   intercom_get_contact: intercomGetContactTool,

apps/sim/lib/oauth/utils.ts

@@ -1,11 +1,11 @@
 import type { ToolConfig } from '@/tools/types'
 import { safeUrlPathSegment } from '@/tools/url-path'
+import { parseZohoDeskJson, readZohoDeskResponse } from '@/tools/zoho_desk/request'
 import type { ZohoDeskAddCommentParams, ZohoDeskResponse } from '@/tools/zoho_desk/types'
 import { ZOHO_DESK_COMMENT_PROPERTIES } from '@/tools/zoho_desk/types'
 import {
   buildZohoDeskHeaders,
   getZohoDeskApiBase,
-  getZohoDeskErrorMessage,
   withDerivedContentText,
 } from '@/tools/zoho_desk/utils'
 
@@ -61,6 +61,12 @@ export const zohoDeskAddCommentTool: ToolConfig<ZohoDeskAddCommentParams, ZohoDe
       visibility: 'user-or-llm',
       description: 'Whether the comment is public',
     },
+    attachmentIds: {
+      type: 'json',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'JSON array of previously uploaded attachment IDs',
+    },
   },
 
   request: {
@@ -69,19 +75,15 @@ export const zohoDeskAddCommentTool: ToolConfig<ZohoDeskAddCommentParams, ZohoDe
     method: 'POST',
     headers: (params) => buildZohoDeskHeaders(params),
     body: (params) => ({
+      attachmentIds: parseZohoDeskJson(params.attachmentIds, 'attachmentIds', 'array'),
       content: params.content,
       contentType: params.contentType || 'plainText',
       isPublic: params.isPublic ?? false,
     }),
   },
 
   transformResponse: async (response) => {
-    const data = await response.json().catch(() => ({}))
-    if (!response.ok) {
-      throw new Error(
-        getZohoDeskErrorMessage(data, `Failed to add comment (HTTP ${response.status})`)
-      )
-    }
+    const data = await readZohoDeskResponse(response)
     return {
       success: true,
       output: { comment: withDerivedContentText(data) },