API Key 管理

API Key 的创建、查看与撤销，以及权限范围的控制方式。

API Key 的创建入口位于左侧菜单 企业信息 页右侧的 API 秘钥 卡片。

创建一个 Key

点击卡片右上角 创建，填写以下内容：

• 名称：用于识别使用该 Key 的系统（如"生产环境 Key"）

• 权限范围：勾选该 Key 可执行的操作，支持多选：

  • 查询（READ）：查询项目、线索、通话结果、统计与话术配置
  • 线索管理（LEADS）：上传、推送、撤销线索
  • 项目控制（CONTROL）：创建项目、关联数字员工、启停项目、修改拨打配置与 Webhook
  • 话术管理（SCRIPT）：修改话术、音色与提取配置。该权限直接影响 AI 对客户的表述，请谨慎授予

  「项目控制」与「话术管理」需企业开通「协作项目」，未开通时这两项不可选；平台管理员与渠道管理员账号创建 Key 不受此限制。各接口所需权限见接入概述。

创建成功后，弹窗将显示完整的 Key 值，并提示完整 Key 仅展示这一次。请立即复制并妥善保存，关闭弹窗后仅可查看脱敏后的前后缀。

列表信息

每条 Key 显示名称、激活状态、脱敏后的 Key（前缀****后缀）、权限范围标签、创建时间，以及最近一次调用时间（调用过才显示）。

撤销

点击 Key 名称右侧的删除图标，确认后立即失效且无法恢复。如需继续使用，请按相同权限范围重新创建。

安全建议

• 按用途创建多个 Key，避免多个系统共用同一个 Key；某一系统出现问题时，只需撤销对应的 Key，不影响其他系统
• 按最小权限原则勾选权限范围：仅需查询数据时只勾选 查询；无需远程修改话术时不勾选 话术管理
• 供 AI Agent 使用的 Key（见接入 AI Agent），其操作权限同时受该 Key 创建人在网页端的权限限制
• 定期检查"最后使用时间"，及时撤销长期未使用的 Key