特殊结构化消息配置说明(仅网页接待)

一.特殊结构化消息样式分类说明:


1. 抽屉列表:最常见的一种列表形式,可以用于展示订单列表或商品列表,支持展示图文内容,也支持仅展示文字内容。抽屉列表有两种展示形式:

(1)平铺抽屉列表,tab下的商品全部拉平展示,样式如图:

(2)聚合抽屉列表,tab下的商品有分类聚合,样式如图:

如果需要返回抽屉列表内容,企业需要在查询节点内配置接口,并传入固定参数tabId,currentPage(代表当前要请求第几页),pageSize(代表每页的大小是多少)。若调用企业接口时params包含的参数为空,默认拉取第1个分组的第1页共5条数据,即相当于tabId=1,currentPage=1,pageSize=5。企业可以自定义pageSize,默认值为5,最大不超过10。tabId和currentPage可以根据访客的点选动态赋值。

2.气泡列表:可以用于展示订单列表或商品列表,支持展示图文内容,也支持仅展示文字内容,样式如图:

如果需要返回气泡列表内容,企业需要在查询节点内配置接口,并加入固定入参currentPage,pageSize。若调用企业接口时params包含的参数为空,默认拉取的第1页共5条数据,即相当于currentPage=1,pageSize=5。企业可以自定义pageSize,默认值为5,最大不超过10。currentPage可以根据访客的点选动态赋值。

3. 横划卡片列表:可以用于展示商品列表,支持展示图文内容,样式如图:

如果需要返回横滑卡片列表内容,企业需要在查询节点内配置接口,并加入固定入参currentPage,pageSize。若调用企业接口时params包含的参数为空,默认拉取的第1页共5条数据,即相当于currentPage=1,pageSize=5。企业可以自定义pageSize,默认值为5,最大不超过10。currentPage可以根据访客的点选动态赋值。

4. 节点列表:可以实现类似时间轴列表的效果,可以用于展示物流信息,企业也可以根据自己的需求灵活定制,样式如图:

拉取气泡节点列表时,目前不需要在查询节点的接口配置中设置固定入参。


二. 接口返回值示例及字段说明:


1. 抽屉型聚合列表

2. 抽屉型不聚合列表

3. 气泡型不聚合列表

4. 横划卡片型不聚合列表

5. 物流节点列表


字段说明:


contentData分组数据格式说明:


列表分组tab格式说明:



聚合型contentList详细数据格式说明:


非聚合型contentList和聚合型subList详细数据格式说明:


物流节点content字段详细数据格式说明:


物流信息列表list字段详细数据格式说明:


三.任务型问答-接口节点数据来源说明:


1. 词槽:需要先在判断节点处理设置词槽,在接口节点处理才可以选择对应的词槽

2. 接口:需要在上级接口节点处先设置需要调用的接口,下级接口节点才能选数据来源为节口,并选择对应的接口;

3. 固定值:当该参数需要输入固定不变的值时,可以选择该类型;

4. 系统参数:目前不支持用户自己配置系统参数,只有常用的tabId(标签ID), pageNum(当前第几页), pageSize(每面展示多少条数据), 用户ID,可以使用系统参数;