freshdesk-api

用途：该技能围绕 Freshdesk 帮助台平台的 REST API v2，帮助构建客服集成、抽取支持数据、管理工单/联系人/公司，并自动化客服流程，如工单分配、CRM 同步、自定义报表及聊天机器人或 AI 客服工具。主要能力：对工单、联系人、公司、坐席、坐席组、会话、工时、满意度评价、产品目录、工作时间、邮件配置、SLA 策略、预设回复和自定义工单字段等资源提供 CRUD；支持预定义过滤（如 new_and_my_open、all_unresolved）、updated_since 时间过滤、include 嵌入关联数据、分页（per_page 最大 100）、Search API 复杂查询与全文检索。使用方式：认证采用 HTTP Basic，用户名是 API Key、密码为 X；基础地址为 https://{domain}.freshdesk.com/api/v2/，请求头需含 Content-Type: application/json。API Key 在管理员个人资料设置中获取，建议存入环境变量（如 FRESHDESK_API_KEY、FRESHDESK_DOMAIN），切勿提交到版本控制。依赖 curl 与 jq；也可用 Python（pip install python-freshdesk）、Node.js（npm install node-freshdesk-api）或 Ruby（gem install freshdesk）SDK。搜索示例：query="status:2 AND priority:3"，支持 AND/OR、:、:>、:< 和 ~ 全文运算符。限制与注意：v2 限流按套餐按分钟计，试用计划为 50 次/分钟，响应头含 X-Ratelimit-Total、X-Ratelimit-Remaining、X-Ratelimit-Used-CurrentRequest；部分操作消耗多个积分（基础 1，每加入一个 include 再加 1）。需处理 400/401/403/404/409/429/500 等状态码，对 429 与 5xx 采用指数退避重试。Webhook 可在 Admin → Automations → Webhooks 配置，支持工单创建、更新、坐席回复、客户回复、添加备注、解决/关闭等事件。建议用 Webhook 替代轮询、缓存静态数据（坐席列表、工单字段）、批量分页操作并记录 API 调用日志。其它功能、收费、价格、平台或效果等资料暂未提供。