创建机器人

最近更新时间:2019-08-30 11:34:00

功能描述

创建一个服务于指定 sdkappid(业务SDK_ID)的机器人,该机器人唯一 ID 信息由第三方系统业务指定,第三方系统可使用机器人 ID 信息完成其他相关操作。

请求

请求 URL

https://yun.tim.qq.com/v3/prophet/createbot?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=999999
&contenttype=json 

URL 详细字段说明请参阅 URL 字段说明 文档。

请参数

字段名称 描述 类型 必填
botid 机器人唯一标识,由用户指定,一经创建不能修改,最长 64 字节 String
nickname 机器人昵称,最长 64 字节 String
auth 第三方账号认证信息,用作回调验证第三方账号合法性 String

响应

响应参数

字段名称 描述 类型
ActionStatus 处理状态 OK:成功;FAIL:失败。 String
ErrorCode 错误码,0:成功;非0:失败。 Int
ErrorInfo 错误信息 String

示例

请求示例

{
    "botid": "bot_identifier",
    "nickname": "小微",
    "auth": ""
}

响应示例

{
    "ActionStatus": "ok", //处理状态
    "ErrorCode": 0, //错误码
    "ErrorInfo": "" //错误信息
}