常见问题 - 网易七鱼 API

简要描述：

获取会话-常见问题列表。

一般用于访客开启机器人咨询时，给访客推送一些常见的问题，访客可以通过选择问题的方式来提高咨询效率。七鱼机器人常见问题模版，支持按访客的“咨询渠道-咨询应用-来源页面”分别配置，便于实现在不同场景下推送该场景相关的常见问题。调用方在对接时，可以选择传递这些信息到七鱼系统，实现按场景区分常见问题。

curl --location --request POST 'http://qiyukf.com/openapi/robot/session/commonQuestions?appKey=&time=&checksum=' \ --header 'Content-Type: application/json' \ --data-raw '{ "robotId": 0, "uid": 0, "templateId": 0, "fromType": "string", "productId": "string", "fromPage": "string" }'

{ "code": 200, "message": "哈哈", "data": { "robotId": 34351, "questionGuide": "常见问题引导语文案", "questionList": [ { "question": "常见问题1", "type": 1 } ] } }

请求参数

Query 参数

appKey

string

必需

企业的appKey，1064deea1c3624c9ee26d1de5ce8481f

默认值:

time

string

必需

当前 UTC 时间戳，从 1970 年 1 月 1 日 0 点 0 分 0 秒开始到现在的秒数,1463217187

默认值:

checksum

string

必需

SHA1(appSecret + md5 + time), 三个参数拼接的字符串，进行SHA1哈希计算，转化成16进制字符(String，小写).示例2f13932c4b7c6888b12360a85261a11b8b543f64

默认值:

Body 参数application/json

robotId

integer

可选

机器人id，未指定时取默认机器人

uid

integer

可选

访客在调用方系统里的标志，用于唯一确定用户身份

templateId

integer

可选

指定七鱼常见问题模版id，如果指定了模版且模版生效，则取当前模版配置的常见问题数据；否则按“fromType-fromApp-fromPage”来匹配相应模版；

fromType

string

可选

当前访客咨询来源渠道

productId

string

可选

当前咨询应用标识，可以是 Android 应用的包名，iOS 应用的 bundleid，微信公众号appid等

fromPage

string

可选

当前访客咨询来源页面

示例

返回响应

🟢200成功

application/json

Body

code

integer

机器人id

可选

message

string

常见问题引导语

可选

data

object

可选

常见问题列表，字段及含义见通用数据结构SimpleQuestion说明

robotId

integer

必需

questionGuide

string

必需

questionList

array [object {2}]

必需