<small id="aimcq"></small>
  • # 電商平臺

    # 1、電商平臺企業列表查詢

    1.?接口說明:

    通過接口調用形式查詢電商平臺企業列表

    1.?接口信息:

    a)?請求URL

    http://www.gene-tech.cn/tenantpro/open/getTenantList

    b)?請求方式

    接口通過Http +?post?的形式,通過Http作為協議,post作為傳輸方式

    c)?請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 string 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    token 必選 string token = MD5(unionCode+ts+email+unionKey) unionKey:加密私鑰由智齒提供
    email 必選 string 平臺超管郵箱唯一
    startDate 非必選 string 2018-09-04
    endDate 非必選 string 2018-09-04
    inputStatus 非必選 string 搜索類型:1-商戶企業名稱,2- 商戶聯系賬號,3-商戶超管電話,4-外部id(1,2,3為模糊匹配,4為完全匹配)
    inputValue 非必選 String 對應inputStatus的搜索值
    openStatus 必選 string 商戶狀態:-1:全部,1:開啟 0:停用
    pageNo 非必選 Integer 開始頁
    pageSize 非必選 Integer 每頁展示幾條

    d)?響應參數

    返回示例:

    {
        "pageNo": 1,
        "pageCount": 1,
        "totalCount": 3,
        "pageSize": null,
        "items": [
            {
                "companyId": "3b9577c3ddaa49bda857a0ab8593b7ba",
                "companyName": "青櫻格格02",
                "email": "02@120.com",
                "contactTel": "13100000000",
                "contactName": "",
                "serviceNum": 0,
                "maxServiceCount": 0,
                "createTime": "2018-08-29",
                "endTime": "2099-12-31",
                "tenantStatus": true,
                "appKey": "8748cd7faeb1401ab3d97cf45013afc4",
                "services": null,
                "customerCode": null,
                "customfieldsCode": null,
                "customfieldsName": null,
                "provinceId": null,
                "provinceName": null,
                "cityId": null,
                "cityName": null,
                "areaId": null,
                "areaName": null
            },
            {
                "companyId": "42fb9905aa7f4eff9639d732c9c3aa85",
                "companyName": "還珠格格03",
                "email": "03@120.com",
                "contactTel": "13100000000",
                "contactName": "",
                "serviceNum": 0,
                "maxServiceCount": 0,
                "createTime": "2018-08-29",
                "endTime": "2099-12-31",
                "tenantStatus": false,
                "appKey": "1deb109104334977ae654d3a9096d942",
                "services": null,
                "customerCode": null,
                "customfieldsCode": null,
                "customfieldsName": null,
                "provinceId": null,
                "provinceName": null,
                "cityId": null,
                "cityName": null,
                "areaId": null,
                "areaName": null
            },
            {
                "companyId": "bc0af7e208164b6a8aa83f7722cb22ed",
                "companyName": "青櫻格格01",
                "email": "01@120.com",
                "contactTel": "13100000000",
                "contactName": "",
                "serviceNum": 0,
                "maxServiceCount": 0,
                "createTime": "2018-08-29",
                "endTime": "2099-12-31",
                "tenantStatus": true,
                "appKey": "1d7fe2633d944e459646f4eb0973d0ba",
                "services": null,
                "customerCode": null,
                "customfieldsCode": null,
                "customfieldsName": null,
                "provinceId": null,
                "provinceName": null,
                "cityId": null,
                "cityName": null,
                "areaId": null,
                "areaName": null
            }
    
        ],
    
        "item": null,
        "retCode": "200000",
        "retMsg": "成功"
    
    }
    
    

    # 2、添加企業

    1.接口說明:

    通過接口調用形式添加電商平臺商戶。

    2.接口信息:

    a) 請求URL

    http://www.gene-tech.cn/tenantpro/open/addTenant.json

    b) 請求方式

    接口通過Https + post 的形式,通過Https作為協議,post作為傳輸方式

    c) 請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 String 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    companyName 必選 String 公司名稱
    email 必選 String 客服郵箱,需要保證唯一
    maxCount 必選 Integer 指定最大客服數量
    password 必選 String 客服登錄密碼
    contactName 非必選 String 聯系人
    contactTel 非必選 String 聯系電話
    token 必選 String token = MD5(unionCode+ts+email+unionKey)unionKey:加密私鑰由智齒提供
    customerCode 必選 String 商戶在平臺里面的唯一id
    icon 非必選 String 商戶圖標

    d) 響應參數

    返回示例:

    {
    
        "retCode": "200000",
        "retMsg": "成功!",
        "msg":{
            "appKey": "XXXX",
            "contactName": "聯系人",
            "sysNum" : "xxxx"
        }
    }
    {"retCode":"999999","retMsg":"customerCode已存在!","msg":null}
    {"retCode":"200007","retMsg":"在線客服數量不足","msg":null}
    

    # 3、電商平臺修改企業

    1.接口說明:

    通過接口調用形式修改電商平臺商戶。

    2.接口信息:

    a) 請求URL

    http://www.gene-tech.cn/tenantpro/open/updateTenant.json

    b) 請求方式

    接口通過Https + post 的形式,通過Https作為協議,post作為傳輸方式

    c) 請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 String 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    companyName 必選 String 公司名稱
    maxCount 必選 Integer 指定最大客服數量
    contactName 非必選 String 聯系人
    contactTel 非必選 String 聯系電話
    token 必選 String token = MD5(unionCode+ts+email+unionKey) unionKey:加密私鑰由智齒提供
    customerCode 必選 String 商戶在平臺里面的唯一id
    email 必選 String 商戶的超管郵箱

    d) 響應參數

    返回示例:

    {"retCode":"200000","retMsg":"成功","msg":null}
    {"retCode":"999999","retMsg":"商戶不存在!","msg":null}
    {"retCode":"200007","retMsg":"在線客服數量不足","msg":null}
    

    # 4、添加客服

    1.接口說明:

    通過接口調用形式添加客服。

    2.接口信息:

    a) 請求URL

    http://www.gene-tech.cn/tenantpro/open/addServiceInfoConfim.json

    b) 請求方式

    接口通過Https + post 的形式,通過Https作為協議,post作為傳輸方式

    c) 請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 String 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    token 必選 String token = MD5(unionCode+ts+email+unionKey)unionKey:加密私鑰由智齒提供
    customerCode 必選 String 商戶在平臺里面的唯一id
    nick 必選 String 客服昵稱
    name 必選 String 客服真實姓名
    email 必選 String 客服郵箱,唯一
    roleId 必選 String 客戶角色ID(5555:工單客服、2222:在線管理員、1111:在線客服、8888:工單管理員)
    password 非必選 String 客服密碼

    d) 響應參數

    返回示例:

    {"retCode":"200000","retMsg":"成功","msg":null}
    {"retCode":"999999","retMsg":"商戶不存在!","msg":null}
    {"retCode":"999998","retMsg":"請求失??!登錄已失效,請重新登錄!","msg":null}
    

    # 5、編輯客服

    1.接口說明:

    通過接口調用形式編輯客服。

    2.接口信息:

    a) 請求URL

    http://www.gene-tech.cn/tenantpro/open/updateServiceInfoConfim.json

    b) 請求方式

    接口通過Https + post 的形式,通過Https作為協議,post作為傳輸方式

    c) 請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 String 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    token 必選 String token = MD5(unionCode+ts+email+unionKey)unionKey:加密私鑰由智齒提供
    customerCode 必選 String 商戶在平臺里面的唯一id
    serviceNick 必選 String 客服昵稱
    serviceName 必選 String 客服真實姓名
    phoneNo 必選 Integer 手機號碼
    maxAcceptNum 必選 Integer 坐席接待上限
    email 必選 String 客服郵箱,唯一

    d) 響應參數

    返回示例:

    {"retCode":"200000","retMsg":"成功","msg":null}
    {"retCode":"999999","retMsg":"商戶不存在!","msg":null}
    {"retCode":"999999","retMsg":"客戶郵箱未激活,請激活后再次嘗試修改客戶信息!","msg":null}
    

    # 6、刪除客服

    1.接口說明:

    通過接口形式刪除客服。

    2.接口信息:

    a) 請求URL

    http://www.gene-tech.cn/tenantpro/open/deleteServiceInfoConfim

    b) 請求方式

    接口通過Https + post 的形式,通過Https作為協議,post作為傳輸方式

    c) 請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 String 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    token 必選 String token = MD5(unionCode+ts+email+unionKey)unionKey:加密私鑰由智齒提供
    customerCode 必選 String 商戶在平臺里面的唯一id
    email 必選 String 客服郵箱,唯一

    請求示例:

    {
        "unionCode":"10004",
        "ts":"158934009028",
        "token":"dldnscb2e9c740dba4b75a34d5358802",
        "customerCode":"7",
        "email":"1024011851@qq.com"
    }
    

    d) 響應參數

    返回示例:

    {"retCode":"200000","retMsg":"成功","msg":null}
    {"retCode":"999999","retMsg":"商戶不存在!","msg":null}
    {"retCode":"999999","retMsg":"客戶郵箱未激活,請激活后再次嘗試修改客戶信息!","msg":null}
    

    # 7、客服會話統計查詢接口

    接口說明:

    接口作用:獲取平臺下的所有商戶的所有客服會話統計。

    請求方式:

    POST

    http://ten.sobot.com/tenantpro/tenantReport/tenantExportData

    備注:如需使用接口,需提前聯系客戶經理進行數據整理安排

    請求參數:

    參數 類型 必填 名稱 備注
    unionCode String 平臺id
    ts String 時間戳 時間戳,秒,例如 2019-09-25 15:49:33 的時間戳1569397773
    sign String 簽名 md5(unionCode+unionKey+ts) sign簽名, unionKey為秘鑰
    type String 類型 7 會話統計 8 響應時間統計
    date String 日期 日期(yyyy-MM-dd)

    返回參數:

    參數 類型 必填 名稱 備注
    ret_code String 返回編碼
    ret_msg String 返回信息
    item Object 返回對象

    item對象:

    參數 類型 名稱 備注
    unionCode String 平臺ID
    createTime String 創建時間
    taskType String 任務類型
    resultDate String 日期
    file_path String 文件路徑
    description String 描述

    請求示例:

    {
     	"unionCode":"10004",
        "ts":"1569397773",
        "sign":"dldnscb2e9c740dba4b75a34d5358802",
        "type":"7",
        "date":"2020-01-05"
    }
    

    返回示例:

    
    {
        "item": {
            "filePath":"https://sobot-test.oss-cn-beijing.aliyuncs.com/expo105-1.zip",
            "unionCode":"10004",
            "createTime": "1573027669037",
            "resultDate": "2020-01-05",
            "taskType": "7"
        },
        "ret_code": "000000",
        "ret_msg": "成功"
    }
    

    # 8、客服響應時間統計查詢接口

    接口說明:

    接口作用:獲取平臺下的所有商戶的所有客服響應時間。

    請求方式:

    POST

    http://ten.sobot.com/tenantpro/tenantReport/tenantExportData

    備注:如需使用接口,需提前聯系客戶經理進行數據整理安排

    請求參數:

    參數 類型 必填 名稱 備注
    unionCode String 平臺id
    ts String 時間戳 時間戳,秒,例如 2019-09-25 15:49:33 的時間戳1569397773
    sign String 簽名 md5(unionCode+unionKey+ts) sign簽名, unionKey為秘鑰
    type String 類型 7 會話統計 8 響應時間統計
    date String 日期 日期(yyyy-MM-dd)

    返回參數:

    參數 類型 必填 名稱 備注
    ret_code String 返回編碼
    ret_msg String 返回信息
    item Object 返回對象

    item對象:

    參數 類型 名稱 備注
    unionCode String 平臺ID
    createTime String 創建時間
    taskType String 任務類型
    resultDate String 日期
    filePath String 文件路徑
    description String 描述

    請求示例:

     {
     	"unionCode":"10004",
        "ts":"1569397773",
        "sign":"dldnscb2e9c740dba4b75a34d5358802",
        "type":"7",
        "date":"2020-01-05"
    }
    

    返回示例:

    
    {
        "item": {
            "filePath":"https://sobot-test.oss-cn-beijing.aliyuncs.com/expo105-1.zip",
            "unionCode":"10004",
            "reateTime": "1573027669037",
            "resultDate": "2020-01-05",
            "taskType": "8"
        },
        "ret_code": "000000",
        "ret_msg": "成功"
    }
    

    # 9、批量獲取子商戶appKey信息查詢

    接口說明:

    接口作用:獲取平臺下子商戶的appKey和appId。

    請求方式:

    POST

    請求地址:

    http://www.gene-tech.cn/tenantpro/getBatchAppKey

    請求參數:

    參數 類型 必填 名稱 備注
    unionCode String 平臺id
    ts String 時間戳 時間戳,秒,例如 2019-09-25 15:49:33 的時間戳1569397773
    sign String 簽名 md5(unionCode+unionKey+ts) sign簽名, unionKey為秘鑰

    返回參數:

    參數 類型 必填 名稱 備注
    ret_code String 返回編碼
    ret_msg String 返回信息
    data Object 返回對象
    time String 請求時間

    data 對象:

    參數 類型 名稱 備注
    appId String appId
    appKey String appKey
    companyId String 公司ID
    companyName String 公司名稱

    請求示例:

    {
     	"unionCode":"10004",
        "ts":"1569397773",
        "sign":"dldnscb2e9c740dba4b75a34d5358802"
    }
    

    返回示例:

    {
        "10004": {
            "data": [
                {
                    "appId": "3cb9c7b8dd914621ae3db8bef000d0",
                    "appKey": "d14N6QO9e3p6",
                    "companyId": "be7f05de11a54390c3f3ec35e6010b",
                    "companyName": "測試二號"
                },
                {
                    "appId": "b17989cdf9b2428db63b90672b756015",
                    "appKey": "wJH5gW65e98x",
                    "companyId": "32d5fedaf268441dbde6d3eb23a17cee",
                    "companyName": "測試三號"
                },
                {
                    "appId": "f6bbd4bce5924fde807dbd7ccc17af53",
                    "appKey": "u11zt3o3Q09s",
                    "companyId": "6f77727bdb074a128fc43d8788ee5a09",
                    "companyName": "測試一號"
                },
                {
                    "appId": "f7a989d7cc9a4d3eb1429aca75cd99a7",
                    "appKey": "08q99Y41kDo7",
                    "companyId": "b9fb3a4594634cefa470dbd3f9a21815",
                    "companyName": "主商戶"
                }
            ],
            "time": "2020-04-01 10:39:21"
        },
        "retCode": "000000",
        "retMsg": "操作成功"
    } 
    

    # 10、客服狀態明細接口

    1.接口說明:

    通過接口獲取客服明細狀態列表。

    2.接口信息:

    a) 請求URL

    http://www.gene-tech.cn/tenantpro/coutomer/getStaffLogInfos

    b) 請求方式

    接口通過Https + get的形式,通過Https作為協議,get作為傳輸方式

    c) 請求參數

    字段名 是否必選 數據類型 說明
    unionCode 必選 String 第三方平臺唯一編碼,智齒提供
    ts 必選 long 當前時間戳,用于token的驗證,單位為毫秒
    token 必選 String token = MD5(unionCode+ts+unionKey)unionKey:加密私鑰由智齒提供
    startTime 非必選 long 開始時間,精確到ms 查詢最多查詢一周的數據。前臺傳參分為4種情況: 1)startTime,endTime都不為空時, 如果時間范圍超過1周, 以結束時間為準, 向前推一周重置開始時間; 2)startTime,endTime都為空時, 結束時間為當前時間,開始時間為當前時間向前推一周; 3)startTime不為空了, endTime為空時,結束時間為開始時間向后推一周; 4)startTime為空, endTime不為空時, startTime為endTime向前推一周。
    endTime 非必選 long 結束時間,精確到ms

    d) 響應參數

    返回示例:

    {
        "items":[
            {
                "companyId":"9e73cc58f2f7472d993e6772c250ed99",
                "companyStaffInfos":[
                    {
                        "staffId":"53df8dee9a9e4fdda236faf6351e7a8d",
                        "staffLogInfos":[
                            {
                                "datetime":1571037571921,
                                "datetimeFormat":"2019-10-14 15:19:31",
                                "source":0,
                                "operationAction":"在線"
                            }
                        ]
                    }
                ]
            }
        ],
        "retCode":"200000",
        "retMsg":"成功"
    }
    

    3.響應信息備注:

    items:

    字段名 數據類型 說明
    companyId String 商戶id
    companyStaffInfos List 商戶的客服信息集合

    companyStaffInfos:

    字段名 數據類型 說明
    staffId String 客服id
    staffLogInfos List 此客服日志信息集合

    staffLogInfos:

    字段名 數據類型 說明
    datetime Long 操作時間(時間戳)
    datetimeFormat String 操作時間(格式化后)
    source int 渠道 0-pc,2-app
    operationAction String 客服狀態
    大星彩票 <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <蜘蛛词>| <文本链> <文本链> <文本链> <文本链> <文本链> <文本链>