Gong通话分析

技能简介

Gong API技能用于访问Gong平台的对话智能数据，支持检索销售通话记录、获取语音转录文本、管理用户信息及查看活动统计数据。

能做什么

• 按日期范围筛选并列出通话记录
• 获取指定通话的完整语音转录内容
• 查询用户列表及基本信息
• 统计指定时间段内的活动数据
• 查看通话详情与参与方信息

使用说明

安装配置

1. 在Gong平台创建API密钥：进入 Settings → Ecosystem → API → Create API Key
2. 创建本地凭证文件 ~/.config/gong/credentials.json：

{"base_url": "https://us-XXXXX.api.gong.io","access_key": "YOUR_ACCESS_KEY","secret_key": "YOUR_SECRET_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/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

输入与输出

见下方输入与输出表格。

风险提示

• API速率限制约为每秒3次请求，高频调用可能触发限流
• 通话结束后转录文本需要一定处理时间，立即查询可能返回空结果
• 需妥善保管API密钥，避免凭证文件泄露
• 日期参数须使用ISO 8601格式，时区处理不当可能导致数据遗漏

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jdrhyne/gong/SKILL.md
来源类型：开源社区技能