许多事件同时带 state 和 stateAction。state 是座席的粗粒度状态，stateAction 是触发这次变化的动作或原因。
- 用它们驱动座席工作台按钮、文案和计时，并拦住当前状态不允许的操作。
wrapup 表示话后整理。- 下表是取值原文。集成时按字符串匹配，不要改写枚举。
- 哪些事件带这两个字段：读「二」。
state 有哪些值：读「三」。- 每个
state 下的 stateAction：读「四」。
- 字段怎么嵌在载荷里，见 类型 的
AgentStatusPayload。事件说明见 事件。
agentStatus、previewObCallRinging、atxferStart 等事件包含：
state：座席的粗粒度状态。stateAction：触发该状态变化的细粒度动作或原因。
可以用来：
- 驱动界面：按钮启用或禁用、标签文案、计时器。
- 拦住无效操作：例如不在通话中时不执行 Hold。
- 记录可回放的通话流程日志。
agentStatuspreviewObCallRingingpreviewObCallBridgeatxferStartatxferLinkatxferEndedatxferErrorthreewayAtxferResultatxferThreewayUnlinkcompleteAtxferResult
| state | 说明 |
|---|
| offline | 离线（未登录） |
| invalid | 无效/不可用（例如终端绑定异常） |
| idle | 空闲 |
| busy | 忙碌 |
| calling | 拨号中 |
| ringing | 振铃中 |
| talking | 通话中 |
| wrapup | 话后整理中 |
| stateAction | 说明 |
|---|
| idle | 设置为空闲 |
| ringingNoAnswerIb | 呼入未接听 |
| ringingAgentNoAnswerOb | 外呼时座席未接听 |
| ringingCustomerNoAnswerOb | 外呼时客户未接听 |
| ringingConsultNoAnswer | 咨询未接听 |
| ringingTransferNoAnswer | 转接未接听 |
| ringingMonitorNoAnswer | 监听未接听 |
| hangup | 挂断 |
| stateAction | 说明 |
|---|
| pause | 设置为忙碌 |
| ringingNoAnswerIb | 呼入未接听 |
| ringingAgentNoAnswerOb | 外呼时座席未接听 |
| ringingCustomerNoAnswerOb | 外呼时客户未接听 |
| ringingConsultNoAnswer | 咨询未接听 |
| ringingTransferNoAnswer | 转接未接听 |
| ringingMonitorNoAnswer | 监听未接听 |
| hangup | 挂断 |
| stateAction | 说明 |
|---|
| ringingIb | 呼入振铃 |
| ringingAgentOb | 外呼时座席振铃 |
| ringingConsult | 咨询振铃 |
| ringingTransfer | 转接振铃 |
| ringingInteract | IVR 交互振铃 |
| ringingMonitor | 监听振铃 |
| stateAction | 说明 | 常见来源事件 |
|---|
| busyIb | 呼入通话中 | agentStatus |
| ringingCustomerOb | 外呼时客户振铃中 | previewObCallRinging |
| busyAgentOb | 座席已接听，正在呼叫客户 | agentStatus |
| busyOb | 外呼已桥接 | previewObCallBridge |
| busyConsult | 咨询通话中 | agentStatus |
| busyTransfer | 转接通话中 | agentStatus |
| busyMonitor | 监听进行中 | agentStatus |
| hold | 保持 | agentStatus |
| unhold | 取消保持/取回 | agentStatus |
| atxferStart | 已发起咨询 | atxferStart |
| atxferLink | 咨询已接通 | atxferLink |
| atxferError | 咨询失败 | atxferError |
| threewayAtxferResult | 咨询三方通话 | threewayAtxferResult |
| atxferThreewayUnlink | 咨询三方通话结束 | atxferThreewayUnlink |
| completeAtxferResult | 咨询转接已完成 | completeAtxferResult |
| atxferEnded | 咨询已结束/恢复/取消 | atxferEnded |