名称： gong
描述： Gong API 用于搜索通话、转录文本和对话智能数据。适用于处理 Gong 通话录音、销售对话、转录文本、会议数据或对话分析。支持列出通话、获取转录文本、用户管理和活动统计。
元数据：
{
"openclaw":
{
"emoji": "🎙️",
"requires":
{
"config": ["~/.config/gong/credentials.json"],
},
},
}

Gong

访问 Gong 对话智能平台——获取通话、转录文本、用户和分析数据。

设置

将凭据存储在 ~/.config/gong/credentials.json 文件中：

{
  "base_url": "https://us-XXXXX.api.gong.io",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY"
}

从 Gong 获取凭据：设置 → 生态系统 → API → 创建 API 密钥。

认证

GONG_CREDS=~/.config/gong/credentials.json
GONG_BASE=$(jq -r '.base_url' $GONG_CREDS)
GONG_AUTH=$(jq -r '"\(.access_key):\(.secret_key)"' $GONG_CREDS | base64)

curl -s "$GONG_BASE/v2/endpoint" \
  -H "Authorization: Basic $GONG_AUTH" \
  -H "Content-Type: application/json"

核心操作

列出用户

curl -s "$GONG_BASE/v2/users" -H "Authorization: Basic $GONG_AUTH" | \
  jq '[.users[] | {id, email: .emailAddress, name: "\(.firstName) \(.lastName)"}]'

列出通话（带日期范围）

curl -s -X POST "$GONG_BASE/v2/calls/extensive" \
  -H "Authorization: Basic $GONG_AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "fromDateTime": "2025-01-01T00:00:00Z",
      "toDateTime": "2025-01-31T23:59:59Z"
    },
    "contentSelector": {}
  }' | jq '{
    total: .records.totalRecords,
    calls: [.calls[] | {
      id: .metaData.id,
      title: .metaData.title,
      started: .metaData.started,
      duration_min: ((.metaData.duration // 0) / 60 | floor),
      url: .metaData.url
    }]
  }'

获取通话转录文本

curl -s -X POST "$GONG_BASE/v2/calls/transcript" \
  -H "Authorization: Basic $GONG_AUTH" \
  -H "Content-Type: application/json" \
  -d '{"filter": {"callIds": ["CALL_ID"]}}' | \
  jq '.callTranscripts[0].transcript[] | "\(.speakerName // "Speaker"): \(.sentences[].text)"' -r

获取通话详情

curl -s -X POST "$GONG_BASE/v2/calls/extensive" \
  -H "Authorization: Basic $GONG_AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {"callIds": ["CALL_ID"]},
    "contentSelector": {"exposedFields": {"content": true, "parties": true}}
  }' | jq '.calls[0]'

活动统计

curl -s -X POST "$GONG_BASE/v2/stats/activity/aggregate" \
  -H "Authorization: Basic $GONG_AUTH" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "fromDateTime": "2025-01-01T00:00:00Z",
      "toDateTime": "2025-01-31T23:59:59Z"
    }
  }'

接口参考

分页

响应中包含用于分页的游标：

{"records": {"totalRecords": 233, "cursor": "eyJ..."}}

在后续请求中包含游标：{"cursor": "eyJ..."}

日期辅助工具

# 最近 7 天
FROM=$(date -v-7d +%Y-%m-%dT00:00:00Z 2>/dev/null || date -d "7 days ago" +%Y-%m-%dT00:00:00Z)
TO=$(date +%Y-%m-%dT23:59:59Z)

注意事项

• 速率限制：约每秒 3 个请求
• 通话 ID 为字符串形式的大整数
• 通话结束后，转录文本可能需要时间处理
• 日期格式：ISO 8601（例如 2025-01-15T00:00:00Z）