在线客服

1、接口声明

在调用接口时必须在https请求的header中携带"token"参数。

token是智齿客服接口开放平台全局唯一的接口调用凭据。
开发者在调用各业务接口时都需使用token，开发者需要进行妥善保存。token的存储至少要保留32个字符空间。token的有效期目前为24个小时，需定时刷新，或根据接口返回的token失效提示，进行重新获取。请求token接口，无论token是否存在，都会返回新的token，并重置token的过期时间(目前24小时)。

token使用方式说明：
1、开发者需要统一获取和管理token，在调用智齿客服各个业务开放接 口时都应该使用同一个的token，不应该每个业务都刷新获取新的 token，否则容易导致token失效，影响接口的正常调用；
2、目前token的有效期通过返回的expire_in来传达，目前是86400 秒之内的值。开发者需要根据这个有效时间提前去刷新新token。
3、开发者需要根据接口返回的token失效提示，进行重新获取token。

2、接口调用

2.1、获取访问token编码

接口说明：

获取API开放接口token，此token仅适用于智齿开放平台 5.0版本全部API接口 。API接口中的参数 appid, app_key 请联系智齿售后人员获取。

请求方式：

GET

请求地址：

https://www.sobot.com/api/get_token

请求参数：

返回参数：

item对象：

时间戳转换参考工具：

http://tool.chinaz.com/Tools/unixtime.aspx

sign签名生成示例：

例如，appid = "1"; create_time="1569397773"; app_key="2"

sign = Md5("115693977732") 为 258eec3118705112b2c53dc8043d4d34。

请求示例：

curl https://www.sobot.com/api/get_token?appid=1&create_time=1569397773&sign=258eec3118705112b2c53dc8043d4d34

返回示例：

{
    "item": {
        "token": "4ac37cb2e9c740dba4b75a34d5358802",
        "expires_in": "86400"
    },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

2.2、请求人工客服

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口以用户的身份来发起用户和客服之间的会话请求，并建立会话。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/chat_connect

请求参数：

返回参数：

item对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/chat_connect 
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	 
    "partnerid" : "123",
    "source" : "0",
    "agentid " : "61673ee8d98d4282a95cdad38ffd5f5b ",
    "tran_flag" : "1",
    "params" : "{\"name\":\"lxl\",\"age\":18}",
    "user_tels" : "13778967890;13278907890",
    "user_emails" : "xiaoming@163.com; xiaoming2@163.com",
    "user_img":"https://sobot-www.oss-cn-beijing.aliyuncs.com/001915.JPG",
    "user_name" : "小明"
    }'

返回示例：

{
  "item": {
    "status": "1",
    "visitorid" :"fdd445a5b10f303297752dc3625db648",
    "agent_name" :"在线客服", 
    "agent_face":"https://sobot-www.oss-cn-beijing.aliyuncs.com/6112512332.PNG", 
    "agentid":"61673ee8d98d4282a95cdad38ffd5f5b", 
    "cid":"eca9155a77384d64bb64a132e8459b7e"
  },
  "ret_code": "000000",
  "ret_msg": "成功"
}

2.3、客户咨询客服

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口以用户的身份给客服发送消息。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/chat_send

请求参数：

返回参数：

item对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/chat_send
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d ' {
    "partnerid": "123",
    "content": "https://bbs.sangfor.com.cn/data/attachment/sfchat/image/20687/1571984960.png",
    "msg_type": "image"
} '

返回示例：

{
  "item": {
    "status": "1"
  },
  "ret_code": "000000",
  "ret_msg": "成功"
}

2.4、客服消息推送

接口说明：

接口类型：回调型接口

接口作用：智齿将客服发送给用户的消息推送至企业预先配置好的回调地址上。

参数说明：

消息内容:

请求方式：

POST

类型：

1）用户接入会话：

{
    "sys_code":"2",
    "type":"chat_user_msg",
    "is_encrypt":"false",
    "content":{
        "cid":"a3afd241d1064780a508cbf644fc93bd",
        "agent_name":"在线客服LS186",
        "msgid":"d25f2bfe4f8f4573af5751f6ab61ea70",
        "agent_face":"https://sobot-test.oss-cn-beijing.aliyuncs.com/co2.PNG",
        "partnerid":"222",
        "msg_code":"200",
        "params":{
            "name":"xiaoming",
            "age":18
        }
    }
}

2）用户收到排队位置变更：

{
    "sys_code":"2",
    "type":"chat_user_msg",
    "is_encrypt":"false",
    "content":{
        "cid":"a3afd241d1064780a508cbf644fc93bd",
        "msg_code":"201",
        "count":"3",
        "msgid":"5646d04350e84f689ca855153c58c0f9",
        "partnerid":"222",
        "params":"{'name':'xiaoming','age': 18}"
    }
}

3）用户收到客服发送的消息：

{
    "sys_code":"2",
    "type":"chat_user_msg",
    "isEncrypt":"false",
    "content":{
        "cid":"a3afd241d1064780a508cbf644fc93bd",
        "msg":"222",
        "agent_name":"在线客服LS186",
        "msgid":"ab48f1e755ac766d8732501a3ef1a1161573465172716",
        "msg_type":"text",
        "agent_face":"https://sobot-test.oss-cn-beijing.aliyuncs.com/co12332.PNG",
        "partnerid":"222",
        "msg_code":"202",
        "params":""
    }
}

4）客户离线

{
    "sys_code":"2",
    "type":"chat_user_msg",
    "is_encrypt":"false",
    "content":{
        "cid":"a3afd241d1064780a508cbf644fc93bd",
        "msg_code":"204",
        "msgid":"eda5990841fc4f42a8a1ea5ef731a0c6",
        "partnerid":"222",
        "params":""
    }
}

5）客户收到客服邀请评价的消息

{
    "sys_code":"2",
    "type":"chat_user_msg",
    "is_encrypt":"false",
    "content":{
        "agentid":"61673ee8d98d4282a95cdad38ffd5f5b",
        "msg_code":"209",
        "agent_name":"在线客服LS186",
        "msgid":"68bab5d926334703a8a8c790aa99dd03",
        "partnerid":"222",
        "params":{
            "name":"xiaoming",
            "age":18
        },
        "cid":"83766ca85b3a4159b05b00b82dc12197"
    }
}

2.5、客户评价

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口执行用户对会话进行满意度评价。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/comment

请求参数：

返回参数：

item对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/comment 
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{
    "partnerid" : "123", 
    "type" : "1", 
    "solved" : "1"
   }'

返回示例：

{
"item": {
    "status":"1",
    "cid":" eca9155a77384d64bb64a132e8459b7e" 
    },
"ret_code": "000000",
"ret_msg": "成功"
}

2.6、客户结束会话

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来结束某个用户当前的会话。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/out

请求参数：

返回参数：

item对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/out
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	  
    "partnerid" : "123"
}'

返回示例：

{
    "item": {
        "status":"1"
    },
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.7、查询离线消息数据

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来获取会话已经结束后，客服发送给用户的消息（即离线消息）。开放平台接口对接的用户，由于所有消息都会推送到消息地址中，没有离线消息数据。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/offline_msg_data

请求参数：

返回参数：

item对象：

msg_data对象：

msg_list对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/offline_msg_data
-X POST 
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	  
"visitorid" : "xx"
}'

返回示例：

{
    "item": {
        "size": 2,
        "msg_data":[
        		 {
       		 "sender ": " 61673ee8d98d4282a95cdad38ffd5f5b",
        	 "sender_name": "在线客服",
  			 "sender_face":" https://sobot-www.oss-cn-beijing.aliyuncs.com/console/2512332.PNG",
       		 "msg_list": [
         			 {
                        "cid": "c36d04f18b4e48eaa88e7a5c93212a0a",
                        "msg": "111",
                        "ts": "2019-10-31 19:13:57"
                    },
                    {
                        "cid": "c36d04f18b4e48eaa88e7a5c93212a0a",
                        "msg": "222",
                        "ts": "2019-10-31 19:13:59"
                    }
       			 ]
     		 }
   		 ]
    },
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.8、查询客户会话列表

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来获取某个用户在系统中的会话记录列表（cid列表）。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/query_cids

请求参数：

返回参数：

items对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/query_cids
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	  
       "visitorid" : "xx"
}'

返回示例：

{
    "items": [
        {
            "cid": "825a57e755a240559e03deec267e6463",
            "start_date_time": 1568603119126,
            "visitorid": "7f27b999bbe94274ab1a738568aba137"
        },
        {
            "cid": "1874cbc483b64d4b9f1b7f06de083638",
            "start_date_time": 1568613840540,
            "visitorid": "7f27b999bbe94274ab1a738568aba137"
        }    
],
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.9、查询客户会话记录

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来获取某条会话的详细会话记录。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/get_detail_by_cid

请求参数：

说明：1)cid,visitorid,partnerid+from为三种查询模式，优先级为：cid>visitorid>partnerid+from;

2)传入visitorid或者partnerid+from时，表示查询用户的最后一次会话记录。

返回参数：

items对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/get_detail_by_cid
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	  
    "cid" : "49142902cfa74f2d9af8e7c1b546221d",
    "name_flag" : "1"
    }'

返回示例：

 {
    "items": [{
            "cid": "49142902cfa74f2d9af8e7c1b546221d",
            "msg":"<img src='http://bbs.sangfor.com.cn/data/attachment/sfchat/image/201910/154687/1571984960.png' class='webchat_img_upload upNowImg uploadedFile' />",
            "msg_type": 1,
            "msgid": "ab221eb4fbde4ea0b9fa728448470503",
            "receiver": "61673ee8d98d4282a95cdad38ffd5f5b",
            "receiver_name": "在线客服",
            "receiver_type": 2,
            "sender": "fdd445a5b10f303297752dc3625db648",
                "sender_face": "https://sobot-www.oss-cn-beijing.aliyuncs.com/console/7e20834c439748c780ca9648ca6c0cde/userImage/2016120715001915.JPG",
            "sender_name": "小明",
            "sender_type": 0,
            "t": "1572514382820",
            "ts": "2019-10-31 17:33:02"            
        }],
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.10、查询客服上下班时间

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来获取某个在线客服组当前是否处于系统设置的上班时间或下 班时间。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/admin_is_work

请求参数：

返回参数：

item对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/admin_is_work
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	  
    "groupid" : "1d89fad9e31d4498b1196f7580666e52"
    }'

返回示例：

{
    "item": {
        "is_work": "true"

    },
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.11、查询客服实时数据

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来获取当前登录的在线客服的列表以及状态等信息。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/get_once_data

请求参数：无

返回参数：

item对象：

admin_list对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/get_once_data
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 

返回示例：

{
    "item": {
        "wait_user_size": 0,
        "admin_size": 1,
        "online_user_size": 0,
        "robot_user_size": 0,
        "admin_list": [
            {
                "agentid": "61673ee8d98d4282a95cdad38ffd5f5b",
                "status_code": 0,
                "agent_name": "真是改了名字了",
                "agent_email": "123456@123.com",
                "group_name": [
                    "销售",
                    "售后",
                    "售前"
                ],
                "groupid": [
                    "c4a3a9b8bc5742079d57d154ef2e2cc2",
                    "ef06c796d2b64218afc511dab1cd1283",
                    "a457f4dfe92842f8a11d1616c1c58dc1"
                ],
                "count": 0,
                "agent_face": "https://sobot-www.oss-cn-beijing.aliyuncs.com/console/7e2512332.PNG",
                "remark": "hello",
                "max_count": 10,
                "service_no": "1",
                "status_time": "06:53:56",
                "agent_nick": "在线客服",
                "status": 1
            }
        ]
    },
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.12、查询在线技能组列表

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来查询当前系统下所有在线客服技能组的详情。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/query_group

请求参数：无

返回参数：

items对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/query_group
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 

返回示例：

 {
    "items": [{
        "groupid" : "c4a3a9b8bc5742079d57d154ef2e2cc2",
        "group_name" : "售前",
        "create_time" : "1540176885"
    }],
    "ret_code": "000000",
    "ret_msg": "成功"
}

2.13、查询在线客服列表

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来查询当前系统下所有在线客服的详情。

请求方式：

POST

请求地址：

https://www.sobot.com/api/chat/5/user/query_agent

请求参数：无

返回参数：

items对象：

请求示例：

curl https://www.sobot.com/api/chat/5/user/query_agent
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 

返回示例：

{
    "agent_email": "123456@123.com",
    "agent_name": "在线客服",
    "agent_no": "1",
    "agent_status": "启用",
    "agentid": "61673ee8d98d4282a95cdad38ffd5f5b",
    "create_time": "2016-04-19",
    "department_name": "总公司",
    "group_name":  [
            "销售",
            "售后",
            "售前"
        ],
    "groupid": [
        "c4a3a9b8bc5742079d57d154ef2e2cc2",
        "ef06c796d2b64218afc511dab1cd1283",
        "a457f4dfe92842f8a11d1616c1c58dc1"
    ],
    "role_name": "超级管理员"
}

2.14、查询服务总结记录

接口说明：

接口类型：主动调用接口

接口作用：可通过调用该接口来获取服务总结记录。

请求方式：

POST

请求地址：

https://www.sobot.com/api/wb/5/data/query_summary

请求参数：

返回参数：

item对象：

fields对象：

请求示例：

curl https://www.sobot.com/api/wb/5/data/query_summary
-X POST 
-H 'content-type:application/json'
-H 'token: 4ac37cb2e9c740dba4b75a34d5358802' 
-d '{	  
"cid": "xx"
}'

返回示例：

{
    "item": {
            "cid": "3cd40201989943df8cd1ed845efcb043",
            "summary_flag": "1",
            "operation_name": "业务单元",
            "req_type_name": "业务类型1,业务类型2",
            "summary_staff_name": "客服1",
            "question_status": "1",
            "question_description": "问题描述",
            "fields": [
            {
            "fieldid": "28f002c873c344d9a8f9b3606830dfbb",
            "field_name": "业务单元字段1",
            "field_value": "值1"
            },
            {
            "fieldid": "9b9086c5bed84016af5adf273d41110e",
            "field_name": "业务单元字段2",
            "field_value": "值2"
            }
            ],
            "invalid_session": "0",
            "update_time": "1554716281854"
        },
    "ret_code": "000000",
    "ret_msg": "操作成功"
}

2.15、单点登录接口

更新说明：

接口已经移动至开发指南\通用模块\单点登录中。

3、在线消息转发

该功能消息格式为json格式；实时消息推送配置将在次日凌晨零点开始生效。同公司同类型的数据，缓存20条打包发送一次，不足20条时每1秒打包发送一次。

实时消息推送需要客户提供数据接收接口，例如 https://xxxxxxx.xxxxxx.com/sobot/message,所有的类型的数据使用相同的地址。

消息转发接口，增加可以加密后再传递，可以联系您的客户经理，设置开通后，可以在消息转发时header中增加三个参数：时间戳（取服务器时间）、随机码、sign（MD5加密，32位 小写）)；客户取到参数后解码对比，正确接收数据，错误时返回错误码。

header中参数

请求示例

curl https://xxxxxxx.xxxxxx.com/sobot/message
-X POST 
-H 'X-Log-TimeStamp: 1609224926723'
-H 'X-Log-RandomCode: 635'
-H 'X-Log-Sign: 9ba80f40bc5e6fd404648ea15aa4f7fa'

3.1在线会话消息

3.1.1 content对象

注：唯一主键 cid,各表通过cid关联，表示同一个会话

3.1.2 请求参数

3.1.3 请求报文样例

{ 
  "sys_code":"21",
    "type":"conversation",
    "content":[
        {
            "companyid":"5cc2c708202d4defaf72d4bcac362a55",
            "cid":"86937e82ae244ad59aeefe41af731079",
            "source":"2",
            "start_time":"1468826506677",
            "partnerid":"1907281202433341",
            "end_time":"1468827002400",
            "first_response_time":"1468827002400",
            "transfer_tohuman_time":"1468826506677",
            "conversation_duration":"495723",
            "staff_emails":"11122221@foxmail.com",
            "staff_name":"路人丁",
            "consult_robot_msg_count":"3",
            "robot_reply_msg_count":"20",
            "consult_staff_msg_count":"0",
            "staff_reply_msg_count":"0",
            "transfer_human_succ_flag":"1",
            "queue_time":"0",
            "session_queue_state":"2",
            "ip":"60.18.150.38",
            "area":"辽宁",
            "os":"8",
            "visitorid":"837213545777846",
            "lastgroupid":"35980200f279438b952f8dc3d5731f85",
            "lastgroup_name":"客服组",
            "human_valid_flag":"1",
            "human_invalid_flag":"0",
            "human_invalid_recep_flag":"0",
            "human_valid_recep_flag":"0",
            "human_recep_flag":"1",
            "robot_invalid_flag":"0",
            "robot_valid_flag":"1",
            "offline_type":"1",
            "access_human_time":"1584806400000",
            "robotid": "1234",
            "robot_alias": "test_alias",
            "robot_name": "机器人小明",
            "staffids":"3695089d031c409380073081aaa73c7d,733e9edabb5c4158b095198aec58a890,3ff11cb243b540f78f8274f84b289920",
            "invite_evaluation_flags":"0,1,1",
            "channel_flag": "d720fe0e97ac427183c65b59f82c061f",
            "channel_name": "Android - 正式",
            "response_duration": "0",
            "response_count": "0",
            "response_avg": "0",
            "session_human_duration": "0",
            "asHuman_interactive_count": "0",
            "search_engine": "1",
            "land_page_url": "http://www.sobot.com",
            "land_page_title": "【官网】智齿科技-智齿客服 | 在线客服系统_云呼叫中心_智能客服机器人_智能外呼",
            "conversation_page_url": "http://www.sobot.com", 
            "conversation_page_title": "【官网】智齿科技-智齿客服 | 在线客服系统_云呼叫中心_智能客服机器人_智能外呼",
            "search_word": "客服"
        }
    ]
}

3.2在线评价消息

3.2.1 content对象

注：唯一主键（cid+is_robot）

3.2.2 请求参数

3.2.3 请求报文样例

{
    "sys_code":"21",
    "type":"evaluation",
    "content":[
        {
            "companyid":"5cc2c708202d4defaf72d4bcac362a55",
            "staffid":"9517",
            "source":"10",
            "admin_name":"",
            "is_robot":"1",
            "remark":"意向用户可跟",
            "tag":"答非所问,问题不能回答",
            "score":"2",
            "visitorid":"97b31cba87e04dcdafe0ebb60248ecf4",
            "date_time":"1468340203266",
            "cid":"9ae05bc279544b68895cd86b12e418e0",
            "comment_type":"1",
            "solved":"1"
        }
    ]
}

3.3在线访客信息

3.3.1content对象

注：唯一主键 userid

3.3.2 请求参数

3.3.3 请求报文样例

{
    "type":"user",
    "sys_code":"21",
    "content":[
        {
            "companyid":"5cc2c708202d4defaf72d4bcac362a55",
            "userid":"837213545777846",
            "img":"https://img.sobot.com/console/common/face/user.png", 
            "nick":"招商王", 
            "source":"10", 
            "enterprise_name":"",
            "user_tels":"13545777846",
            "user_emails":"506003007@qq.com",
            "qq":"784383358",
            "partnerid":"13545777846",
            "user_name":"孙盼",
            "province_name":"山东", 
            "city_name":"", 
            "area_name":"",
            "remark":"",
            "params":{
                "KUID":"MTU2NjY0MzE1NTAwMDA3MTAz",
                "cookie":"88a484e052f1455a8706213cd41c4c94"
            },
            "serviceid":"ea6f8d1a5e8846fd8dfce4ab7057c45c", 
            "cid":"86937e82ae244ad59aeefe41af731079",
        }
    ]
}

3.4在线客户信息

3.4.1content对象

3.4.2 请求参数

3.4.3 请求报文样例

{
    "sys_code":"21",
    "type":"userinfo",
    "content":[
        {
            "companyid":"5cc2c708202d4defaf72d4bcac362a55",
            "userid":"837213545777846",
            "img":"https://img.sobot.com/console/common/face/user.png",
            "nick":"招商王",
            "source":"10",
            "enterprise_name":"",
            "user_tels":"13545777846",
            "user_emails":"13545777846@foxmail.com",
            "user_name":"孙盼",
            "province_name":"山东",
            "city_name":"",
            "area_name":"",
            "remark":"意向用户可跟",
            "visitorids":"",
            "service_no":"1011",
            "serviceid":"ea6f8d1a5e8846fd8dfce4ab7057c45c",
            "cid":"bcfb6853edc446c0a4305692b9daf6c8",
            "result_list":[

            ]
        }
    ]
}

3.5在线聊天消息

3.5.1content对象

注： 唯一主键cid+ timems +senderid，机器人和人工可分别评价。

3.5.2 请求参数

3.5.3 请求报文样例

{
    "sys_code":"21",
    "type":"msg",
    "content":[
        {
            "companyid":"5cc2c708202sasad2f72d4bcac362a55",
            "cid":"44c603626e2e4c82a5a49619a8aaa397",
            "format_time":"2017-11-01 12:24:04",
            "timems":"1509510244000",
            "senderid":"33c603626e434c82a5a49619aadde451",
            "sender_name":"冯建武",
            "receiverid":"25e603626e434c82a5a49619aaqw345",
            "receiver_name":"胡丽静",
            "msg":"到还款日，延期3天怎么算",
            "docid":"88c5342f51134db58ea59f430ad16939",
            "doc_name":"来张图片",
            "sender_type":"0",
            "receiver_type":"2",
            "msg_offline":"0"
        }
    ]
}

3.6在线服务总结

3.6.1content 对象

3.6.2 请求参数

3.6.3 请求报文样例

{
    "sys_code":"21",
    "type":"summary",
    "content":[
        {
            "chat_start_time":"1577779079941",
            "group_name":"test",
            "groupid":"ab900e0cea3f4247981631a7bdb0c694",
            "summary_status":"1",
            "field_name":[
                "字段1",
                "字段2"
            ],
            "operation_name":"",
            "update_staff_name":"毛怪",
            "companyid":"7f72b9c5dee8425fba152a216e528cd4",
            "update_time":"1577779099437",
            "invalid_flag":"0",
            "operationid":"1577330071201",
            "field_value":[
                "qweqeqw",
                "eqweqwe"
            ],
            "req_type_name":"手机-电脑",
            "req_type":"1577330173970-1577330182339",
            "update_staffId":"132dd5ef52b44dc3931f181980c61276",
            "cid":"dfdc8f4dfaab44bbb463a5f8960a4cc7",
            "visitorid":"d7a05991e58c35f1dede477a04205f92",
            "summary_description":"qeqe",
            "fieldid":[
                "3fc247578a294a3297a7418d521974fd",
                "39303cc831c641ad93a5f0757cce69d7"
            ]
        }
    ]
}

3.7消息转发加密

基于在线用户消息和在线访客消息接口，智齿提供加密功能。

3.7.1 加密条件

需要联系智齿对应支撑人员，在智齿统一的业务支撑管理系统中开启加密设置项（先提供消息接收地址），并获取智齿提供的“密钥”进行解密操作，开启设置项后当晚12:00之后开始进行消息主动推送

3.7.2 加密方式

采用 AES/CBC/ZeroPadding加密

3.7.3 加密范围

开启加密设置项后，加密范围目前为：在线用户消息、在线访客消息接口；type类型为：user及userinfo；加密内容为content字段。

3.7.4 加密示例

{
    "type":"user",
    "sys_code":"21",
    "content": " 0PKeYX9heDTiqE8Bi+sFBO9Id1OUvJCw9Okk0j9D/qhKvUyH2wbb61ggyCpO4czYzFvi0S0rrGuMTyYzr5mfwdcnq3nbG8QaZSzHDa3KbFcfF4QGPKU8NU5BvIv6EyU3Ul6KeZ3+ITG6jCD8MxqGE/WcIF1+t213iS1kEyz32TCLXsrrVpFRwz5oMRosaqjuLaofXCKSVSJbo3+/a+I7RQXDM+BYaLAyKn6dyYMTfbEnLCQCx+unkr2KPy2bnr03vGLdYPvNjusXuqitJb1YgToSqw/BfMOtwEjSrjlImtIGpnDtk7yrqxdbf4vF8Q5pPCuMJ65o8z6lwmceznXi/ZHpmDOc4LhSxNF5w5yUlCyjAGFgqe9VzpjsBjHhbNIAKZlMXMI6c5Z3S4p0nDKLfBXZum3PK7A1miyFpqlGbO6MURpU2HF8G3ZJL2woDaWbSrmFMNxjLH8h8KOZTOcYgr9/ptbeHjrA3bIsVDRa8hQ="
}

4、错误编码

4.1、操作成功

业务操作成功。

4.2、系统异常

系统服务异常。

4.3、业务异常

业务异常。