用途：在客户支持与工单场景中通过 Freshdesk API 操作数据，涉及工单、会话、联系人、公司、客服人员、分组与知识库。
主要能力：列出/查询/创建/更新/删除工单；获取工单详情并包含请求人、公司与统计信息；列出工单会话、公开发布回复、添加内部备注；使用查询 DSL 进行高级搜索；管理联系人与公司；列出客服人员、分组并分配工单；浏览与创建解决方案（知识库）文章。
使用方式：需设置 FRESHDESK_TOKEN（API 密钥）与 FRESHDESK_DOMAIN（子域名）。基础地址为 https://$FRESHDESK_DOMAIN.freshdesk.com/api/v2。认证使用 HTTP Basic，密钥作用户名、字面 X 作密码：-u "$FRESHDESK_TOKEN:X"。创建/更新请求体写入 /tmp/freshdesk_request.json 后用 curl -d @ 发送；搜索查询写入 /tmp/freshdesk_query.txt，用 --data-urlencode "query@/tmp/freshdesk_query.txt"。分页用 page 与 per_page（上限 100）。列表端点可用 updated_since 做增量同步。
限制：无任意字段的批量更新端点，需逐工单迭代，并在 429 时遵守 Retry-After。速率限制按套餐：Free/Growth 1000、Pro 5000、Enterprise 10000 次/小时，部分端点另有分钟子限制；可查看 X-RateLimit-Total、X-RateLimit-Remaining、X-RateLimit-Used-CurrentRequest 响应头。工单 status 与 priority 为整数枚举；创建工单必须提供请求人（email、phone、requester_id、twitter_id 或 facebook_id 之一）。日期接受带 Z 的 ISO-8601。Sprout 套餐不含 API 访问，若每次调用返回 401 需核对套餐。排障可运行 zero doctor check-connector --env-name FRESHDESK_TOKEN 或 zero doctor check-connector --url https://$FRESHDESK_DOMAIN.freshdesk.com/api/v2/tickets --method GET。
API 文档：https://developers.freshdesk.com/api/