SuperAPI AI 工具集

gong

营销与增长

查看项目

更新于 10-16 07:11

技能介绍

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 获取已安排的会议。

使用方式

  1. 准备凭据:在 Gong 后台 Settings → Ecosystem → API → Create API Key 创建 API Key,并将 base_url、access_key、secret_key 写入 ~/.config/gong/credentials.json。
  2. 认证:使用 HTTP Basic 认证,将 access_key 与 secret_key 以 "access_key:secret_key" 形式进行 base64 编码后放入 Authorization 头。
  3. 调用端点:使用 curl 等工具向对应端点发送请求,请求头包含 Authorization 与 Content-Type: application/json。
  4. 分页:响应中包含 records.cursor,下一次请求需携带该 cursor 以获取后续数据。
  5. 日期处理:可使用 shell 日期命令生成最近 7 天等时间范围,格式为 ISO 8601(如 2025-01-15T00:00:00Z)。

适用场景

  • 销售对话分析与复盘。
  • 按时间范围批量检索通话记录。
  • 提取通话转录文本用于后续处理。
  • 统计团队或个人的活动数据。
  • 查询已安排的会议。

限制与注意事项

  • 速率限制约为每秒 3 次请求。
  • 通话 ID 为以字符串形式表示的大整数。
  • 通话结束后转录文本可能需要一定时间处理。
  • 日期格式需为 ISO 8601。
  • 具体收费、价格、平台支持范围等资料暂未提供。