用户咨询机器人

若您初次使用智齿客服开放平台接口-机器人&知识库接口,请在使用前阅读说明文档

接口说明

  • 接口类型:主动调用接口
  • 接口作用:可通过调用该接口实现以用户的身份咨询机器人并获取答案。

请求方法

请求参数(Request Body)

参数名 类型 必填 说明
action 字符串 传值为"chat_user_robot_ask"
access_token 字符串 调用接口凭据
data 对象 详见下文

请求data

参数名 类型 必填 说明
sysNum 字符串 企业标识,由智齿分配
partnerId 字符串 企业自己的用户id,可自行传值
question 字符串 用户问题
uname 字符串 用户昵称
source 整型 用户渠道:0-pc,1-微信,2-app,3-微博,4-移动网站
robotFlag 整型 机器人编号
questionFlag 整型 问题类型:点击-1,输入-0
requestText 字符串 问题内容(questionFlag=0时,传入原问题;questionFlag=1时,传入docId)

返回数据

参数名 类型 说明
code 字符串 执行结果码,1000代表成功
data 对象 详见下文

返回data

参数名 类型 说明
answer 字符串 答案
suggestions 对象 推荐问题列表,详见下文
question 字符串 原始问题
docId 字符串 词条id
uid 字符串 用户id
cid 字符串 会话id
msgId 字符串 消息体id
stripe 字符串 问题推荐引导语
robotFlag 整型 机器人编号
answerType 整型 机器人回答类型
sessionNew 布尔值 是否是新会话,true-是,false-不是

返回suggestions

参数名 类型 说明
question 字符串 推荐问题的名称
answer 字符串 推荐问题的答案
docId 字符串 推荐问题的词条Id

请求示例

curl https://open.sobot.com/open/platform/api.json \
-X POST \
-H 'content-type: application/json' \
-d '
{
    "action":"chat_user_robot_ask",
    "access_token":"xx",//获取access_token
    "data":{
         "sysNum" : "xx",  
         "partnerId" : "xx",
         "question" : "xx"
    }
}'

返回示例

{
    "code": "1000",
    "data": {
        "answer": "xx",
        "suggestions": [
            {"question":"xx","answer":"xx","docId":"xx"}
        ],
        "question":"xx",
        "docId":"xx",
        "uid":"xx",
        "cid":"xx",
        "msgId":"xx",
        "stripe":"xx",
        "robotFlag":1,
        "answerType":1,
        "sessionNew":true
    }
}

results matching ""

    No results matching ""