请求明确Amazon Connect发出的Contact Events的JSON Schema规范

一、术语澄清 #

• 原Data Streaming模块中的Contact Trace Records（CTR）已逐步被Contact Events取代，当前官方统一使用Contact Events指代联络事件流数据。

二、Contact Events 标准JSON Schema规范 #

你提供的示例是Amazon EventBridge格式的Contact Events（外层为EventBridge通用事件结构，内层detail为联络核心数据），以下是官方明确的规范结构：

外层EventBridge通用固定结构 #

{
  "version": "0",
  "id": "UUID",
  "detail-type": "Amazon Connect Contact Event",
  "source": "aws.connect",
  "account": "AWS账号ID",
  "time": "事件生成时间（ISO 8601格式）",
  "region": "AWS区域",
  "resources": [
    "联络ARN",
    "实例ARN"
  ],
  "detail": {
    // 联络核心数据，见下方定义
  }
}

内层detail联络核心数据结构 #

必填字段

• eventType: 事件类型，枚举值包括INITIATED、CONNECTED_TO_SYSTEM、QUEUED、CONNECTED_TO_AGENT、DISCONNECTED等
• contactId: 当前联络唯一ID
• initialContactId: 初始联络链的根ID（转呼/转接场景保持不变）
• channel: 联络渠道，枚举值Voice、Chat、Task
• instanceArn: Amazon Connect实例ARN
• initiationMethod: 联络发起方式，枚举值INBOUND、OUTBOUND、TRANSFER、CALLBACK等

可选字段（根据事件类型动态返回）

• previousContactId: 上一个联络ID（仅转接/转呼场景存在）
• connectedToSystemTimestamp: 联络接入系统时间（ISO 8601格式）
• disconnectTimestamp: 联络断开时间（仅DISCONNECTED事件返回）
• queueInfo: 队列信息对象
  • queueArn: 队列ARN
  • queueType: 队列类型，枚举值STANDARD、AGENT、OUTBOUND
  • enqueueTimestamp: 进入队列时间
• agentInfo: 坐席信息对象
  • agentArn: 坐席ARN
  • connectedToAgentTimestamp: 连接到坐席的时间
• customerVoiceActivity: 客户语音交互数据（仅Voice渠道返回）
  • greetingStartTimestamp: 问候语开始时间
  • greetingEndTimestamp: 问候语结束时间

三、文档不一致问题说明 #

部分旧文档或示例可能存在字段大小写不统一（比如你提供示例中的AgentInfo/AgentArn，官方标准应为小驼峰式agentInfo/agentArn），请以官方最新规范为准：所有嵌套对象和字段均采用小驼峰命名规范，可选字段仅在对应事件触发时才会出现在detail中。

内容的提问来源于stack exchange，提问作者Kode Charlie