客服消息转发

1、消息相关描述

这几类消息都是以会话消息为基准,其他消息通过会话cid来关联.消息的发送的顺序一般是,先是用户消息,然后聊天消息,再是会话消息(会话结束才发),最后是评价消息.用户信息有修改消息会重复发一次.消息每次批量发50条,如果无数据则按照时间1秒发一次.

2、会话消息

2.1接口要求

Post方法,接收智齿科技发送过来的Json格式消息,在客户的服务器上部署.例如https://xxxxxxx.xxxxxx.com/sobot/message,建议所有的消息使用同一个地址。

2.2测试调用地址

无

2.3入参

会话的Json格式如下表所示：

唯一主键：cid,各个表之间使用cid来关联,表示是同一个会话

2.4入参举例

入参示例如下所示：

{

   "type": "conversation",

   "content": [

       {

           "companyId": "5cc2c708202d4defaf72d4bcac362a55",

           "cid": "86937e82ae244ad59aeefe41af731079",

           "source": 2,

           "startTime": 1468826506677,

           "EndTime": 1468827002400,

           "conversationDuration": 495723,

           "staffEmail": "",

           "staffName": "robot",

           "chatWithRobotMsgCount": 1,

           "robotReplyMsgCount": 1,

           "chatWithStaffMsgCount": 0,

           "staffReplyMsgCount": 0,

           "is2Human": 1,

           "is2HumanSucc": 1,

           "queueTime": -1,

           "ip": "60.18.150.38",

           "area": "辽宁",

           "os": "8",

           "visitorId": "837213545777846"

       }

   ]

}

2.5出参

成功返回空字符串,报错返回错误信息.

3、聊天消息

3.1接口要求

Post方法,接收智齿科技发送过来的Json格式消息,在客户的服务器上部署.例如https://xxxxxxx.xxxxxx.com/sobot/message,建议所有的消息使用同一个地址。

3.2测试调用地址

无

3.3 入参

聊天消息Json格式如下表所示

唯一主键：cid+ time+ senderName机器人和人工可分别评价

3.4入参举例

入参示例如下所示：

{

"type": "msg",

"content": \[

    {

        "companyId": "5cc2c708202d4defaf72d4bcac362a55",

        "cid": "44c603626e2e4c82a5a49619a8aaa397",

        "time": "2016-07-18 15:30:16",

        "senderName": "冯建武",

        "receiverName": null,

        "msg": "到还款日，延期3天怎么算"

    }

\]

}

3.5出参

成功返回空字符串,报错返回错误信息.

4、评价信息

4.1接口要求

Post方法,接收智齿科技发送过来的Json格式消息,在客户的服务器上部署.例如https://xxxxxxx.xxxxxx.com/sobot/message,建议所有的消息使用同一个地址。

4.2测试调用地址

无

4.3入参

聊天消息Json格式如下表所示：

唯一主键：cid+ isRobot机器人和人工可分别评价

4.4入参举例

入参示例如下所示：

{

"type": "evaluation",

"content": \[

    {

        "companyId": "5cc2c708202d4defaf72d4bcac362a55",

        "staffId": "9517",

        "source": 0,

        "adminName": null,

        "isRobot": true,

        "remark": "审核没通过",

        "tag": "答非所问,问题不能回答",

        "score": 0,

        "visitorId": "97b31cba87e04dcdafe0ebb60248ecf4",

        "datetime": 1468340203266,

        "cid": "9ae05bc279544b68895cd86b12e418e0"

    }

\]

}

4.5出参

成功返回空字符串,报错返回错误信息.

5、用户信息

5.1接口要求

Post方法,接收智齿科技发送过来的Json格式消息,在客户的服务器上部署.例如https://xxxxxxx.xxxxxx.com/sobot/message,建议所有的消息使用同一个地址。

5.2测试调用地址

无

5.3入参

用户Json格式如下表所示：

唯一主键：userId

5.4入参举例

入参示例如下所示：

{

   "type": "user",

   "content": [

       {

           "companyId": "5cc2c708202d4defaf72d4bcac362a55",

           "userId": "837213545777846",

           "cid": "86937e82ae244ad59aeefe41af731079",

           "telphone": "13545777846",

           "email": "506003007@qq.com",

           "qq": "",

           "partnerId": "13545777846",

           "userName": "孙盼",

           "remark": "",

           "params": {

               "a": "动态参数"

           }

       }

   ]

}

5.5出参

成功返回空字符串,报错返回错误信息.

6、转接等系统信息

6.1接口要求

Post方法,接收智齿科技发送过来的Json格式消息,在客户的服务器上部署.例如https://xxxxxxx.xxxxxx.com/sobot/message,建议所有的消息使用同一个地址。

6.2测试调用地址

无

6.3测试调用地址

无

6.4入参

与机器人建立会话 type=4 sender是用户

{"cid":"75029a0997cd412bbe403e727c961f69","companyId":"7ce3cd52355e4f359cf44017b051d1e8","sender":"f731fa6f1ca8a8d8a09ff90bffb56321","senderName":"北京用户","ts":"2017-05-27 00:01:50","type":4}

开始转人工 type=6 sender是用户

{"cid":"d09cbb9dfc0c4d059757b226d6aef801","companyId":"045769553fb744c6a8cb57bb676b3261","sender":"4193c96879c442898bf1ff4010c90cbe","senderName":"北京用户","ts":"2017-05-27 01:28:53","type":6}

转人工排队开始 type=7 sender是用户

{"cid":"6757a500c82e4c5c874ec9242c07322a","companyId":"e42bd9b6fc23472b93f44a5c5fa720ff","sender":"e42bd9b6fc23472b93f44a5c5fa720ff13835700152","senderName":"北京用户","ts":"2017-05-27 08:06:18","type":7}

客服主动邀请客服（不管客服是否是忙碌状态）type=21 sender是客服

{"cid":"19c417aabe4c44b6b1a49868b664bcf8","companyId":"b96b3e57c0814d9d987bd21efc7c5934","senderEmail":"309867471@qq.com","receiver":"6cdd081e5c95d38d4b9870b9e2e79c9b","receiverName":"北京用户","sender":"dbbf139219204b14bfe5d47ceafbd980","senderName":"丹丹","ts":"2017-05-27 09:03:13","type":21}

与人工建立会话 type=8 sender是用户，receiver是客服

{"cid":"252025b1fdbc4f629023378be497883f","companyId":"7923","receiverEmail":"xieyusong@bianfeng.com","receiver":"9518","receiverName":"客服2","sender":"5b93f5a0a6f04b0dbd219e3228ab2a65","senderName":"北京用户","ts":"2017-03-28 00:41:05","type":8}

客服sender把userId转接客服receiver type=9 （不管客服是否是忙碌状态，都是成功的）

{"cid":"77a49f6f90334b1abb2158b76c1b7b13","companyId":"a3820569819f44649d4e6367a21d2f19","receiver":"662a20a1a57d4db79b70d7721c00d9b3","receiverName":"必要客服6042","receiverEmail":"432432@qq.com"，"sender":"6ac0a00ddb794b5f8e69e6a38b95be58","senderEmail":"534577@qq.com","senderName":"6104","ts":"2017-03-28 00:00:23","userId":"a3820569819f44649d4e6367a21d2f193059308","userName":"北京用户","type":9}

6.5入参举例

入参示例如下所示：

{

"type": "systemMsg",

"content": \[

    {

        "cid": "75029a0997cd412bbe403e727c961f69",

        "companyId": "7ce3cd52355e4f359cf44017b051d1e8",

        "sender": "f731fa6f1ca8a8d8a09ff90bffb56321",

        "senderName": "北京用户",

        "ts": "2017-05-27 00:01:50",

        "type": 4

    },

    {

        "cid": "d09cbb9dfc0c4d059757b226d6aef801",

        "companyId": "045769553fb744c6a8cb57bb676b3261",

        "sender": "4193c96879c442898bf1ff4010c90cbe",

        "senderName": "北京用户",

        "ts": "2017-05-27 01:28:53",

        "type": 6

    },

    {

        "cid": "6757a500c82e4c5c874ec9242c07322a",

        "companyId": "e42bd9b6fc23472b93f44a5c5fa720ff",

        "sender": "e42bd9b6fc23472b93f44a5c5fa720ff13835700152",

        "senderName": "北京用户",

        "ts": "2017-05-27 08:06:18",

        "type": 7

    },

    {

        "cid": "19c417aabe4c44b6b1a49868b664bcf8",

        "companyId": "b96b3e57c0814d9d987bd21efc7c5934",

        "senderEmail": "309867471@qq.com",

        "receiver": "6cdd081e5c95d38d4b9870b9e2e79c9b",

        "receiverName": "北京用户",

        "sender": "dbbf139219204b14bfe5d47ceafbd980",

        "senderName": "丹丹",

        "ts": "2017-05-27 09:03:13",

        "type": 21

    },

    {

        "cid": "252025b1fdbc4f629023378be497883f",

        "companyId": "7923",

        "receiverEmail": "xieyusong@bianfeng.com",

        "receiver": "9518",

        "receiverName": "客服2",

        "sender": "5b93f5a0a6f04b0dbd219e3228ab2a65",

        "senderName": "北京用户",

        "ts": "2017-03-28 00:41:05",

        "type": 8

    },

    {

        "cid": "77a49f6f90334b1abb2158b76c1b7b13",

        "companyId": "a3820569819f44649d4e6367a21d2f19",

        "receiver": "662a20a1a57d4db79b70d7721c00d9b3",

        "receiverName": "必要客服6042",

        "receiverEmail": "432432@qq.com",

        "sender": "6ac0a00ddb794b5f8e69e6a38b95be58",

        "senderEmail": "534577@qq.com",

        "senderName": "6104",

        "ts": "2017-03-28 00:00:23",

        "userId": "a3820569819f44649d4e6367a21d2f193059308",

        "userName": "北京用户",

        "type": 9

    }

\]

}

7、通话记录

7.1接口要求

Post方法,接收智齿科技发送过来的Json格式消息,在客户的服务器上部署.例如https://xxxxxxx.xxxxxx.com/sobot/message,建议所有的消息使用同一个地址。

7.2 测试调用地址

无

8.4 入参举例

入参示例如下所示：

{

    "type": "user",

    "content": [

        {

            "companyId": "5cc2c708202d4defaf72d4bcac362a55",

            "userId": "837213545777846",

            "img": "https://XXXX",

            "nick": "小明",

            "source": 1,

            "enterpriseName": "公司",

            "tel": "13545777846",

            "email": "45522332@qq.com",

            "uname": "XXX",

"qq": "XXX",

"remark": "XXX",

"proviceName": "北京市",

"cityName": "北京市",

         "areaName": "海淀区",

         "visitorIds": "XX",

         "serviceNo": "XX",

            "resultList": [

 {

                  "fieldId": "1",

             "fieldType": 1,

 "text": "",

 "title": "微信",

"value": "21332112",

                         "fieldVariable":"weixin"

 },

{

                  "fieldId": "4",

             "fieldType": 6,

 "text": "下拉一",

 "title": "下拉列表",

"value": "500862697708553",

                         "fieldVariable":"customField1"

 }

]

        }

    ]

}

10、接口定义

数据具体是用post方法在body中发送出去,注意收到数据后先做缓存,另外一个线程(或者进程)来负责入库,否则会影响发送数据的速度.

11、转发策略

http 设置10秒超时,每次转发10条消息,如果到1秒也会转发一次,没消息不转发.如果转发失败,重试一次,重试失败则丢掉.如果发现丢消息严重的情况联系技术把某段时间的消息重发.

12、存储设计注意事项

注意每个消息说明时都有一个主键,主要用来判重,因为有重试机制,消息可能会被发多次,设计表示注意设置unique index(或者类似的判断唯一标准)