SuperAPI AI 工具集

freshdesk

办公与效率

查看项目

更新于 10-16 06:57

技能介绍

Freshdesk 技能用于管理 Freshdesk 客服系统中的工单、联系人和客服人员,主要方式是通过 Freshdesk 的 REST API 进行调用。

用途 该技能适用于需要以编程或命令行方式访问 Freshdesk 客服数据的场景,例如查看现有工单、创建新工单、浏览联系人信息等。

环境变量 使用前需要配置以下环境变量:

  • FRESHDESK_DOMAIN:域名,例如 mycompany,对应 mycompany.freshdesk.com。
  • FRESHDESK_API_KEY:API 密钥。

主要能力与使用方式 资料提供了三个具体示例,均使用 curl 调用 REST API,并通过 jq 解析返回结果:

  1. 列出工单 curl -s -u "$FRESHDESK_API_KEY:X"
    "https://$FRESHDESK_DOMAIN.freshdesk.com/api/v2/tickets?per_page=10" | jq '.[] | {id, subject, status, priority}'

  2. 创建工单 curl -s -X POST -u "$FRESHDESK_API_KEY:X"
    -H "Content-Type: application/json"
    "https://$FRESHDESK_DOMAIN.freshdesk.com/api/v2/tickets"
    -d '{"subject":"Issue","description":"Details here","email":"user@example.com","priority":2,"status":2}' | jq '{id, subject}'

  3. 列出联系人 curl -s -u "$FRESHDESK_API_KEY:X"
    "https://$FRESHDESK_DOMAIN.freshdesk.com/api/v2/contacts?per_page=10" | jq '.[] | {id, name, email}'

认证方式为 HTTP Basic 认证,API 密钥作为用户名,密码位置留空(示例中写成 "$FRESHDESK_API_KEY:X")。

注意事项 资料明确提醒:在创建或更新工单之前,应始终先进行确认。

适用场景 适合在脚本、自动化流程或命令行环境中对 Freshdesk 的工单与联系人进行查询和创建操作。

限制 资料仅提供了列出工单、创建工单、列出联系人和环境变量配置的示例。关于计费与价格、支持平台、其他 API 端点、客服人员(agents)的具体操作示例,以及更多功能细节,资料暂未提供。