# Send Zendesk to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zendesk",
    "name": "Zendesk",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/zendesk",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/zendesk",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zendesk",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zendesk",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "api-reference.md",
      "memory-template.md",
      "setup.md",
      "troubleshooting.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zendesk"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zendesk",
    "downloadUrl": "https://openagent3.xyz/downloads/zendesk",
    "agentUrl": "https://openagent3.xyz/skills/zendesk/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zendesk/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zendesk/agent.md"
  }
}
```
## Documentation

### Setup

On first use, read setup.md for API credentials and workspace integration.

### When to Use

User needs to interact with Zendesk: create or update tickets, search support history, check user details, or automate support workflows. Agent handles API operations, ticket management, and reporting.

### Architecture

Memory at ~/zendesk/. See memory-template.md for structure.

~/zendesk/
├── memory.md        # Credentials + preferences + recent context
├── templates/       # Saved ticket templates and macros
└── exports/         # Report exports and ticket dumps

### Quick Reference

TopicFileSetup processsetup.mdMemory templatememory-template.mdAPI operationsapi-reference.mdCommon issuestroubleshooting.md

### 1. Authenticate Before Operations

Credentials from environment variables (ZENDESK_SUBDOMAIN, ZENDESK_EMAIL, ZENDESK_TOKEN) or ~/zendesk/memory.md.

# Test auth
curl -u "$ZENDESK_EMAIL/token:$ZENDESK_TOKEN" "https://$ZENDESK_SUBDOMAIN.zendesk.com/api/v2/users/me.json"

### 2. Search Before Create

Always search existing tickets before creating new ones to avoid duplicates.

curl -u "$AUTH" "$BASE/search.json?query=type:ticket+subject:issue"

### 3. Use Views for Efficiency

Don't list all tickets. Use views to get relevant subsets.

ViewUse Case/views/activeGet available views/views/{id}/ticketsTickets in specific view/tickets/recentRecently updated

### 4. Preserve Ticket History

When updating, add internal notes explaining changes. Never delete ticket data.

### 5. Rate Limits

Zendesk limits: 700 requests/minute (Enterprise), 200/minute (others). Add delays for bulk operations.

### 6. Always Confirm Destructive Actions

Before closing, merging, or deleting tickets, confirm with user and summarize what will happen.

### Common Operations

Set auth: AUTH="$ZENDESK_EMAIL/token:$ZENDESK_TOKEN" and BASE="https://$ZENDESK_SUBDOMAIN.zendesk.com/api/v2"

### Create Ticket

curl -X POST "$BASE/tickets.json" -u "$AUTH" -H "Content-Type: application/json" \\
  -d '{"ticket":{"subject":"Issue","comment":{"body":"Description"},"priority":"normal"}}'

### Update Ticket Status

curl -X PUT "$BASE/tickets/$ID.json" -u "$AUTH" -H "Content-Type: application/json" \\
  -d '{"ticket":{"status":"solved","comment":{"body":"Resolution","public":false}}}'

### Search Tickets

curl -u "$AUTH" "$BASE/search.json?query=type:ticket+status:open+priority:urgent"

### Get User Details

curl -u "$AUTH" "$BASE/users/search.json?query=email:user@example.com"

### Ticket Statuses

StatusMeaningNext ActionsnewUnassignedAssign, respondopenBeing workedUpdate, solvependingWaiting on customerFollow up, solveholdWaiting internallyUnhold, updatesolvedResolution providedClose (auto after 4 days)closedFinalReopen creates new ticket

### Priorities

PrioritySLA TargetUse Forurgent1 hourSystem down, revenue impacthigh4 hoursMajor feature brokennormal8 hoursStandard issueslow24 hoursQuestions, minor bugs

### Common Traps

Auth format wrong → Must be email/token:API_TOKEN, not just token
Searching with special chars → URL-encode queries
Bulk updates failing → Check rate limits, add 100ms delay
Missing ticket fields → Some fields require specific plans
Pagination ignored → Results capped at 100, use next_page URL

### External Endpoints

EndpointData SentPurposehttps://{subdomain}.zendesk.com/api/v2/*Ticket/user dataAll operations

No other data is sent externally.

### Security & Privacy

Data that leaves your machine:

Ticket content sent to Zendesk API
Search queries sent to Zendesk

Data that stays local:

API credentials in ~/zendesk/memory.md
Exported reports in ~/zendesk/exports/

This skill does NOT:

Store credentials in plain text outside ~/zendesk/
Send data to any service other than Zendesk
Access tickets without explicit user request

### Trust

By using this skill, ticket and user data is sent to Zendesk's API.
Only install if you have authorized Zendesk API access.

### Related Skills

Install with clawhub install <slug> if user confirms:

api - REST API patterns
customer-support - Support best practices
csv - Export and analyze ticket data

### Feedback

If useful: clawhub star zendesk
Stay updated: clawhub sync
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ivangdavila
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zendesk)
- [Send to Agent page](https://openagent3.xyz/skills/zendesk/agent)
- [JSON manifest](https://openagent3.xyz/skills/zendesk/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zendesk/agent.md)
- [Download page](https://openagent3.xyz/downloads/zendesk)