# 机器人常见问题整理
# 一 QQ机器人简介
# Q1：QQ机器人是什么？
QQ机器人，是通过开放的接口，让开发者能够实现开发出交互形式丰富的机器人，以辅助实现频道/社群内的管理、消息互动，满足群主运营者多样化、个性化的运营需求，从而提高运营效率，同时为用户带来丰富的服务和便捷的体验。
# Q2：QQ机器人可以实现什么功能呢？
QQ机器人集便捷、高效、趣味、赋能于一身：
- 高效的社群管理功能（如：身份组分配、自动回复、签到打卡等）
- 稳健的音频功能（如：听歌、听书、语音开黑、在线玩桌游等）
- 有趣的游戏功能（如：猜灯谜、成语接龙、打年兽升级、攻城守家等）
# Q3：QQ机器人，区别于其他机器人的亮点有哪些？
QQ机器人目前还在不断地迭代升级，亮点满满，包括但不限于：
- 亮点一：内联能力。通过内联能力，在聊天窗口实现一键发送机器人内容，让你的机器人成为内容直接触达用户的有效通道；
- 亮点二：markdown能力。@丰富的markdown能力让你的机器人不再只有文字和图片，给用户带来更多的功能和服务；
- 亮点三：连接小程序能力。机器人和小程序打通，同时小程序也可以一键加入频道，不仅让你的应用服务触达更多用户，还能提升自有频道的流量！
# Q4：QQ机器人是否有官方交流社群？
有的！欢迎加入~
加入社区不仅可以与官方面对面也能交流开发经验，欢迎开发者在社区内进行互动！
QQ频道用户可以搜索“QQ频道开发者社区”加入官方频道交流，或用手机QQ扫描下方二维码。
如开发的过程中有任何需求，都可以在QQ频道开发者社区和对应版本的小助理交流！
- 如果你有好的产品建议，请移步子频道#需求 || 产品建议，欢迎大家交流或吐槽；
- 如果你遇到开发bug，请移步子频道#需求 || bug反馈，值班小助理会帮你迅速解决。
快来扫码加入【QQ频道开发者社区】：
# 二 关于QQ机器人赋能与发展
# Q5：QQ机器人能做什么？
社群管理-提效率：自动回复、自动分组、打卡等，提升管理效率
用户互动-促活跃：成语接龙、猜灯谜、抽奖、RPG/SLG文字游戏等，提升频道活跃
连接应用-强触达：支持连接QQ小程序、第三方内容订阅等
# Q6：QQ机器人的好处？
对于频道主、群主：帮助管理的工具，提升管理效率；同时提高群的活跃度
对于开发者：直接触达用户，通过机器人推送自己的应用服务，积累用户，获取更多流量
# 三 关于开放平台
# Q7：开放平台是什么？
QQ体系内的应用开放平台，可为不同类型的产品提供框架，实现在QQ内便捷地获取和传播，服务类目为QQ小程序、QQ小游戏、QQ机器人，是QQ合作伙伴提供多维业务服务与用户管理能力的全新开放平台。
# Q8：我是个体开发者，我要怎么入驻开放平台？
步骤为：绑定邮箱和密码--激活邮箱--绑定管理员
若想了解完整入驻流程请点击链接，并参考“QQ机器人文档-接入流程-个体开发者入驻”部分QQ机器人文档-个体开发者入驻
# Q9：我是企业开发者，我要怎么入驻开放平台？
①注册账号：绑定邮箱和密码--激活邮箱--上传工商信息--绑定管理员
②主体资质审核：工商信息审核--填写对公银行信息--银行打款--校验金额
若想了解完整入驻流程请点击链接，并参考“QQ机器人文档-接入流程-企业开发者入驻”部分QQ机器人文档-企业开发者入驻
# Q10：开发者个人主体怎么转企业主体？
不能，目前不支持开发者主体转换
# Q11：企业用员工个人主体注册，然后员工离职了账号结算如何处理？
邮箱不可更改，因此请自行告知员工将账号和密码进行转交和告知
# Q12：QQ机器人如何开发与创建？
①打开QQ开放平台：QQ 开放平台
②创建步骤：注册/登陆账号成功---进入应用管理页---点击「创建机器人」---填写机器人资料---提交并创建成功
③开发：开发QQ机器人，可以参考官方文档，详细教程请戳：QQ 机器人 | QQ机器人文档
# Q13：最多可以创建多少个机器人？
- 企业开发者：
- 一个账号最多允许注册10个机器人
- 一个主体下最多允许存在50个APPID
- 个体开发者：
- 一个账号最多允许注册5个机器人
- 一个主体下最多允许存在5个APPID
# Q14：公域机器人&私域机器人有什么差异？
①QQ私域机器人的界定为：QQ机器人开发者同时为QQ频道创建者，即为QQ机器人的开发者注册uin与创建频道的uin一致，机器人仅可在该频道进行使用。
②公域机器人在“主动消息量”、“被动消息发ark能力”、“接口权限”、“流量策略”上有不同，详情请参考文档QQ公、私域机器人能力开放计划。
③群机器人无公域私域之分。
# Q15：为什么账号有多个机器人，但我只能看到一个（或者登录后什么都没有）？
应用列表页所有的应用（机器人、小程序）都是需要在管理端添加权限才能显示。
比如，你只有A应用的权限，就只能看到A应用，看不到BCD等，只有管理员能看到所有的应用。
# Q16：一个QQ账号可以创建几个频道？
①频道普通用户支持开3个频道
②开发者注册完机器人后支持开4个频道
# Q17：应用子频道是否只能在配置的测试频道看见，如何全量推广？
① 目前在管理端频道接入后，只能在配置的不超过5个频道看见，如需申请全量，后续有专门的申请上推荐功能，待开放。
② 前期如需申请全量，请联系：qq-miniprogram@tencent.com，说明申请理由和体验录屏，由专门的运营人员对接联系。
# Q18：应用子频道审核时间是怎样的？
应用子频道走快速过审流程，请及时刷新审核状态。
如超过2天审核状态未变化，请联系qq-miniprogram@tencent.com，说明提审时间、小程序appid，由专门的运营人员对接联系。
# Q19：沙箱频道的功能与创建流程是什么？
# 1. 沙箱频道
1）功能
① 沙箱频道为机器人沙箱环境，机器人未正式上线的功能验证或迭代均可在沙箱体验，正式频道仅可使用机器人已审核通过并上线发布的功能。
② 沙箱环境只会收到测试频道的事件，且调用openapi仅能操作测试频道。开发者可在沙箱频道里进行功能自测，便于填写复审时需要的自测报告，并且沙箱频道不会被官方推荐和搜索。
③ 沙箱环境链接沙箱域名后，可以不受消息频控等限制。
④ 私信暂不支持沙箱环境。
2）创建流程
① 沙箱频道由开发者在频道中自主创建，点击操作栏右侧“+”即可进行创建。
# 2. 沙箱群
1）功能
① 沙箱群为机器人沙箱环境，机器人未正式上线的功能验证或迭代均可在沙箱体验，正式群仅可使用机器人已审核通过并上线发布的功能。
② 沙箱环境只会收到测试频道的事件，且调用openapi仅能操作测试群。开发者可在沙箱群里进行功能自测，便于填写复审时需要的自测报告，并且沙箱群不会被官方推荐和搜索。
2）创建流程
沙箱群由开发者在QQ消息列表中自主创建。
# 四 关于小程序
# Q20：如何接入QQ小程序？
QQ小程序可通过应用子频道、一键加频道、机器人服务等渠道接入频道服务
具体请参考：平台入驻文档
# Q21：小程序是否可以加入频道？
小程序开发者可以在管理端，将小程序接入频道，成为应用子频道，供频道主添加。
*更多可参考：平台入驻文档
# Q22：小程序一键加频道怎么调用？
可参考文档，guild_id的获取方式展示请填写问卷进行申请： 【小程序一键加频道】guildid获取
# 五 关于机器人安全审核
# Q23：机器人的提审流程是什么？
机器人上线前需完成平台审核，因此开发者需将机器人的语料配置、功能配置和自测报告提交平台审核，如果审核不通过机器人则无法上线。
# Q24：机器人审核的标准是什么？
请查看并遵守“运营规范-具体运营规范”，希望这些规范，能够一定程度上帮助你解决开发、运营 QQ 机器人过程中所遇到的疑问。【机器人审核规则解读】
*注：请严格遵守QQ开放平台运营规范，若违反规范，将对您的QQ机器人进行相应的惩罚。
# Q25：官方在什么时间段审核？审核的时效是多久？
当日16:00前提审的机器人，当日审核完毕
当日16:00后提审的机器人，次日审核完毕
# Q26：提审后，反馈“机器人名称违反平台规范”，需如何改进？
- 机器人名称长度需大于等于2个字，不得与其他机器人名字重复
- 机器人名称需要能体现机器人功能、特色或者IP相关，如腾讯会议、王者开黑小助手等，不建议使用个人名字或昵称，以及过于宽泛的词语
- 机器人名称不可特殊符号、火星文、无意义字母文字堆砌
- 机器人机器人名称不得违规或包含营销类词语
- 机器人名称不得冒用腾讯官方，机器人内容使用了腾讯官方素材
- 机器人信息不得存在联系信息
- 机器人信息不得存在自行广告招商内容
# Q27：提审后，反馈“指令无响应”，可能是什么原因？
- 提审时未将沙箱域名切换回正式域名
- 指令有特殊条件，但自测报告中未说明，指令进管理员可用
- 指令存在特殊情况，但逻辑并没有覆盖，例“该指令每日只可用一次等”
- 指令在代码中未做/ 空格兼容适配
- 提审期间机器人未在线/服务器不稳定
- 机器人所需特殊权限，未在自测报告中说明
- 功能涉及需绑定第三方平台账号，未在自测报告中附上测试账号与密码，导致审核人员无法测试
# Q28：功能配置描述与实际功能不符是为什么？
- 指定回复内容与自测报告描述不同
- 实测功能未在自测报告中说明
- 实际功能少于自测报告中提供的功能
具体体现为：
- 功能指令——输入功能指令A，除返回开发者自测报告显示的指定内容外，另跳出多条无关内容
- 功能指令——输入功能指令A，开发者自测报告指定返回内容B，但实际返回内容为C
- 功能配置——实测功能数大于开发者提供的功能配置描述
- 功能配置——实测功能数小于开发者提供的功能配置描述
- 功能配置——功能描述为A类型，实测功能为B类型
# 六 关于接口
# Q29：怎么发送ark消息？
- 主动消息默认可使用ark能力
- 被动消息发ark能力，需机器人达到数据标准后申请开通
*注：ark消息详情可参考QQ机器人文档中的内容：消息模板|QQ机器人文档
如果有其他的ark模板诉求，可以到QQ机器人官方频道开发者社区进行反馈，平台人员收到后会进行综合评估。
# Q30：如何申请Markdown、消息按钮模板使用权限?
申请方式：点击 QQ机器人消息模板能力，填写申请表进行能力申请。
申请条件：
- 私域机器人：已审核上架、使用场景及目的合理
- 公域机器人：已审核上架、过去7天平均使用频道数达3个及以上、使用场景及目的合理
- 群机器人：已审核上架、过去7天平均使用群数达3个及以上、使用场景及目的合理
审核周期： 每月15-20日统一审核，审核结果会进行邮件通知。
# （一）API接口
# Q31：如何得到 traceID？
在 openapi 的返回 http 头上，有一个X-Tps-trace-ID自定义头部，是平台的链路追踪 ID，如果开发者有无法自己定位的问题，需要找平台协助的时候，可以提取这个 ID，提交给平台方。
# Q32：如何查询接口错误码？
点击下方链接可进行查询http状态码与错误码：
# 七 关于机器人上推荐
# Q33：如何让我的机器人申请上推荐？
上线发布后的QQ机器人，我们会在5个工作日内，进行综合体验评估。
- 对于符合推荐标准的，我们会通知做好扩容准备，逐步放量。
- 对于暂时不符合推荐标准的，我们也会反馈优化建议，请及时迭代优化。
- 私域机器人不支持上推荐
# Q34：机器人上推荐的标准是什么？
主要从以下3个维度进行判断：
- 功能体验
机器人功能服务 丰富完整
服务召唤响应/消息推送 及时性
推送服务无广告
推送服务在产品体验（功能、视觉、交互）体验好
- 稀缺度
玩法新颖的机器人，更容易获得平台推荐
- 普适性
全量频道可用＞垂类＞高度定制、无法复用
申请前请务必参考此文档机器人推荐机制
与此同时，若推荐机器人发生严重违规 或 大面积bug的情况，我们会将其退出推荐。请进入推荐的机器人合理使用机器人能力，避免用户投诉，并做好性能监测。
小程序 →