Gong 技能用于访问 Gong 对话智能平台的数据,涵盖通话、转录文本、用户和分析信息。
用途 该技能面向需要从 Gong 获取销售通话与会议对话数据的场景,可用于检索通话记录、提取转录文本、查询用户列表以及获取活动统计等。
主要能力
- 列出用户:通过 GET /v2/users 获取用户列表,可提取 id、邮箱和姓名。
- 列出与筛选通话:通过 POST /v2/calls/extensive,可按 fromDateTime 与 toDateTime 日期范围筛选通话,返回通话总数及通话的 id、标题、开始时间、时长(分钟)和 URL。
- 获取通话转录文本:通过 POST /v2/calls/transcript,按 callIds 获取转录内容,可按说话人输出句子文本。
- 获取通话详情:通过 POST /v2/calls/extensive 并指定 contentSelector 的 exposedFields(如 content、parties)获取单条通话的详细信息。
- 活动统计:通过 POST /v2/stats/activity/aggregate,按日期范围获取聚合活动统计。
- 会议:通过 GET /v2/meetings 获取已安排的会议。
使用方式
- 准备凭据:在 Gong 后台 Settings → Ecosystem → API → Create API Key 创建 API Key,并将 base_url、access_key、secret_key 写入 ~/.config/gong/credentials.json。
- 认证:使用 HTTP Basic 认证,将 access_key 与 secret_key 以 "access_key:secret_key" 形式进行 base64 编码后放入 Authorization 头。
- 调用端点:使用 curl 等工具向对应端点发送请求,请求头包含 Authorization 与 Content-Type: application/json。
- 分页:响应中包含 records.cursor,下一次请求需携带该 cursor 以获取后续数据。
- 日期处理:可使用 shell 日期命令生成最近 7 天等时间范围,格式为 ISO 8601(如 2025-01-15T00:00:00Z)。
适用场景
- 销售对话分析与复盘。
- 按时间范围批量检索通话记录。
- 提取通话转录文本用于后续处理。
- 统计团队或个人的活动数据。
- 查询已安排的会议。
限制与注意事项
- 速率限制约为每秒 3 次请求。
- 通话 ID 为以字符串形式表示的大整数。
- 通话结束后转录文本可能需要一定时间处理。
- 日期格式需为 ISO 8601。
- 具体收费、价格、平台支持范围等资料暂未提供。