← Back to Skills Marketplace
hith3sh

Zoho Desk

by Jay · GitHub ↗ · v0.2.0 · MIT-0
cross-platform ✓ Security Clean
35
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install zoho-desk
Description
Zoho Desk API integration with managed OAuth. Manage support tickets, track conversations, list departments and agents, handle contacts and organizations. Us...
README (SKILL.md)

Zoho Desk

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: Install Step 2: Pair Account Step 3: Connect Zoho Desk
Install Pair App-specific connection GIF coming soon
Run the install command in OpenClaw Sign in and approve the device Open the dashboard and connect Zoho Desk

How It Works

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

Install

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

Tool Description Mode
zoho_desk_list_tickets List tickets with optional filters Read
zoho_desk_get_ticket Get details of a specific ticket Read
zoho_desk_create_ticket Create a new support ticket Write
zoho_desk_get_ticket_resolution Get the resolution for a ticket Read
zoho_desk_list_ticket_conversations List all conversations for a ticket Read
zoho_desk_get_ticket_latest_thread Get the most recent thread on a ticket Read
zoho_desk_get_ticket_thread Get a specific thread within a ticket Read

Contact Operations

Tool Description Mode
zoho_desk_list_contacts List contacts with filters and pagination Read
zoho_desk_get_contact Get details of a specific contact Read
zoho_desk_get_contacts_by_ids Fetch multiple contacts by IDs Read
zoho_desk_list_contact_accounts List accounts associated with a contact Read

Agent Operations

Tool Description Mode
zoho_desk_get_agent Get details of a specific agent Read
zoho_desk_get_agents_count Get total agent count with optional filters Read

Department Operations

Tool Description Mode
zoho_desk_list_departments List all departments Read
zoho_desk_get_department Get details of a specific department Read
zoho_desk_get_departments_count Get total department count Read
zoho_desk_get_department_logo Download a department's logo Read
zoho_desk_upload_department_logo Upload/update a department logo Write
zoho_desk_list_teams_in_department List teams within a department Read

Organization Operations

Tool Description Mode
zoho_desk_list_organizations List organizations the user belongs to Read

Role Operations

Tool Description Mode
zoho_desk_list_roles List all roles Read
zoho_desk_list_roles_by_ids List roles by specific IDs Read

Task Operations

Tool Description Mode
zoho_desk_update_many_tasks Update multiple tasks in a single call Write

Code Examples

List open tickets

{ "tool": "zoho_desk_list_tickets" }

Create a support ticket

{
  "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

{
  "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

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 / Error Meaning
401 Unauthorized Token expired; reconnect at the dashboard
404 Not Found Invalid ticket, contact, or department ID
400 Bad Request Missing 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


Powered by ClawLink -- an integration hub for OpenClaw

ClawLink Logo

Usage Guidance
Install only if you intend to connect Zoho Desk through ClawLink. Review the Zoho account permissions you grant, and confirm any ticket creation, department logo upload, or bulk task update before allowing the agent to run it.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The listed capabilities match the stated Zoho Desk support workflow purpose: tickets, conversations, contacts, departments, agents, roles, organizations, and limited write operations.
Instruction Scope
The invocation text is somewhat broad for support workflows, but it repeatedly identifies Zoho Desk and ClawLink, and the tool reference clearly marks read versus write operations.
Install Mechanism
Installation enables the external clawlink-plugin and restarts the OpenClaw gateway; this is disclosed and coherent with the hosted OAuth integration, but users should recognize it grants access through ClawLink.
Credentials
The skill is a non-executable Markdown instruction file and does not request local file indexing, shell persistence, background workers, or unrelated system access.
Persistence & Privilege
OAuth credentials are handled by ClawLink rather than embedded in the artifact; the skill discloses this, but connected Zoho Desk access remains sensitive.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install zoho-desk
  3. After installation, invoke the skill by name or use /zoho-desk
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.0
Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.
Metadata
Slug zoho-desk
Version 0.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Zoho Desk?

Zoho Desk API integration with managed OAuth. Manage support tickets, track conversations, list departments and agents, handle contacts and organizations. Us... It is an AI Agent Skill for Claude Code / OpenClaw, with 35 downloads so far.

How do I install Zoho Desk?

Run "/install zoho-desk" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Zoho Desk free?

Yes, Zoho Desk is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Zoho Desk support?

Zoho Desk is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Zoho Desk?

It is built and maintained by Jay (@hith3sh); the current version is v0.2.0.

💬 Comments