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 控制台中获取凭证：Settings → Ecosystem → API → Create API Key。

身份验证

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"
    }
  }'

端点参考

分页

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

{"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）