获取机器人消息回复
POST
/openapi/robot/session/chat
简要描述：
- 获取机器人回复接口。根据访客输入的文本内容，或者点击的常见问题/相似问题/关联问题/输入联想问题/服务直达推荐问题等，或者点击的BOT流程节点，机器人通过理解用户消息返回最佳答复。
- 访客消息和机器人回复消息，均会记入该访客当前会话中，会话结束后可以查看会话历史记录，以及相应的统计数据。
- 若当前用户不在会话中，则默认为该访客创建一个新机器人会话。
ansContent格式说明：ansType=1
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| answer | 是 | CommonMsg | 回复内容，这里的消息类型支持：text/richtext/workflow，字段格式详细介绍见通用数据结构说明 |
| connectQuestions | 否 | List | 当前回复 关联的问题列表，字段格式详细介绍见通用数据结构SimpleQuestion说明 |
ansContent格式说明：ansType=2
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| recommandGuide | 是 | string | 相似问题引导文案 |
| recommandQuestions | 是 | List | 当前推荐的问题列表，字段格式详细介绍见通用数据结构SimpleQuestion说明 |
ansContent格式说明：ansType=4
| 参数名 | 必选 | 类型 | 说明 |
|---|---|---|---|
| silence | 是 | integer | 未知问题回复/情绪安抚语类型，0-按answer回复，1-静默处理不回复 |
| answer | 否 | CommonMsg | 回复内容，这里的消息类型支持：text/richtext，字段格式详细介绍见通用数据结构说明 |
ansContent格式说明：ansType=10
转人工事件，此时 ansContent 即为CommonMsg格式，消息类型为event_trans，字段格式详细介绍见通用数据结构说明；
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://qiyukf.com/openapi/robot/session/chat?appKey=&time=&checksum=' \
--header 'Content-Type: application/json' \
--data-raw '{
"uid": "string",
"productId": "string",
"fromType": "string",
"robotId": 0,
"msg": "string",
"skipTrans": 0
}'响应示例响应示例
返回示例1:精准回复（命中某个faq/寒暄/bot节点等）
{
"code": 200,
"message": "哈哈",
"data": {
"sessionId": 62927,
"userId": 43412123,
"robotId": 34351,
"answerList": [
{
"msgId": "21323",
"ansType": 1,
"ansContent": {
"answer": {
"msgType": "richText",
"msgBody": {
"content": "<p>这是一个富文本答案</p>"
}
},
"connectQuestions": [
{
"question": "关联问题1",
"type": 1
}
]
},
"msgEvaluation": {
"evaluation": 0,
"evaluationReason": 0,
"evaluationGuide": "消息评价引导语"
}
}
]
}
}请求参数
Query 参数
appKey
string
必需
默认值:
{{appKey}}
time
string
必需
默认值:
{{time}}
checksum
string
必需
默认值:
{{checksum}}
Body 参数application/json
返回响应
扫码加入交流群修改于 2022-01-25 06:29:56