5 历史会话还原

5.1 根据会话ID查询整个历史会话

  • 接口地址
/v10/tenants/{tenantId}/session-history/robots/{robotId}/playback/from/sessionId
  • 接口请求示例
curl -X GET \
  http://robot.easemob.com/v10/tenants/9/session-history/robots/6819571e-2f03-49ea-a962-0019fbc0301c/playback/from/sessionId?sessionId=fe46b354-1a74-4890-bc65-cbe4ca42865b&page=0&size=10 \
  -H 'token: eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJjaGl4aWFveXUyMTFAMTYzLmNvbSIsImlzcyI6ImVhc2Vtb2Itcm9ib3QiLCJ0ZW5hbnRJZCI6OSwiZXhwIjoxNTIyMjM3ODk1LCJpYXQiOjE1MjE2MzMwOTUsInVzZXJJZCI6IjFmYmNhNjE5LTZlMWItNDg2Yi1hOTdhLWE4MDc0ZjRlNzIxMSIsImp0aSI6IjJmZDkzOWM1LWFkNDUtNGVjMS04MzFhLTk1NzRhMDYzODg1NSIsInVzZXJuYW1lIjoiY2hpeGlhb3l1MjExQDE2My5jb20ifQ.BXVLRTwe1IzWHrCZVTNQauJFQQMneYiMr5NeCRYHc68'
  • 请求参数说明
tenantId:租户id
robotId:机器人id
sessionId:会话id
page:页码(0为第一页)
size:页面数据条数
  • 接口返回的ResponseBody
{
    "status": "OK",
    "errorCode": null,
    "errorDescription": null,
    "entity": [{
        "docId": "acec298e-7e5f-4377-9ddb-c8eb13340e17",
        "msgId": "363346f4-919f-4409-accf-7cf8a15bbb87",
        "tenantId": 9,
        "userId": "robot-plugin-visitor-af6d9ed8-30e6-4a77-a870-3c9e3016fc10",
        "robotId": "6819571e-2f03-49ea-a962-0019fbc0301c",
        "knowledgeId": null,
        "questionType": "TEXT",
        "question": "图片呢",
        "sessionId": "dd3fc870-94b2-4383-a98e-822434005a39",
        "answerMediaType": "img",
        "answerSourceType": "RULE",
        "robotResponseBody": {
            "size": {
                "width": 1038,
                "height": 972
            },
            "url": "/v10/tenants/9/material/medias/e1654503-28b4-4c0f-8cf2-022ba8b325a2/stream",
            "filename": "屏幕快照 2018-03-23 下午4.17.50.png",
            "type": "img"
        },
        "answerMatchType": "BEST_ANSWER",
        "createDateTime": 1522138281240,
        "timestamp": 1522138281240
    }, {
        "docId": "777b6d4f-954e-41bd-88ec-7ad83ceee3ca",
        "msgId": "4e73e45d-015f-4728-9277-dfa4e1958aa3",
        "tenantId": 9,
        "userId": "robot-plugin-visitor-af6d9ed8-30e6-4a77-a870-3c9e3016fc10",
        "robotId": "6819571e-2f03-49ea-a962-0019fbc0301c",
        "knowledgeId": null,
        "questionType": "TEXT",
        "question": "图文",
        "sessionId": "dd3fc870-94b2-4383-a98e-822434005a39",
        "answerMediaType": "news",
        "answerSourceType": "RULE",
        "robotResponseBody": {
            "articles": [{
                "title": "图文测试",
                "digest": "是否就是看回放身份上课就是否开始时间可否很快就是否精神焕发",
                "description": "是否就是看回放身份上课就是否开始时间可否很快就是否精神焕发",
                "url": "https://robot.easemob.com/v10/tenants/9/material/news/articles/7ee6ce80-b7e9-4811-aba5-7b7f1749c604/html",
                "thumbUrl": "https://robot.easemob.com/v1/Tenant/9/MediaFiles/c050e106-e221-4f64-9c37-6e709e057324",
                "picurl": "https://robot.easemob.com/v1/Tenant/9/MediaFiles/c050e106-e221-4f64-9c37-6e709e057324",
                "createdTime": 1516017613000,
                "date": "2018-01-15 20:00:13"
            }],
            "type": "news"
        },
        "answerMatchType": "BEST_ANSWER",
        "createDateTime": 1522138261067,
        "timestamp": 1522138261067
    }, {
        "docId": "e4bfb0aa-b9da-4501-852d-f3dc896278e5",
        "msgId": "10546266-b080-47c7-a514-2fa953d67404",
        "tenantId": 9,
        "userId": "robot-plugin-visitor-af6d9ed8-30e6-4a77-a870-3c9e3016fc10",
        "robotId": "6819571e-2f03-49ea-a962-0019fbc0301c",
        "knowledgeId": null,
        "questionType": "TEXT",
        "question": "测试菜单",
        "sessionId": "dd3fc870-94b2-4383-a98e-822434005a39",
        "answerMediaType": "menu",
        "answerSourceType": "RULE",
        "robotResponseBody": {
            "texts": [{
                "knowledgeId": "e519ab18-2f02-4f85-a40c-7d7018a6a1b7",
                "text": "第一级菜单"
            }],
            "title": "",
            "titile": "",
            "type": "menu"
        },
        "answerMatchType": "BEST_ANSWER",
        "createDateTime": 1522138251355,
        "timestamp": 1522138251355
    }, {
        "docId": "a87d5bb1-b878-4e7f-a6a2-9b43d7d081d3",
        "msgId": "594898ae-1ab3-4c0d-b4b6-fc2680fa594c",
        "tenantId": 9,
        "userId": "robot-plugin-visitor-af6d9ed8-30e6-4a77-a870-3c9e3016fc10",
        "robotId": "6819571e-2f03-49ea-a962-0019fbc0301c",
        "knowledgeId": null,
        "questionType": "TEXT",
        "question": "问题1",
        "sessionId": "dd3fc870-94b2-4383-a98e-822434005a39",
        "answerMediaType": "txt",
        "answerSourceType": "RULE",
        "robotResponseBody": {
            "msg": "还是否开始",
            "type": "txt"
        },
        "answerMatchType": "BEST_ANSWER",
        "createDateTime": 1522138218328,
        "timestamp": 1522138218328
    }],
    "first": null,
    "last": null,
    "size": null,
    "number": null,
    "numberOfElements": null,
    "totalPages": null,
    "totalElements": null
}
  • 接口返回参数说明
msgId:消息id
tenantId:租户id
userId:访客id
robotId:机器人id
knowledgeId:知识规则id
questionType:问题类型(TEXT:文本;)
question:问题
sessionId:会话id
answerMediaType:答案类型(txt:文本;img:图片;news:图文;menu:菜单)
answerSourceType:答案来源(DEFAULT:默认回复;FREECHAT:闲聊;INTENTION:意图识别;HUMAN_FIRST_ROUND:首次转出服务;HUMAN:转出服务;RULE:知识规则;MENU:菜单;RECOMMENDATE:推荐问题)
answerMatchType:答案匹配类型(DEFAULT:默认回复;BEST_ANSWER:最佳匹配答案;RECOMMENDATE_QUESTIONS:推荐问题;REPEAT:重复问题;SENSITIVE_WORD_INTERCEPTION:敏感词拦截)
robotResponseBody{
    msg:答案
    type:答案类型(txt:文本;img:图片;news:图文;menu:菜单)
}
createDateTime:创建时间
  • 注意
    • 每种消息类型解析请参照 "1.4 问答接口返回消息格式" 进行解析