注意:以下文档只适用于TOP接口,请谨慎使用!

文档中心 > 基础技术

BC消息开放对接方案

更新时间:2023/07/31 访问次数:5509

BC消息开放能力对接方案

业务背景:

按业务场景需要开放对应的消息内容卡片,为商家提供场景化的消息下发能力,帮助其更好的触达和服务消费者,提升消费者的购物体验。

业务对接链路流程图:

名词解释:

名词

说明

连接器

触发事件和执行动作的集合。

触发事件

外部系统以某种方式告诉连接平台发生了某个事件。支持定义事件的触发方式和数据格式。

执行动作

连接平台调用外部系统 API 来实现某个操作。支持定义操作的协议类型和数据格式。

API字段说明:

开发者通过taobao.top.event.publish开发者通过topapi将数据同步给开放平台连接器网关trigger_code从控制台获取

 

应用对接配置:

权限申请流程:
按场景定向开放中,一期支持场景:虚拟商品发货、商品补发、延迟发货、改地址等,更多场景持续迭代中。

权限申请:订单管理、企业erp类应用可按对接需求申请:连接平台三方连接器、客服_消息卡片_补发货、客服_消息卡片_虚拟商品发货、客服_消息卡片_延迟发货、客服_消息卡片_改地址,应该就是申请这些权限包。申请对应场景权限,提交申请时描述清楚应用介绍、使用场景、申请理由等。

其它类型应用如有意向可咨询:子培确认是否具备开放和对接条件。

配置操作:步骤一:在开发者控制台,开发-》应用列表-》场景列表-》客服场景化开放。选择对应场景。点击‘连接器进’行启用

 

步骤二:注册配置连接器的基础信息、域名等。
 
步骤三:在连接器列表选择注册的连接器,并点击‘详情’开始编辑连接器
 

 

PS:如果连接器已经上线启用,连接器不可删除。
 
步骤四:进入触发事件TAB,并针对触发时间进行编辑配置
 
 
关于TriggerCode的使用可参考截图内连接引导或点击此处 说明文档
 
步骤五:请重点参阅触发事件的入参数据内容,在实际接口对接过程中严格按照定义的字段请求到平台网关。
 
PS:关于物流公司Code值可通过接口: taobao.logistics.companies.get 获取
 
步骤六: 保存并完成触发事件配置

调试与上线:

根据链接器的实际业务情况,完成相应的触发事件、执行事件的对接。完成后进行相应的数据调试,数据调试无误后进行发布上线完成最终对接。
控制台调试不会触发真实的调用。走真实的线上调用,需要使用TOP API进行触发。 接口说明

商家开通与配置:

服务商可通过接口:https://open.taobao.com/api.htm?docId=67110&docType=2   读取信息识别已经开通能力的商家。如果商家尚未开通,参阅以下商家开通配置操作引导:
步骤一:登录千牛工作台-》客服-》跟单工具。选择对应的工具
 
步骤二:选择对应的应用,并设置发送账号和发送时间段。然后保存启用
 
 
PS: 补发场景下物流公司code通过 https://open.taobao.com/api.htm?spm=a219a.7386797.0.0.21ad669alHdVfY&source=search&docId=233&docType=2 获取,如若不存在,则填OTHER

FAQ

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