文档中心 > API类目 > 千牛业务API

qimen.taobao.message.chatrobot.sync (机器人消息语料同步)

同步消息语料至三方机器人，用于客服业务机器人自动应答

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	描述
event	String	必须	{"body":{"bizUniqueId":"919fbc15da871ddf3217442718c54491","channelType":"bc","content":"{\\"text\\":\\"你好\\"}","contentType":1,"createTime":1744958470723,"messageType":"NONE_SYS","msgId":"3432345139967.PNM","receivers":[{"domain":"cntaobao","nick":"子进店铺测试007:子进001","role":"customService"}],"sender":{"domain":"cntaobao","nick":"子**","role":"buyer"}},"header":{"actionMode":1,"createTime":1744958471492,"requestId":"919fbc15da871ddf3217442718c54491","serializeType":"Json","tenantCode":"platformTestForIsv","tenantId":43,"type":1}}	消息体
buyerId	Number	必须	1234	消费者id
buyerNick	String	必须	帐号nick	消费者nick
sellerId	Number	必须	1234	商家id
sellerNick	String	必须	商家nick	商家nick

响应参数

名称	类型	示例值	描述
result	ResultDO		返回结果
└ success Boolean true 请求是否成功 └ resultCode String ERROR 错误码 └ errorMessage String 错误信息描述错误信息 └ data String {"code":"3001","success":true,"message":"xxx","request_id":"ecnkfg8v9q2k"} 返回结果

请求示例

{"sellerNick":"商家nick","sellerId":1234,"buyerNick":"帐号nick","event":"{\"body\":{\"bizUniqueId\":\"919fbc15da871ddf3217442718c54491\",\"channelType\":\"bc\",\"content\":\"{\\\\\"text\\\\\":\\\\\"你好\\\\\"}\",\"contentType\":1,\"createTime\":1744958470723,\"messageType\":\"NONE_SYS\",\"msgId\":\"3432345139967.PNM\",\"receivers\":[{\"domain\":\"cntaobao\",\"nick\":\"子进店铺测试007:子进001\",\"role\":\"customService\"}],\"sender\":{\"domain\":\"cntaobao\",\"nick\":\"子**\",\"role\":\"buyer\"}},\"header\":{\"actionMode\":1,\"createTime\":1744958471492,\"requestId\":\"919fbc15da871ddf3217442718c54491\",\"serializeType\":\"Json\",\"tenantCode\":\"platformTestForIsv\",\"tenantId\":43,\"type\":1}}","buyerId":1234}

响应示例

{
    "result":{
        "success":true,
        "resultCode":"ERROR",
        "errorMessage":"错误信息描述",
        "data":"{\"code\":\"3001\",\"success\":true,\"message\":\"xxx\",\"request_id\":\"ecnkfg8v9q2k\"}"
    }
}

验签示例

{"result":{"success":"false","resultCode":"sign-check-failure","errorMessage":"Illegal request"}}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部