数字员工推送消息格式

更新时间:
复制 MD 格式

本文档介绍了数字员工开启事件推送后,如何配置消息推送的格式。

数字员工推送消息格式

VnRecordingReady消息格式(录音准备就绪消息)

{
  "eventType": "VnRecordingReady",
  "eventTime": "2025-11-05T01:51:20.974Z",  // 事件时间
  "instanceId": "ccc-test",                 // 云联实例ID
  "scenarioId": "scenario-xxxx",            // 场景ID
  "contactId": "job-xxxxxx",                // 导航的callId
  "duration": 59,                           // 通话时长
  "startTime": "2025-11-05T01:50:04.732Z",  // 通话开始时间
  "endTime": "2025-11-05T01:51:02.822Z",    // 通话结束时间
  "fileName": "xxxxxxx.wav",                // 录音文件名
  "downloadURL": "https://ccc-v2-online.oss-cn-shanghai.aliyuncs.com/ccc-record-mixed/predictivecall/2025/11/xxxxxxx.wav?Expires=1762393880&OSSAccessKeyId=LTAI************&Signature=Pt5eHtV0HH0B9q5Yd9JHbiJ6N5Q%3D"
  "ossBucket": "xxxxx",
  "ossFileKey": "ccc-record-mixed/predictivecall/xxxxxxx.wav"
}
说明

说明:downloadURL有效期1小时

VnReleased消息格式(通话完结消息)

{
  "eventType": "VnReleased",
  "eventTime": "2025-11-05T01:51:20.974Z",  // 事件时间. data.toInstant().toString()
  "instanceId": "ccc-test",                 // 云联实例ID
  "scenarioId": "scenario-xxxx",            // 场景ID, 对应导航的场景ID
  "contactId": "job-xxxxxx",                // 导航的conversationId
  "sandBox": false,                         // 是否沙盒(测试环境)
  "transferToAgent": false,                 // 是否转人工
  "caller": "1861234****",                  // 主叫
  "callee": "07552153****",                 // 被叫
  "releaseReason": 5,                       // 呼叫结果
  "turns": 3,                               // 通话轮次
  "lastPlaybackCompleted": false,           // 最后一句是否播报完成
  "releaseInitiator": "Customer/Chatbot",   // 挂机方(用户/机器人)
  "conversationDetails": [
      {
            "action": "BeginDialogue",
            "actionParams": "{\"sipCallId\":\"7447419d-3f2d-1240-4794-00163e0c5f5b\",\"requestId\":\"33e999c274f34aa9b7081ef69067a235\",\"conversationId\":\"949aabe1-34cd-4f72-bc1e-7d5ee2b3b8da\",\"CallType\":\"Predictive\",\"callingNumber\":\"1003\",\"k11\":\"v11\",\"channelId\":\"949aabe1-34cd-4f72-bc1e-7d5ee2b3b8da\",\"calledNumber\":\"10031001\",\"shouldUseSandBox\":true}",
            "createTime": 1791623504579,
            "sequenceId": "33e999c274f34aa9b7081ef69067a235",
            "speaker": "Customer"
        },
        {
            "action": "Broadcast",
            "actionParams": "{\"abortDialogueInfo\":{\"answer\":\"您好,语音测试。智能对话机\",\"sequenceId\":\"33e999c274f34aa9b7081ef69067a235\",\"abortDialogueType\":\"Interrupted\"},\"streamEnd\":true,\"isFinalAnswer\":false,\"userAnswerInterceptKeywords\":\"[{\\\"code\\\":\\\"voiceAssistant\\\",\\\"keywords\\\":[[\\\"无人接听\\\"],[\\\"无法接听\\\"],[\\\"无法接通\\\"],[\\\"用户正忙\\\"],[\\\"正在通话\\\"],[\\\"秘书\\\"],[\\\"助手\\\"],[\\\"助理\\\"],[\\\"机主\\\"],[\\\"主人\\\"],[\\\"拨打\\\"],[\\\"留言\\\"],[\\\"致电\\\"],[\\\"个人业务\\\"],[\\\"公司业务\\\"]]},{\\\"code\\\":\\\"extensionNumberTransfer\\\",\\\"keywords\\\":[[\\\"请输入\\\"],[\\\"分机号\\\"]]}]\",\"predictStopLongPause\":1400,\"enableStreamChat\":true}",
            "createTime": 1791623504808,
            "sequenceId": "33e999c274f34aa9b7081ef69067a235",
            "speaker": "Chatbot",
            "utterance": "您好,语音测试。智能对话机器人为您服务,请问有什么可以帮您?"
        },
        {
            "action": "Dialogue",
            "actionParams": "{\"sipCallId\":\"7447419d-3f2d-1240-4794-00163e0c5f5b\",\"requestId\":\"4623eb2bc2d94522b00431e5baf6a872\",\"conversationId\":\"949aabe1-34cd-4f72-bc1e-7d5ee2b3b8da\",\"isFinalAnswer\":false,\"CallType\":\"Predictive\",\"SYS_VOICE_CONFIG\":\"{\\\"ttsEngine\\\":\\\"bailian\\\",\\\"ttsSpeechRate\\\":0,\\\"ttsPitchRate\\\":0,\\\"ttsVoiceName\\\":\\\"cosyvoice-v3-flash:longanyang\\\",\\\"ttsVolume\\\":50}\",\"callingNumber\":\"1003\",\"k11\":\"v11\",\"invalidSequenceCount\":0,\"channelId\":\"949aabe1-34cd-4f72-bc1e-7d5ee2b3b8da\",\"calledNumber\":\"10031001\",\"shouldUseSandBox\":true}",
            "createTime": 1791623508573,
            "sequenceId": "4623eb2bc2d94522b00431e5baf6a872",
            "speaker": "Customer",
            "utterance": "你是谁呀?"
        },
        {
            "action": "Broadcast",
            "actionParams": "{\"streamEnd\":true,\"isFinalAnswer\":false,\"asrMaxEndSilence\":500,\"asrMaxBeginSilence\":5,\"debugInfo\":\"[{\\\"Input\\\":\\\"你是谁呀?\\\",\\\"NodeType\\\":\\\"invoke_tools\\\",\\\"Output\\\":[{\\\"ToolName\\\":\\\"知识库检索\\\",\\\"ToolResult\\\":[{\\\"Score\\\":\\\"0.8049\\\",\\\"BizKnowType\\\":\\\"FLOW\\\",\\\"Name\\\":\\\"测试\\\"},{\\\"Score\\\":\\\"0.8362\\\",\\\"BizKnowType\\\":\\\"FLOW\\\",\\\"Name\\\":\\\"订酒店_之鑫demo版\\\"}]}]},{\\\"Input\\\":\\\"你是谁呀?\\\",\\\"NodeType\\\":\\\"invoke_tools\\\",\\\"Output\\\":[{\\\"ToolName\\\":\\\"知识库检索\\\",\\\"ToolResult\\\":[]}]}]\",\"interruptible\":true,\"nluResponseType\":\"dialogue\",\"transitionUtterance\":\"\"}",
            "createTime": 1791623508573,
            "sequenceId": "4623eb2bc2d94522b00431e5baf6a872",
            "speaker": "Chatbot",
            "utterance": "您好,我是晓蜜服务助手。。很高兴为您服务,请问有什么可以帮您的?"
        },
        {
            "action": "Dialogue",
            "actionParams": "{\"sipCallId\":\"7447419d-3f2d-1240-4794-00163e0c5f5b\",\"requestId\":\"4a75399c802f4bb8b45f5f5257733a0a\",\"conversationId\":\"949aabe1-34cd-4f72-bc1e-7d5ee2b3b8da\",\"isFinalAnswer\":false,\"CallType\":\"Predictive\",\"callingNumber\":\"1003\",\"k11\":\"v11\",\"invalidSequenceCount\":0,\"channelId\":\"949aabe1-34cd-4f72-bc1e-7d5ee2b3b8da\",\"calledNumber\":\"10031001\",\"shouldUseSandBox\":true}",
            "createTime": 1791623518432,
            "sequenceId": "4a75399c802f4bb8b45f5f5257733a0a",
            "speaker": "Customer",
            "utterance": "你能干嘛?"
        },
        {
            "action": "Broadcast",
            "actionParams": "{\"abortDialogueInfo\":{\"answer\":\"我可以为\",\"sequenceId\":\"4a75399c802f4bb8b45f5f5257733a0a\",\"abortDialogueType\":\"HangUp\"},\"streamEnd\":true,\"isFinalAnswer\":false,\"asrMaxEndSilence\":500,\"asrMaxBeginSilence\":5,\"debugInfo\":\"[{\\\"Input\\\":\\\"你能干嘛?\\\",\\\"NodeType\\\":\\\"invoke_tools\\\",\\\"Output\\\":[{\\\"ToolName\\\":\\\"知识库检索\\\",\\\"ToolResult\\\":[{\\\"Score\\\":\\\"0.7888\\\",\\\"BizKnowType\\\":\\\"FLOW\\\",\\\"Name\\\":\\\"测试\\\"},{\\\"Score\\\":\\\"0.8017\\\",\\\"BizKnowType\\\":\\\"FLOW\\\",\\\"Name\\\":\\\"订酒店_之鑫demo版\\\"}]}]},{\\\"Input\\\":\\\"你能干嘛?\\\",\\\"NodeType\\\":\\\"rewrite_query\\\",\\\"Output\\\":\\\"晓蜜服务助手能做什么?\\\"},{\\\"Input\\\":\\\"你能干嘛?\\\",\\\"NodeType\\\":\\\"invoke_tools\\\",\\\"Output\\\":[{\\\"ToolName\\\":\\\"知识库检索\\\",\\\"ToolResult\\\":[]}]}]\",\"interruptible\":true,\"nluResponseType\":\"dialogue\",\"transitionUtterance\":\"\"}",
            "createTime": 1791623518432,
            "sequenceId": "4a75399c802f4bb8b45f5f5257733a0a",
            "speaker": "Chatbot",
            "utterance": "我可以为您提供产品功能咨询和售后问题解答等服务。如果您有相关疑问,欢迎随时向我提问。"
        },
        {
            "action": "EndDialogue",
            "actionParams": "{\"duration\":16900,\"endTime\":1791623521785,\"hangUpAbnormal\":false,\"hangUpDirection\":\"client\",\"hasLastPlaybackCompleted\":false,\"lastPlaybackAbortType\":\"HangUp\",\"lastPlaybackAnswer\":\"我可以为\",\"lastPlaybackSequenceId\":\"4a75399c802f4bb8b45f5f5257733a0a\",\"startTime\":1791623504885}",
            "createTime": 1791623521830,
            "sequenceId": "ab0c833523ff429e9ece4fe1528c1f49",
            "speaker": "Customer"
        }
  ]
  "duration": 59,                           //通话时长
  "startTime": "2025-11-05T01:51:20.974Z",  //通话开始时间
  "endTime": "2025-11-05T01:51:20.974Z"     //通话结束时间
}

呼叫结果(releaseReason)枚举值

转人工-拒识转人工	7
转人工-命中意图转人工	6
转IVR-拒识转IVR	11
转IVR-命中意图转IVR	10
通话中断-静默超时挂机	3
通话中断-拒识后用户挂机	4
通话中断-用户无理由挂机	5
通话中断-系统异常中断	9
通话中断-拒识后机器人挂机	2
正常完结	1
用户侧无交互	8
未交互用户挂机	13

action枚举值

BeginDialogue:开启会话
Dialogue:对话
SilenceTimeout: 静默超时
EndDialogue:结束会话
CollectedNumber:收号
Broadcast:对话(机器人)
TransferToAgent:转人工(机器人)
HangUp:挂机(机器人)
CollectNumber:收号(机器人)
Error: 异常(机器人)

speaker枚举值

Customer:用户
Chatbot机器人

对话记录显示样例及说明

image

相关录音

机器人播报中被用户打断

utterance表示全部内容(未播报完),abortDialogueInfo.abortDialogueType='Interrupted'时,abortDialogueInfo.answer表示机器人已经播报的部分内容。

示例

{
            "action": "Broadcast",
            "actionParams": "{\"abortDialogueInfo\":{\"answer\":\"您好,语音测试。智能对话机\",\"abortDialogueType\":\"Interrupted\"}}",
            "createTime": 1791623504808,
            "sequenceId": "33e999c274f34aa9b7081ef69067a235",
            "speaker": "Chatbot",
            "utterance": "您好,语音测试。智能对话机器人为您服务,请问有什么可以帮您?"
}

机器人播报中被用户挂机

utterance表示全部内容(未播报完),abortDialogueInfo.abortDialogueType='HangUp'时,abortDialogueInfo.answer表示机器人已经播报的部分内容。

示例

{
            "action": "Broadcast",
            "actionParams": "{\"abortDialogueInfo\":{\"answer\":\"我可以为\",\"sequenceId\":\"4a75399c802f4bb8b45f5f5257733a0a\",\"abortDialogueType\":\"HangUp\"}}",
            "createTime": 1791623518432,
            "sequenceId": "4a75399c802f4bb8b45f5f5257733a0a",
            "speaker": "Chatbot",
            "utterance": "我可以为您提供产品功能咨询和售后问题解答等服务。如果您有相关疑问,欢迎随时向我提问。"
}