← 返回 Skills 市场
hith3sh

Zoho Desk

作者 Jay · GitHub ↗ · v0.2.0 · MIT-0
cross-platform ✓ 安全检测通过
35
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install zoho-desk
功能描述
Zoho Desk API integration with managed OAuth. Manage support tickets, track conversations, list departments and agents, handle contacts and organizations. Us...
使用说明 (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

安全使用建议
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.
能力标签
requires-oauth-tokenrequires-sensitive-credentials
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install zoho-desk
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /zoho-desk 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug zoho-desk
版本 0.2.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Zoho Desk 是什么?

Zoho Desk API integration with managed OAuth. Manage support tickets, track conversations, list departments and agents, handle contacts and organizations. Us... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 35 次。

如何安装 Zoho Desk?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install zoho-desk」即可一键安装,无需额外配置。

Zoho Desk 是免费的吗?

是的,Zoho Desk 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Zoho Desk 支持哪些平台?

Zoho Desk 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Zoho Desk?

由 Jay(@hith3sh)开发并维护,当前版本 v0.2.0。

💬 留言讨论