文档中心 > 基础技术

千牛消息去淘宝Nick改造

更新时间:2023/04/04 访问次数:13959

一、总体改造说明


应隐私保护合规要求,保障消费者的隐私,需要对千牛相关的应用进行消费者Nick下线处理。

整体盘点千牛相关涉及此次去NICK改造的板块包含:千牛插件、千牛小程序两个核心板块的应用。


二、改造内容


1. 后续不再提供服务使用的相关API接口下线,服务商需要从自己功能上REVIEW和处理解除对待下线API的依赖;

2. 目前对外包含Nick的API,新增SecurityUID和BizDomain 用于替代Nick做用户身份为一识别(PS:改造和兼容阶段,涉及入参的API请暂时保留NICK入参字段,统一下线NICK时间关注后续平台公告)

3. 后续不再提供服务使用的相关事件下线,服务商需要从自己功能上REVIEW和处理解除对待下线事件的依赖;

4. 目前对外提供服务包含NICK的相关事件下,新增SecurityUID 用于替代Nick做用户身份为一识别。


核心改造细节:

1)原参数里带nick的,都准备下线,不允许做核心链路串流程使用,老nick字段完成新老替换后即刻下线;

2)用SecurityUID+BizDomain替换原来的nick;

3)SecurityUID的定义 ,三方指ISV,OpenUID;

4)兼容期过后,新版本SecurityUID+bizDomain(如果有)将替换原nick为必选字段;

5)改造和兼容阶段,涉及入参的API请务必暂时保留NICK入参字段,否则老版本客户端将无法兼容;

6)具体改造涉及API,事件实例等内容描述详见如下文档,请服务商参考文档说明进行系统调整和适配改造。


调试客户端:https://download.alicdn.com/wangwang/qianniu_(9.09.20N).exe


三、千牛插件容器(H5)

1. 下线API (请仔细排查是否有在使用,如果有请安排下线,禁止使用


id

type

code

eventName

37

category

pcww.jiaoyiguanli

orderRemarks

38

category

pcww.jiaoyiguanli

priceChange

39

category

pcww.jiaoyiguanli

postageFree

40

category

pcww.jiaoyiguanli

checkLogistics

48

module

module_wangwang.chat

suggestIntelligentReply

51

category

pc.cuxiaoguanli

sendCoupons

55

category

pcww.cuxiaoguanli

sendCouponsByWW

96

module

module_component.crm_label

crmLabel

115

module

module_wangwang.chat

getTradeFocus

116

module

module_wangwang.chat

chat

122

module

module_wangwang.chat

setContactReaded

114

module

module_wangwang.chat

getContactInfo

120

module

module_wangwang.chat

openHistoryMsg

121

module

module_wangwang.chat

sendMsg

206

category

pcww.jiaoyiguanli

remindPay

207

category

pcww.shangpinguanli

itemToUser

362

module

module_wangwang.chat

getChatContactList

399

module

module_component.select_ent_employee

selectEnterpriseEmployee

448

module

module_wangwang.chat

getLiveActiveUser

pc.21817572

alingCallout


2. API改动


1)交易列表 (tradeList)


15

category

pc.jiaoyiguanli

tradeList


入参


改动说明

参数名

必传

类型

示例

描述


tradeStatus

enum

WAIT_SELLER_SEND_GOODS

交易状态,默认查询所有交易状态的数据,除了默认值外每次只能查询一种状态。 可选值: WAIT_BUYER_PAY(等待买家付款) WAIT_SELLER_SEND_GOODS(等待卖家发货,即:买家已付款) WAIT_BUYER_CONFIRM_GOODS(等待买家确认收货,即:卖家已发货) TRADE_FINISHED(交易成功) TRADE_CLOSED(交易关闭) TRADE_REFUND(退款中)

即将下线

buyerNick

string

zhangsan

买家nick


startCreated

string

2000-01-01 00:00:00

查询起始时间

endCreated

string

2001-01-01 00:00:00

查询结束时间

新增

securityUID

string

AAHBuE68ABXJalyTEL2cIqWI

用户安全UID, 二方为加密UID,三方为openUID


调用示例


QN.app.invoke({
      api:'tradeList',
      query:{
                tradeStatus : 'WAIT_SELLER_SEND_GOODS'  ,
                    buyerNick : 'zhangsan'  ,
                    securityUID:'sadjflkjaslkfdsljakf',
                    startCreated : '2000-01-01 00:00:00'  ,
                    endCreated : '2001-01-01 00:00:00'  
            
      }
}).then(result => {
    console.log(result);
}, error => {
    console.log(error);
});
    


2)核对地址 (checkAddress)


36

category

pcww.jiaoyiguanli

checkAddress


入参


改动说明

参数名

必传

类型

示例

描述

即将下线

chatNick

string

cntaobao测试账号

此操作针对的目标的长ID,插件当前页面数据如果不为此ID,需要先进行数据更新,再执行API操作。

新增

securityUID

兼容期后是

当前阶段否

string

AAHBuE68ABXJalyTEL2cIqWI

用户安全UID, 二方为加密UID,三方为openUID

新增

bizDomain

兼容期后是

当前阶段否

string

taobao

账号域信息

taobao:淘宝域

cbu:1688域

hotkey

string

{"fsModifiers":4,"vk":81}

通过千牛快捷键调用此API时,会传入此参数。后续插件调用选择订单组件时,需要将此参数透传给组件。

tid

string

1256195350418401

要执行核对地址的目标订单号


调用示例


QN.application.invoke( {
        cmd : 'checkAddress',
        param : {
                                        chatNick : 'cntaobao测试账号',
                                        securityUID: 'ceshizhanghaoOpenUID',
          bizDomain:'taobao',
                                            hotkey : '{"fsModifiers":4,"vk":81}'  ,
                                            tid : '1256195350418401'  
                            
        }
});


3)打开聊天记录 (openChatRecord)


151

appkey

pc.23052006

openChatRecord


入参


改动说明

参数名

必传

类型

示例

描述

即将下线

employeeNick

string

测试账号

员工昵称,如果不传取当前免登用户

即将下线

customerNick

后期会下线,请用

customerSecurityUID

string

测试账号

客户昵称 customerNick 和 employeeNick 二选一

不带cntaobao前缀

start

string

2013-04-01

开始时间

end

string

2014-04-01

结束时间

新增

customerSecurityUID

string

customerSecurityUID

客户昵称 customerNick 和 employeeNick 二选一 用户安全UID, 二方为加密UID,三方为openUID


调用示例


QN.application.invoke( {
        cmd : 'openChatRecord',
        param : {
                                        employeeNick : 'nick'  ,
                                            customerNick : '测试账号'  ,
                                            start : '2013-04-01'  ,
                                            end : '2014-04-01'  ,
                                            customerSecurityUID : 'customerSecurityUID'  ,
                            
        }
});


4)打开选择订单组件 (selectOrder)


入参


改动说明

参数名

必传

类型

示例

描述

兼容期过后,将下线

chatNick

string

卖家账号

// 不带有cntaobao前缀的nick

hotkey

string

hotkey

// 透传API调用中的hotkey字段

tradeList

string

[{"created":"2014-06-16 20:19:05","pic_path":"http:\/\/img02.taobaocdn.com\/bao\/uploaded\/i2\/T1iYa9FJhaXXXXXXXX_!!0-item_pic.jpg","title":"测试宝贝 请不要","status":"WAIT_BUYER_PAY","tid":696470982139825},{"created":"2014-06-16 20:19:05","pic_path":"http:\/\/img02.taobaocdn.com\/bao\/uploaded\/i2\/T1iYa9FJhaXXXXXXXX_!!0-item_pic.jpg","title":"测试宝贝 请不要拍","status":"WAIT_BUYER_PAY","tid":6964270982139825}]

// tradeList为json对象数组格式化后的字符串,数据由插件根据页面缓存的数据进行组装,组件负责显示与选择的交互。


返回结果


{"tid":1.234567891E10}


属性名

类型

示例

描述

tid

number

12345678910

订单ID


5)打开旺旺聊天窗 (openChat)


入参


改动说明

参数名

必传

类型

示例

描述

即将下线

nick

string

cntaobao商家测试账号

聊天的对象的nick,nick前请带上nick域, 所属域可选值为:cntaobao|cnalichn|enaliint cntaobao 是淘宝用户 cnalichn 是中文站用户 enaliint 是国际站用户

新增

bizDomain

string

taobao

【目前为兼容老端,实际为必填字段】 对方聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

sceneParam

string

{"toRole":"buyer"}

场景信息,json格式,默认为空身份为买家。 当前亮灯对象为买家时: {"toRole":"buyer"} 当前亮灯对象为卖家时: {"toRole":"seller"} 注意: 1.买家:buyer 触达消费者场景,消息会话在手淘,买旺等消费者端透出(即对方如果在手淘上可以收到消息)。 2.卖家:seller 触达商家场景,消息会话不支持 在手淘,买旺消费端透出,在千牛商家端透出(即对方如果在手淘上收不到消息)。

新增

securityUID

string

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】 对方聊天账号的加密UID


调用示例


QN.application.invoke( {
        cmd : 'openChat',
        param : {
                                        nick : 'cntaobao商家测试账号'  ,
                                            bizDomain : 'taobao'  ,
                                            sceneParam : '{"toRole":"buyer"}'  ,
                                            securityUID : '安全UID,三方为openUID,二方为加密UID'  
                            
        }
});


6)获取显示名(displayNick) (getDisplayNick)


入参


改动说明

参数名

必传

类型

示例

描述

即将下线

uids

string

["cntaobaokli001","cntaobao寺原"]

snick数组

新增

securityUIDs

string

{"security1":"taobao", "security2":"taobao"}

json字符串,内部为map<key, value>形式,key为securityUID,用户安全UID,二方加密UID三方openUID,value为bizDomain,用户聊天域,支持taobao、cub两种


返回结果


{"dnickFromSecurityUIDs":"{\"securityUID1\":\"客户展示名1\",\"security2\":\"寺原\"}","dnicks":"{\"cntaobaokli001\":\"kli001\",\"cntaobao寺原\":\"寺原\"}"}


改动说明

属性名

类型

示例

描述

即将下线

dnicks

string

{"cntaobaokli001":"kli001","cntaobao寺原":"寺原"}

查询sinck对应的displaynick. 类型是一个key-value的map

新增

dnickFromSecurityUIDs

string

{"securityUID1":"客户展示名1","security2":"寺原"}

查询securityUID对应的displaynick. 类型是一个key-value的map


调用示例


QN.application.invoke( {
        cmd : 'getDisplayNick',
        param : {
                                        uids : '["cntaobaokli001","cntaobao寺原"]'  ,
                                            securityUIDs : '{"security1":"taobao", "security2":"taobao"}'  
                            
        },
        error : function(msg, cmd, param) {
           // 调用失败
        },
        success : function(rsp, cmd, param) {
           // 回调结果
        }
        
});


7)获取当前聊天对象 (getActiveUser)


入参


参数名

必传

类型

示例

描述


返回结果


{"uid":"cntaobaoUserNick","securityUID":"securityUID","bizDomain":"taobao"}


改动说明

属性名

类型

示例

描述

即将下线

uid

string

cntaobaoUserNick

用户nick

新增

bizDomain

string

taobao

当前聊天对象的聊天域 taobao 或 cbu

新增

securityUID

string

securityUID

当前聊天对象的安全UID,二方加密uid,三方openuid


调用示例


QN.application.invoke( {
        cmd : 'getActiveUser',
        param : {
                        
        },
        error : function(msg, cmd, param) {
           // 调用失败
        },
        success : function(rsp, cmd, param) {
           // 回调结果
        }
        
});


8)打开旺旺插件 (openWWPlugin)


入参


参数名

必传

类型

示例

描述

appkey

string

4272

插件的appkey,和category之间必须填一个。只有插件为group类型,并且与调用方为同一个appkey时,才允许通过appkey直接调用。

category

string

shangpinguanli

插槽类目,和appkey之间必须填一个,如果都存在,category优先appkey

event

string

customEvent

打开插件时透传event参数

新增内容参数

param

string

{\"securityUID\":\"xxxxxxaaAAss\"\"bizDomain\":\"taobao\",\"chatNick\":\"cntaobao白金店主\"}


打开插件时透传param参数,其中必需带securityUID(二方加密UID,三方OpenUID),bizDomain(账号聊天域,支持taobao、cbu)参数,chatNick参数【

即将下线】【兼容期,兼容期过后废弃】。


调用示例


QN.application.invoke( {
        cmd : 'openWWPlugin',
        param : {
                                        appkey : '4272'  ,
                                            category : 'shangpinguanli'  ,
                                            event : 'customEvent'  ,
                                            param : '{\"securityUID\":\"xxxxxxaaAAss\"\"bizDomain\":\"taobao\",\"chatNick\":\"cntaobao白金店主\"}'  
                            
        }
});


9)向输入框插入文字 (insertText2Inputbox)


入参


改动说明

参数名

必传

类型

示例

描述

即将下线

uid

string

cntaobaoTestID

指定插入文字的聊天对象

text

string

\\C0xff0000\\S0xf\\FCourier New\\Thello world!/:^_^

聊天内容

type

number

1

0 表示普通文本 1 表示富文本 关于向旺旺输入框插入富文本串的特别说明: 每一段富文本以【\T文字内容】结束,目前开放的可修饰的控制符: \C 颜色0xff00ff,以<蓝绿红>的顺序标识,如蓝色:\C0xff0000 \S 字体大小,如10号字体:\S0xa \F 字体,如:\F微软雅黑, \FCourier New \B 黑体 \I 斜体 \U 下划线 \N 用于分隔富文本 '\n'可以直接用于换行 \T 作为一段富文本的结束,\T后跟文字或系统默认表情,如:\Thello/:^_^ \B,\I,\U,如果不主动设置取消,标识后续的文字都会保持这个格式。取消的方式是再次设置同样的标识,例如:\B\T这是粗体\B\T这是取消后的细体,\B\T这是粗体\I\T这是继承了粗体的粗斜体。 注意点:由于js中以字符串字面值来支持富文本格式化串,反斜杠需要用'\\'来表示。

新增

securityUID

string

xxxxxxxxxx

用户安全UID,二方为加密uid,三方为openuid

新增

bizDomain

string

taobao

用户聊天域信息 taobao、cbu


调用示例


QN.application.invoke( {
        cmd : 'insertText2Inputbox',
        param : {
                                        uid : 'cntaobaoTestID'  ,
                                            text : '\\C0xff0000\\S0xf\\FCourier New\\Thello world!/:^_^'  ,
                                            type : 1  ,
                                            securityUID : 'xxxxxxxxxx'  ,
                                            bizDomain : 'taobao'  
                            
        }
});


3. 事件改动

1)wangwang.active_contact_changed


改动说明

参数名

值/返回值

备注

eventId

wangwang.active_contact_changed

旺旺聊天焦点用户切换

对于旺旺插件,如果不监听,每次切换旺旺联系人将刷新callback_url,用户感受延迟体验不好,并造成ISV后台压力。

强烈建议使用监听该事件的方式来做,但需要保证内存不泄漏。

新增内容返回

data

{

'newContact':xxx,

'oldContact':xxx

'newContactNumberId':

'oldContactNumberId':

'oldContactSecurityUID':

newContactSecurityUID

}

参数:

原:

即将下线string newContact; // 当单聊会话时,为用户NICK,隐私合规(22年8月)后,将不返回数据切勿强依赖使用。 当是群是为群ID

即将下线string oldContact; // 当单聊会话时,为用户NICK,隐私合规(22年8月)后,将不返回数据切勿强依赖使用。 当是群是为群ID

string

即将下线newContactNumberId; // 群或者联系人数字ID 隐私合规(22年8月)后,将不返回数据切勿强依赖使用。

string

即将下线oldContactNumberId; // 群或者联系人数字ID 隐私合规(22年8月)后,将不返回数据切勿强依赖使用。

新增参数:

string

新增字段oldContactSecurityUID: 插件标识联系人UID, 当单聊时为安全标识联系人UID,当群聊时为群ID

string

新增字段newContactSecurityUID:插件标识联系人UID, 当单聊时为安全标识联系人UID,当群聊时为群ID

msg(reg)

msg(unreg)


2)wangwang.contact_joined 联系人列表中加入新的接入人


是否改动

参数名

值/返回值

备注

eventId

wangwang.contact_joined

联系人列表中加入新的接入人

新增部分内容

data

{

'contact':"新接入的联系人"

'uid'

'securityUID'

}

新增字段

securityUID:新加入的联系人安全UID,二方为加密UID,三方为OpenUID

即将下线

contact

即将下线

uid

msg(reg)

msg(unreg)


4. 下线事件(请仔细排查是否有在使用,如果有请安排下线,禁止使用


事件名

备注

wangwang.active_live_contact_changed

直播联系人变化

wangwang.trade_focus

wangwang.contact_closed

wangwang.recvmsgurl.itemid


四、千牛小程序(windmill)容器

1. 下线API(请仔细排查是否有在使用,如果有请安排下线,禁止使用



2. API改动

1)my.qn.imInsertText2Inputbox


插入消息到IM输入框。


入参

Object 类型,属性如下:


改动说明

属性

类型

是否必须

说明

即将下线

uid

String

[目前阶段:nick,securityUID,

bizDomain,均为必填字段

隐私保护系统上线全量期(待官方通知):

此字段废除,新逻辑务必使用securityUID和bizDomain]

指定插入文字的聊天对象

新增

bizDomain

String

taobao

【目前为兼容老端,实际为必填字段】 对方聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】 对方聊天账号的加密UID

type

Int

0 表示普通文本 1 表示富文本

success

Function

调用成功的回调函数

fail

Function

调用失败的回调函数

complete

Function

调用结束的回调函数(调用成功、失败都会执行)


调用示例

my.qn.imInsertText2Inputbox({
      uid:"cntaobao陌环",
    bizDomain:"taobao",
    securityUID:"asdfasdfdsafds",
    text:"我是测试内容",
    type:0,
    success: (res) => {
       console.log(JSON.stringify(res))
    },
    fail: (res) => {
       console.log(JSON.stringify(res))
    }
});


2)my.qn.imInsertImage2Inputbox


功能描述插入图片到IM输入框。

参数/返回值


改动说明

名称

类型

是否必填,默认值

描述

参数

即将下线

uid

String

[目前阶段:nick,securityUID,

bizDomain,均为必填字段

隐私保护系统上线全量期(待官方通知):

此字段废除,新逻辑务必使用securityUID和bizDomain]

指定插入文字的聊天对象

新增

bizDomain

String

taobao

【目前为兼容老端,实际为必填字段】 对方聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】 对方聊天账号的加密UID

apFilePath

String

图片伪路径,由其他小程序API生成

返回值





调用示例


my.saveImage({
  url: 'https://img.alicdn.com/tfs/TB1_uT8a5ERMeJjSspiXXbZLFXa-143-59.png',
  success: (res) => {
    console.log(res)
    my.qn.imInsertImage2Inputbox({
      uid: 'cnalichnalikjj',      // 昵称
      bizDomain:"taobao",
      securityUID:"asdfasdfdsafds",
      apFilePath: res.apFilePath, // 伪路径
      success: (res) => {
        console.log(res) // {success: true}
      },
    })
  },
});


3)my.qn.imGetActiveUser


功能描述获取当前IM旺旺联系人。

参数/返回值


改动说明

名称

类型

是否必填,默认值

描述

参数

/




返回值

即将下线

user_nick

String


[目前阶段:nick,securityUID,

bizDomain,均为必填字段

隐私保护系统上线全量期(待官方通知):

此字段废除,新逻辑务必使用securityUID和bizDomain]

当前旺旺聊天的对方联系人昵称

新增

bizDomain

String

taobao

【目前为兼容老端,实际为必填字段】 当前聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】 当前聊天账号的加密UID


调用示例


my.qn.imGetActiveUser({
  success: (res) => {
      console.log(res)  // {"user_nick":"cntaobaoXXX","securityUID":"xxxxx", "bizDomain":"taobao"} 
  },
})


4)my.qn.openSOPTransferWindow


打开客服sop任务转交窗口。


入参

Object 类型,属性如下:


属性

类型

是否必须

说明

即将下线

contactid

string

[目前阶段:nick,securityUID,
bizDomain,均为必填字段
隐私保护系统上线全量期(待官方通知):
此字段废除,新逻辑务必使用securityUID和bizDomain]

联系人id, 带站点信息

新增

bizDomain

String


taobao

【目前为兼容老端,实际为必填字段】 联系人聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String


安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】 联系人聊天账号的加密UID

metaid

String


任务 metaid


调用示例


 my.qn.openSOPTransferWindow({
          contactid:"cntaobaotest",
          metaid:"123123",
          securityUID:"xx",
          bizDomain:"taobao",
          success: (res) => {
            this.setData({ btnText: '成功:' +JSON.stringify(res)})
                        },
          fail: (error) => {
            this.setData({ btnText: '失败:' + JSON.stringify(error)});
          },
      });


5)my.qn.openSOPDealWindow


打开客服sop任务处理窗口。

入参

Object 类型,属性如下:


属性

类型

是否必须

说明

即将下线

contactid

string

联系人id, 带站点信息

新增

bizDomain

String

taobao

【目前为兼容老端,实际为必填字段】 联系人聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】 联系人聊天账号的加密UID

metaid

string

任务 metaid

taskid

string

任务 taskid


调用示例


 my.qn.openSOPDealWindow({
          contactid:"cntaobaotest",
          metaid:"123123",
          taskid:"656565",
   securityUID:"xx",
   bizDomain:"taobao",
          success: (res) => {
            this.setData({ btnText: '成功:' +JSON.stringify(res)})
                        },
          fail: (error) => {
            this.setData({ btnText: '失败:' + JSON.stringify(error)});
          },
      });


6)my.qn.openChat


打开聊天窗口并输入待发送的信息。


属性

类型

必填

描述

即将下线

nick

String

是[目前阶段:nick,uid,bizDomain,均为必填字段隐私保护系统上线全量期(待官方通知):此字段废除,新逻辑务必使用uid和bizDomain]

聊天对象的nick,含站点名称,例如cntaobaoXXX(淘宝),chalichnYYY(中文站)等等

text

String


待发送的信息。如果聊天框里已有内容,会追加到光标处(如果焦点正在输入框)或追加到最后。

新增

securityUID

String


二方为加密UID,三方为OpenUID

新增

bizDomain

String


聊天对象的账号域,目前只支持"taobao", "cbu"

sceneParam

String


场景信息,jsonString,默认为空身份为买家。当前亮灯对象为买家时:{"toRole":"buyer"}当前亮灯对象为卖家时:{"toRole":"seller"} 注意:1.买家:buyer触达消费者场景,消息会话在手淘,买旺等消费者端透出(即对方如果在手淘上可以收到消息)。2.卖家:seller触达商家场景,消息会话不支持在手淘,买旺消费端透出,在千牛商家端透出(即对方如果在手淘上收不到消息)。


调用示


// 打开聊天窗口并输入待发送的信息
my.qn.openChat({
  nick: 'cnalichnalikjj', // 昵称,要带站点
  text: 'hello',          // 信息,可选
  securityUID:'alikjj的加密UID',
  bizDomain:'taobao',
  success: (res) => {
    console.log(res); // {success: true}
  },
  fail: (res) => {
    console.log(res); // {errorMessage: "nick 错误", error: 3}
  },
});


7)私有协议 - my.qn.OpenChatEx


打开群聊聊天窗口并可以回复或定位到消息,只支持群聊。


改动说明

参数名

必传

类型

示例

描述

chatId

string

0_G_2674567688_1544087053580

聊天会话ID

chatType

string

0

0:为手淘群(目前仅支持)

msgContent

string

被回复消息内容

被回复消息内容,如果为文本,填写文本内容,其他类型填“”

msgId

string

61788855855

被回复消息ID

msgType

string

101

被回复消息类型

sendUid

string

1234568

被回复消息的发送者数字ID

语义改变

为用户展示名称,仅用于展示。

sendNick

string

devtest

被回复消息发送者的展示名称

needReplyMsg

string

1

0为不需要填充回复,非0填充

needLocateMsg

string

1

0为不定位消息,非0定位


8)my.qn.isInputboxEmpty


功能描述判断指定会话输入框内容是否为空。

入参

名称

类型

是否必传

描述

即将下线

uid

String

[目前阶段:nick,securityUID,

bizDomain,均为必填字段

隐私保护系统上线全量期(待官方通知):

此字段废除,新逻辑务必使用securityUID和bizDomain]

买家nick

新增

bizDomain

String

taobao

【目前为兼容老端,实际为必填字段】 买家聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】买家聊天账号的加密UID


出参


名称

类型

描述

isEmpty

Boolean

是否当前指定买家聊天输入框是否有内容


调用示例


my.qn.isInputboxEmpty({
  uid:"cntaobao商家测试账号",
  securityUID:"xx",
  bizDomain:"taobao",
  success: (res) => {
    console.log(res);
  },
  fail: (res) => {
   console.log(res);
  },
})


9)my.qn.imGetCurrentChatImages


功能描述获取当前会话中的聊天图片,返回最近的最多10张图片地址和用户nick。调用者还需要对nick做校验。

参数/返回值


名称

类型

是否必填,默认值

描述

参数




返回值

success

bool

是否调用成功

即将下线

nick

String

[目前阶段:nick,securityUID,

bizDomain,均为必填字段

隐私保护系统上线全量期(待官方通知):

此字段废除,新逻辑务必使用securityUID和bizDomain]

用户的nick

新增

bizDomain

String

taobao

【目前为兼容老端,实际为必填字段】 买家聊天域的信息,目前支持 taobao、cbu两种,taobao:淘宝域,cbu 1688域

新增

securityUID

String

安全UID,三方为openUID,二方为加密UID

安全UID,三方为openUID,二方为加密UID 【目前为兼容老端,实际为必填字段】买家聊天账号的加密UID

data

String

返回的聊天图片数组,最多10张


调用示例


  my.qn.imGetCurrentChatImages({
      success: (res) => {
        console.log(res) //{"data":"[\"https://img.alicdn.com/imgextra/xxxxxxxxxxxx.jpg\"]","nick":"xxxxxxxx","success":true}
      },
    })


10)my.qn.openWWPlugin


打开旺旺插件通用API。(仅提供给二方使用)预览体验。

入参

Object 类型,属性如下:

改动说明

属性

类型

是否必须

说明

appkey

String


需要打开插件的appkey

pageName

String


打开插件后跳转的页面(功能)

新增内容key

param

String


对应传递给小程序(插件)的参数, json字符串格式 {\"securityUID\":\"xxxxxxaaAAss\"\"bizDomain\":\"taobao\",\"chatNick\":\"cntaobao白金店主\"}打开插件时透传param参数,其中必需带securityUID(二方加密UID,三方OpenUID),bizDomain(账号聊天域,支持taobao、cbu)参数,
即将下线 chatNick参数【兼容期,兼容期过后废弃】。

success

Function


调用成功的回调函数

fail

Function


调用失败的回调函数

complete

Function


调用结束的回调函数(调用成功、失败都会执行)


调用示


my.qn.openWWPlugin({
    appkey:"",
    pageName:"千牛通用协议名 会带入到url参数中",
    param:"{\"chatNick\":\"cntaobao王东炜199108\"}"
    success: (res) => {
     console.log(JSON.stringify(res))
    },
    fail: (res) => {
     console.log(JSON.stringify(res))
    }
});


11)my.qn.openWWCategory


打开千牛插件协议槽。


Object 类型,属性如下:


改动说明

属性

类型

是否必须

说明

category

String

插槽名(如 jiaoyiguanli/shangpinguanli/huiyuanguanli等)

pageName

String

千牛通用协议名 会带入到url参数中

新增内容key

param

String

对应传递给小程序(插件)的参数, json字符串格式

{\"securityUID\":\"xxxxxxaaAAss\"\"bizDomain\":\"taobao\",\"chatNick\":\"cntaobao白金店主\"}
打开插件时透传param参数,其中必需带securityUID(二方加密UID,三方OpenUID),bizDomain(账号聊天域,支持taobao、cbu)参数

即将下线chatNick参数【兼容期,兼容期过后废弃】。

success

Function

调用成功的回调函数

fail

Function

调用失败的回调函数

complete

Function

调用结束的回调函数(调用成功、失败都会执行)


调用示例


my.qn.openWWCategory({
    category:"jiaoyiguanli", //千牛插件的插槽
    pageName:"千牛通用协议名 会带入到url参数中",
    param:"{\"chatNick\":\"cntaobao白金店主\", \"securityUID\":\"\",\"bizDomain\":\"\"}",
   success: (res) => {
     console.log(JSON.stringify(res))
    },
    fail: (res) => {
     console.log(JSON.stringify(res))
    }
});


3. 下线事件(请仔细排查是否有在使用,如果有请安排下线,禁止使用,兼容期过后平台侧将不在返回数据


以下事件均下线如果有调用,请安排下线。

事件形式:my.qn.onXXXXXXXX

attachWndClose

qtaskChanged",

tradeInfo",

itemInfo",

refundInfo",

qtaskInfo",

taskInfo",

imRecvU2UMsgBatch",

imContactJoined",

imContactClosed",

imTradeFocus",

imRecvMsgUrlItemId",

imFbtOptions",

pluginUpdate",

imActiveLiveContactChanged",

serviceLiveStatusChanged",

getServiceLiveStatusFinish",

serviceLivePushflowInterface"。


4. 事件改动

1)my.qn.onImActiveContactChanged


联系人切换。原插件事件 wangwang.active_contact_changed(不支持工作台小程序)。


改动说明

参数名

值/返回值

备注

新增内容返回

data

{

'newContact':xxx,

'oldContact':xxx

'newContactNumberId':

'oldContactNumberId':

'oldContactSecurityUID':

newContactSecurityUID

}

参数:

原:

即将下线

string newContact; // 当单聊会话时,为用户NICK,隐私合规(22年8月)后,将不返回数据切勿强依赖使用。 当是群是为群ID

即将下线

string oldContact; // 当单聊会话时,为用户NICK,隐私合规(22年8月)后,将不返回数据切勿强依赖使用。 当是群是为群ID

即将下线

string newContactNumberId; // 群或者联系人数字ID 隐私合规(22年8月)后,将不返回数据切勿强依赖使用。

即将下线

string oldContactNumberId; // 群或者联系人数字ID 隐私合规(22年8月)后,将不返回数据切勿强依赖使用。

新增参数:

string oldContactSecurityUID: 插件标识联系人UID, 当单聊时为安全标识联系人UID,当群聊时为群ID

string newContactSecurityUID:插件标识联系人UID, 当单聊时为安全标识联系人UID,当群聊时为群ID


FAQ

关于此文档暂时还没有FAQ
返回
顶部