知方号

知方号

QQ 机器人

# QQ 机器人 # 简介

QQ 机器人通过开放的平台承载机器人的定制化功能,让开发者获得更畅快的开发体验。

# 亮点

便捷:通过开放接口的形式,QQ 开放平台允许开发者进行机器人定制化开发。

高效:提供一套标准化、易接入的API与websocket事件,可以帮助开发者实现机器人的快速开发和迭代。

趣味:机器人创新 C 端交互方式,通过指令的方式承载服务,让多样化服务变得触手可达。

赋能:频道、群、单聊等QQ场景全面打通,深度融入QQ社交生态,用户基础大,服务范围广。

# 接入流程 # 1. 阅读文档

为了更高效的进驻到 QQ 机器人平台,建议先阅读下列文档后再启动进驻工作:

运营规范 | QQ机器人文档

开发说明 | QQ机器人文档

# 2. 企业主体入驻

企业主体入驻开发者默认支持频道、群场景开发能力;个人主体入驻开发者默认仅支持频道场景开发能力。除默认开通的能力外,后续其他接口能力申请上,企业开发者与个人开发者也存在差异。

# 步骤总览

注意

企业入驻需要提供工商信息,包括:营业执照、对公账号,如不具备的用户请前往个人入口进行入驻。邮箱一旦填写完毕进入激活步骤,则被占用,不可修改,所以选错主体类型的用户需要更换邮箱重新注册。

# 2.1 点击「立即注册」

温馨提示

服务的三个类目,将鼠标放上去,将会有相关应用的文档及对应便捷入口,在注册前可先阅读相关文档。

# 2.2 选择企业 # 2.3 填写邮箱

温馨提示

之前已经注册过的邮箱不需再注册,直接去登陆界面登陆即可。

# 2.4 激活邮箱

温馨提示

如未收到邮件,请检查垃圾箱或者点击重新发送进行尝试。

# 2.5 上传工商信息

温馨提示

请务必确认上传的营业执照与填写的主体信息保持一致,账号注册完毕,后续还存在其他主体认证步骤,信息不一致将会导致后续步骤出现问题。

# 2.6 绑定管理员

温馨提示

姓名和身份证号码务必与手机号码对应运营商实名登记的信息一致,否则会提示错误。

# 2.7 资质审核 管理员绑定完成后账号即注册成功,进入应用管理页后,需进行后续企业资质审核步骤。 此步骤可与第三步创建应用同步进行,但此步骤需尽快完成,否则会影响应用的提审。 入口:点击页面提示条上的「查看详情」,即可进入详情页面查看进度。 # 资质审核详细流程

审核中-资料审核:  注册完成即自动进入工商信息审核,此步骤无需开发者操作,但请随时关注状态变更。

审核中-待打款:  填写银行信息,点击查看详情,进入二级页面填写对公账户的银行信息,如系统没有对应【银行所在地的区】,可选择同市其他区。

审核中-银行打款中:  如银行信息审核无误,则 3 天内腾讯公司将会对填写的对公银行账户进行 1 元以下小额打款,请关注银行收款。

打款帐号主体:深圳市腾讯计算机系统有限公司,打款银行账号:755901658210820。

审核中-校验金额:  收到打款后,请在规定时间内于开发者管理端回填收到的打款金额进行验证。

金额校验次数有限,请确认收到打款后进入二级页面,填写具体的金额,如次数用完且校验不通过,该账号将被冻结。 # 3 个人主体入驻

企业主体入驻开发者默认支持频道、群场景开发能力;个人主体入驻开发者默认仅支持频道场景开发能力。除默认开通的能力外,后续其他接口能力申请上,企业开发者与个人开发者也存在差异。

# 步骤总览 # 3.1 点击「立即注册」

温馨提示

服务的三个类目,将鼠标放上去,将会有相关应用的文档及对应便捷入口,在注册前可先阅读相关文档。

# 3.2 选择个人 # 3.3 填写邮箱

温馨提示

之前已经注册过的邮箱不需再注册,直接去登陆界面登陆即可。

# 3.4 激活邮箱

温馨提示

如未收到邮件,请检查垃圾箱或者点击重新发送进行尝试。

# 3.6 绑定管理员

温馨提示

姓名和身份证号码务必与手机号码对应运营商实名登记的信息一致,否则会提示错误。

绑定成功即可进入应用管理页开始创建应用。

# 4 创建应用

创建机器人。

# 4.1 点击「创建机器人」 # 4.2 填写资料 # 4.2.1 机器人资料填写页面 # 4.2.2 进入管理端

资料提交成功后,即会生成appid,点击对应的应用即可跳转管理端。

# 5. 机器人发布流程

建议按照首页发布流程,分别完成机器人配置、开发、提交审核;审核通过并手动上线后,方可在QQ客户端添加机器人至对应场景。

# 6. 基础信息设置

机器人创建后首次上线前,在相关功能配置提交审核时,机器人基本信息将一并提交审核;

机器人首次上线后,机器人基本信息修改将单独提交审核,审核完成前其他模块不可提交审核;

基本信息修改限制:每月可修改5次。

操作步骤:

(1)点击「修改」进入编辑,完成基础信息修改

(2)点击保存,扫描二维码确认保存

(3)等待审核通过

(4)审核通过后,前往「发布设置」,点击「上线」

# 7. 开发场景选择

在沙箱配置页面,不同类型开发者支持开发不同场景机器人功能

可开发的场景与开发者认证身份有关,详细如下:

认证身份 QQ频道 QQ群 消息列表单聊 企业开发者 ✅ ✅ 申请后可开发 个人开发者 ✅ 暂不开放 暂不开放 # 7.1 配置沙箱环境

建议开发者根据实际的需要,选择在不同场景开发机器人,完成对应场景的沙箱环境配置。配置沙箱后,开发者可在「功能配置」、「使用范围与人员」页面解锁相应场景的配置能力。

沙箱频道仅可设置当前用户为频道主/管理员的频道、沙箱群仅可设置当前用户为群主/群管理员的群,且沙箱频道成员、沙箱群成员不可大于20人。

温馨提示

(1)配置沙箱群/频道,需要先在QQ客户端创建符合沙箱要求的QQ群/QQ频道;(2)在频道场景,机器人仍然保留「公域」/「私域」机器人的区分,设置为公域机器人保存确认后不可切换为私域机器人,但在「使用范围与人员」可设置公域机器人的允许添加范围:“全部用户可添加”/“仅白名单用户可添加”;(3)配置沙箱频道/群后,机器人会出现在沙箱频道/沙箱群的机器人列表当中。

# 7.2 添加机器人至沙箱环境

配置好沙箱环境后,可通过机器人资料卡将测试机器人添加进沙箱频道/沙箱群/沙箱账号,沙箱群/沙箱频道也可通过群/频道设置页的机器人列表添加机器人。

# 7.2.1 添加到沙箱频道

方法一:移动端点击沙箱频道封面图-->选择「机器人」进入商店页-->点击添加测试机器人

方法二:移动端登陆管理员QQ号-->扫描管理端频道机器人二维码-->打开机器人资料卡-->添加至频道-->选择配置好的沙箱频道-->确认添加

温馨提示

二维码可在「使用范围与人员」页面扫描。

【进入私信沙箱】

沙箱频道添加好测试机器人后,已经配置沙箱私信账号的QQ号,从沙箱频道打开机器人资料卡,选择私信,即进入私信沙箱环境

温馨提示

当账号在「沙箱配置」-「在频道私信配置」完成配置后,该账号从任意渠道进入该机器人的频道私信窗口,拉到的该机器人指令面板、基础信息资料等内容均为沙箱环境信息。

# 7.2.2 添加到沙箱群

方法一:移动端点击沙箱群"设置"-->选择「群机器人」进入商店页-->点击添加测试机器人

方法二:移动端登陆管理员QQ号-->扫描管理端QQ群和消息列表机器人二维码-->打开机器人web资料卡-->点击「添加到机器人」-->跳转到native资料卡-->分享到沙箱群-->打开native资料卡-->点击「添加到本群」-->选择配置好的沙箱群-->授权确认添加

温馨提示

二维码可在「使用范围与人员」页面扫描

# 7.2.3 添加到沙箱账号消息列表

移动端登陆管理员QQ号-->扫描管理端QQ群和消息列表机器人二维码-->打开机器人资料卡-->点击"发消息"-->授权确认添加-->进入消息列表开启沙箱单聊对话

# 8. 开发基础设置

获取与配置开发所需信息

# 8.1 机器人 AppID

此处主要展示机器人QQ号、AppID、Token、AppSecret。

温馨提示

此信息不要对外传播

# 8.2 回调地址

在跳转h5需要OAuth的时候使用 (如机器人服务是跳转小程序,可忽略),回调地址上限为10条。

# 8.3 消息URL白名单配置

填写机器人下发消息中所包含的

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至lizi9903@foxmail.com举报,一经查实,本站将立刻删除。