> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.alephant.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.alephant.io/_mcp/server.

# Gong

> 配置 Gong 通话转录索引，并明确工作区、时间窗口、checkpoint 与搜索访问边界。

## 索引内容

Gong 连接器会为每份通话转录创建一个可搜索文档。它会把转录数据与 Gong extensive-call 端点返回的通话详情组合起来。

| 通话数据       | 索引行为                                                        |
| ---------- | ----------------------------------------------------------- |
| Transcript | 说话人片段会拼接为带说话人标识的文本。句子文本会被索引；不会下载音频与视频媒体。                    |
| 通话详情       | 通话标题成为文档标识符。Purpose 会作为通话描述加入，Gong 通话 URL 会成为引用链接。          |
| 参与方        | Gong 返回参与方姓名或邮箱时，这些值会在可搜索文本中标识说话人。两者都不可用时，说话人显示为 `Unknown`。 |
| 日期与元数据     | 通话开始时间同时用作文档创建与更新时间。通话来源系统会存为 `client` 元数据。                 |
| 范围         | 可选工作区名称或 ID 会限制通话。没有工作区条目时，会请求凭据可见的全部工作区转录。                 |

当前管理表单未暴露连接器内部的说话人匿名化选项。规划访问时，应把 API 返回的参与方姓名与邮箱视为已索引内容。

## 前置条件

* 为专用集成用户创建 Gong API access key 与 access-key secret。
* 授予列举工作区、读取通话转录，以及读取包含 parties 的 extensive call details 的权限。
* 确定账号使用默认美国 API 主机还是区域专用 Gong API 主机。
* 如需限制范围，请收集每个准确的工作区 ID 或区分大小写的准确工作区名称。
* 连接器 worker 只需通过 HTTPS 访问所选 Gong API 主机；它会保存 Gong 返回的引用 URL，但不会打开该 URL。
* 最终用户浏览器必须能访问 Gong 返回的引用 URL 所在主机，才能打开源通话。
* 确定部署级 `GONG_CONNECTOR_START_TIME` 是否应该限制历史摄取，并考虑连接器向前重叠一天的行为。

## 凭据

| 方式                | OpenCore 凭据值                                                                                                                    | 认证行为                                                                                       |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Gong API key pair | `gong_access_key: <GONG_ACCESS_KEY>`、`gong_access_key_secret: <GONG_ACCESS_KEY_SECRET>`、可选 `gong_base_url: <GONG_API_BASE_URL>` | OpenCore 会把 key 与 secret 进行 Base64 编码并用于 HTTP Basic 认证。Base URL 默认是 `https://api.gong.io`。 |

对于非美国数据驻留，请输入 Gong 为该账号提供的区域专用 HTTPS 主机。OpenCore 接受 `api.gong.io` 或以 `.api.gong.io` 结尾的子域，在省略时补上 `https://`，并拒绝 HTTP 或非 Gong 主机。

## 在 OpenCore 中配置

1. 在管理后台打开**连接器**，选择 **Gong**，并创建 access-key 凭据。仅在账号要求时设置可选区域 Base URL。
2. 在**工作区**中输入零个或多个准确工作区名称或 ID。仅在已批准凭据可见的全部工作区时才留空。
3. 配置多个条目时，OpenCore 会保留所有能解析的条目。无效条目会被记录并跳过；如果一个都无法解析，索引会失败，而不会扩大到全部工作区。
4. 对受限通话内容选择**私有**并分配 OpenCore 群组。仅当每个 OpenCore 账号都可以搜索范围内全部转录与参与方标识时才使用**公开**。
5. 设置刷新与清理选项，创建连接器并运行首次索引。

首次 checkpoint 调用会解析工作区 ID 并缓存一个时间范围，然后在不获取转录页的情况下返回。后续调用每次处理一个工作区的一页数据。

## 权限

Gong key pair 控制 OpenCore 可以摄取哪些工作区、通话、转录、详情与参与方。Gong 工作区成员关系、call library 访问、团队权限与单通话访问不会同步到 OpenCore；该连接器没有源 ACL 或查询时 Gong 访问检查。

索引后，搜索访问由连接器的 OpenCore **私有**群组或**公开**模式控制。任何能访问连接器的用户都可以搜索完整的已索引转录与返回的参与方标识，即使该用户无法在 Gong 中打开对应通话。应使用最小权限 Gong 集成用户、明确工作区范围，并为不得共享通话的受众使用独立连接器与 OpenCore 群组。

## 验证

1. 运行连接器，并确认已配置工作区名称或 ID 解析为预期工作区 ID。
2. 持续执行 checkpoint 调用直到运行完成，然后为每个已配置工作区搜索一个通话标题和一句独特转录文本。
3. 确认未配置工作区中的通话不存在。工作区列表为空时，确认全工作区范围确实符合预期。
4. 检查一个结果中的通话 purpose、说话人标识、通话开始时间与 Gong 引用 URL。
5. 根据 `GONG_CONNECTOR_START_TIME` 与向前一天重叠核对最早索引通话；不要把该部署值视为严格的禁止摄取边界。
6. 测试每个已分配的 OpenCore 群组，因为搜索时不会重新检查 Gong 权限。

## 故障排除

| 症状                   | 检查项                                                                                                |
| -------------------- | -------------------------------------------------------------------------------------------------- |
| 请求返回 401             | 替换 access key 或 access-key secret，并确认两者属于同一个 Gong API 凭据。                                          |
| 区域请求指向错误主机           | 设置账号的准确区域 API Base URL。只接受 HTTPS `api.gong.io` 或 `*.api.gong.io` 主机。                               |
| 已配置工作区均无法解析          | 使用区分大小写的准确名称或工作区 ID。至少一个条目能解析时会跳过无效条目；一个都无法解析时连接器会失败关闭。                                            |
| 空工作区配置读取了非预期通话       | 空范围表示凭据可见的全部工作区。添加明确工作区名称或 ID，并使用范围更窄的集成用户。                                                        |
| 首次 checkpoint 没有产生文档 | 这是预期行为。首次调用会解析工作区范围并缓存时间窗口；之后的调用才获取首个转录页。                                                          |
| 已配置起始时间之前仍出现历史通话     | OpenCore 先取轮询起点与 `GONG_CONNECTOR_START_TIME` 中较晚者，再把请求起点向前移动一天，以便纳入已完成通话。该设置不是严格隐私截止线。             |
| 转录出现在 Gong 后仍延迟索引    | 通话详情可能晚于转录。OpenCore 会跨 checkpoint 运行重试未解析详情，总计六次并使用有门控的指数延迟；之后仍未解析的通话会产生 `ConnectorFailure`。       |
| 分页重新开始且文档重复          | Gong cursor 从分页序列开始后可能在约一小时过期。OpenCore 会重新开始当前工作区；按 call ID upsert 可保证重新处理幂等。                      |
| 请求收到 429 或暂时性 5xx 错误 | 连接器会把请求间隔保持在至少 0.5 秒，并为这些状态配置 retry adapter。不要假设每个 POST 都已重试；请检查 attempt 日志，等待限流或服务窗口恢复，并在需要时重新运行。 |
| 用户能搜索但无法在 Gong 中打开通话 | 这是预期行为，因为 Gong ACL 不会同步。使用 OpenCore 群组限制连接器，或把工作区拆分到不同连接器。                                         |

## 相关页面

* [连接器与索引](/opencore/knowledge/connectors)
* [索引设置](/opencore/knowledge/index-settings)