Zoho Desk#

Customer support from chat -- create tickets, view conversations, manage contacts, departments, and agents.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted OAuth flows and credentials so you don't need to configure Zoho Desk API access yourself.

Setup in 3 Steps#

Step 1: InstallStep 2: Pair AccountStep 3: Connect Zoho Desk_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect Zoho Desk

How It Works#

text

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│ Zoho Desk API    │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install#

bash

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start#

1. List organizations: zoho_desk_list_organizations -- discover your org and portal URLs.
2. List tickets: zoho_desk_list_tickets -- view open support tickets.
3. Create a ticket: zoho_desk_create_ticket -- open a new support request.

Authentication#

Zoho Desk uses managed OAuth via ClawLink. No API keys needed. Connect at claw-link.dev/dashboard?add=zoho-desk.

Connection Management#

List connections: clawlink_list_integrations -- confirm Zoho Desk is connected.

Verify: Call zoho_desk_list_organizations to test access.

Reconnect: If you see auth errors, reconnect at claw-link.dev/dashboard?add=zoho-desk.

Security & Permissions#

Read operations (list tickets, get conversations) run safely. Write operations (create ticket, update tasks) require confirmation.

Tool Reference#

Ticket Operations#

ToolDescriptionModezoho_desk_list_ticketsList tickets with optional filtersReadzoho_desk_get_ticketGet details of a specific ticketReadzoho_desk_create_ticketCreate a new support ticketWritezoho_desk_get_ticket_resolutionGet the resolution for a ticketReadzoho_desk_list_ticket_conversationsList all conversations for a ticketReadzoho_desk_get_ticket_latest_threadGet the most recent thread on a ticketReadzoho_desk_get_ticket_threadGet a specific thread within a ticketRead

Contact Operations#

ToolDescriptionModezoho_desk_list_contactsList contacts with filters and paginationReadzoho_desk_get_contactGet details of a specific contactReadzoho_desk_get_contacts_by_idsFetch multiple contacts by IDsReadzoho_desk_list_contact_accountsList accounts associated with a contactRead

Agent Operations#

ToolDescriptionModezoho_desk_get_agentGet details of a specific agentReadzoho_desk_get_agents_countGet total agent count with optional filtersRead

Department Operations#

ToolDescriptionModezoho_desk_list_departmentsList all departmentsReadzoho_desk_get_departmentGet details of a specific departmentReadzoho_desk_get_departments_countGet total department countReadzoho_desk_get_department_logoDownload a department's logoReadzoho_desk_upload_department_logoUpload/update a department logoWritezoho_desk_list_teams_in_departmentList teams within a departmentRead

Organization Operations#

ToolDescriptionModezoho_desk_list_organizationsList organizations the user belongs toRead

Role Operations#

ToolDescriptionModezoho_desk_list_rolesList all rolesReadzoho_desk_list_roles_by_idsList roles by specific IDsRead

Task Operations#

ToolDescriptionModezoho_desk_update_many_tasksUpdate multiple tasks in a single callWrite

Code Examples#

List open tickets

json

{ "tool": "zoho_desk_list_tickets" }

Create a support ticket

json

{
  "tool": "zoho_desk_create_ticket",
  "args": {
    "subject": "Cannot access account",
    "description": "User unable to log in since Monday",
    "departmentId": "123456789",
    "contactId": "987654321"
  }
}

Get the latest conversation on a ticket

json

{
  "tool": "zoho_desk_get_ticket_latest_thread",
  "args": { "ticketId": "abc123" }
}

Discovery Workflow#

1. Call clawlink_list_integrations to confirm zoho-desk is connected.
2. Call clawlink_list_tools --integration zoho-desk to see the live catalog.
3. Call zoho_desk_list_organizations to get org details.
4. Use department and contact IDs for ticket creation.

Execution Workflow#

text

Read Flow:  User asks for tickets → clawlink resolves connection → Zoho Desk API → results displayed
Write Flow: User wants to create ticket → confirmation prompt → clawlink resolves connection → Zoho Desk API → ticket created

Notes#

• Creating a ticket requires a departmentId. Use zoho_desk_list_departments to discover IDs.
• Ticket creation returns id and webUrl for downstream chaining.
• Use zoho_desk_get_contacts_by_ids to batch-fetch multiple contacts efficiently.

Related Skills#

• Zoho CRM ( zoho) -- Full Zoho CRM suite
• Zoho Bigin ( zoho-bigin) -- Small business CRM
• Zoho Inventory ( zoho-inventory) -- Stock and order management
• Zoho Invoice ( zoho-invoice) -- Invoicing and billing
• Zoho Mail ( zoho-mail) -- Business email

Error Handling#

Status / ErrorMeaning401 UnauthorizedToken expired; reconnect at the dashboard404 Not FoundInvalid ticket, contact, or department ID400 Bad RequestMissing required fields for ticket creation

Troubleshooting#

Tools Not Visible#

Run openclaw gateway restart after installing the plugin. Start a fresh chat session.

Cannot Create Ticket#

Ensure you have the correct departmentId from zoho_desk_list_departments.

Resources#

• Zoho Desk API Docs: https://www.zoho.com/desk/developer-help/api/
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=zoho-desk
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw