通道与通道变量

快速阅读

通道是一通电话在呼叫中心里的实时承载。通道变量是随这通电话传递的业务上下文。变量出现在弹屏、IVR 或推送里，不自动等于话单字段；要长期查询，还得按配置沉淀。

主通道看整通，子通道看某一段过程。对应主话单和从话单。
内置变量由平台生成。自定义变量由外部请求、SIP Header、IVR、呼入或外呼机器人、外呼任务或座席操作写入。缓存变量强调当前通话或当前会话里临时可用。共享变量是一通电话上可跨节点读写的集合，推送用 SVAR(变量名) 引用，配置在推送配置。
串联用 mainUniqueId、uniqueId、requestId、taskId。字段名保持原文。
弹屏在座席工作台。话后整理是座席状态，不是话后分析。

本文是通道目录。主从关系、各变量子页的差别在子页。本页不把子页的字段表搬进来，只保留看整条链路时要用的标识。

实时通道（主通道 / 子通道）
→ 通道变量（内置 / 自定义 / 缓存）
→ 运行时消费：IVR、TTS、座席工作台弹屏
→ 按配置进入主话单、从话单、推送、导出

对象	是什么	不要当成
通道	通话进行时的承载	一条话单
主通道	整通业务会话	某一个座席腿
子通道	响铃、转接、咨询、三方等过程腿	主话单
通道变量	变量名 + 变量值，随通话走	页面上已经展示的列
内置变量	平台标准通话事实	客户自己约定的订单号
自定义变量	项目约定写入的业务字段	内置变量
缓存变量	当前通话或会话里的临时值	已经沉淀的话单字段
共享变量	一通电话上可跨节点读写的变量集合。推送用 `SVAR(变量名)` 引用	自定义变量页，或 Copilot 常用变量

呼入机器人或外呼机器人产生的会话 ID、意图、摘要、转人工原因，可以作为变量交给后续 IVR 或座席工作台。机器人会话记录不是从话单。

字段	作用
通话标识	定位一次通话。排障时优先用
请求唯一标识	外部请求对应的业务标识。点击外呼、WebCall、回拨场景传入
`mainUniqueId`	整通主锚点。串联主话单、从话单、录音
`uniqueId`	某一段通话腿或从话单
`requestId`	外部请求，或呼入 / 外呼机器人会话
`taskId`	外呼任务
变量名	弹屏、推送、IVR、TTS 要使用同一名字
变量值	这一通实际带上的内容
变量来源	请求、Header、IVR、呼入或外呼机器人、任务
变量消费方	弹屏、推送、记录、IVR
客户编号	建议传 ID
工单号 / 订单号	弹屏、回写、IVR 查询
机器人会话 ID	关联呼入或外呼机器人会话
转人工原因	从呼入机器人或外呼机器人进入人工时保留
活动批次	外呼或任务批次

主叫、被叫只用于说明某一段信令腿。业务上的联系号码写客户号码。

弹屏上有值，话单里没有？
弹屏读的是运行时变量。话单里要有，得单独配置沉淀。

变量名可以事后改吗？
被弹屏、推送、记录或 IVR 引用之后，改名会影响这些消费方。上线前定名。

呼入和座席外呼的变量来源一样吗？
使用方式类似。呼入多来自号码识别、SIP Header、收号和呼入机器人；座席外呼和外呼任务多来自发起请求或名单。

先分清这一通的主通道和各段子通道，再决定哪些变量只在运行时用，哪些要进话单和推送。名字在弹屏、IVR 和推送里保持一致。