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

为了更高效的进驻到 QQ 小程序平台，建议先阅读下列文档后再启动进驻工作：

步骤总览

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

提示：之前已经注册过的邮箱不需再注册，直接去登陆界面登陆即可

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

绑定管理员

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

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

步骤总览

注意：

企业入驻需要提供工商信息，包括：营业执照、对公账号，如不具备的用户请前往个人入口进行入驻

邮箱一旦填写完毕进入激活步骤，则被占用，不可修改，所以选错主体类型的用户需要更换邮箱重新注册

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

提示：之前已经注册过的邮箱不需再注册，直接去登陆界面登陆即可

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

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

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

管理员绑定完成后账号即注册成功，进入应用管理页后，需进行后续企业资质审核步骤

此步骤可与第三步创建应用同步进行，但此步骤需尽快完成，否则会影响应用的提审

入口：点击页面提示条上的「查看详情」，即可进入详情页面查看进度

资质审核详细流程

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

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

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

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

提示：沙箱频道为下拉选择，该频道由开发者在频道中自主创建

提交机器人基本信息后，机器人会出现在沙箱频道的机器人列表当中，开发者可在沙箱频道里进行功能自测，便于填写复审时需要的自测报告。

完成创建后，即可点击已创建的应用进入管理端

BotAppID生成后，可在自己的测试频道机器人列表里获取自己的测试机器人并添加，操作路径如下：

点击频道右上角「...」--->点击「频道设置」--->点击「机器人」--->添加测试机器人

此处主要展示BotAppID、BotToken、BotSecret。

温馨提示： 此信息不要对外传播

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

填写机器人下发消息中所包含的链接域名，域名需在此处提交后才可生效，域名上限为20条，每年可修改50次。

温馨提示： 域名需提前进行 ICP 备案，并通过域名校验才可报备成功。

为了帮助开发者获取 C 端用户对于机器人的评价与反馈，平台为开发者接入了”兔小巢反馈空间“，开发者可以通过创建产品反馈空间。

频道用户意见反馈： 点击进入登陆后，根据提示创建产品，将会获得一个兔小巢反馈空间，C 端用户所填写的机器人反馈将同步至此空间，开发者以后可登陆此空间查看用户反馈。

产品 ID 填写： 需要在此处填写兔小巢反馈空间的产品 ID，C 端用户的机器人反馈才可同步至此处，详细获取路径如开发者端提示：设置-->产品设置-->产品 ID。

温馨提示： 兔小巢创建与使用详情可点击用户反馈空间创建攻略

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

开发者管理端的角色共有两种：管理员和普通成员。

温馨提示： 登陆权限是基础权限，要拥有发布权限和开发权限的前提是拥有登陆权限

开发者可以通过发布设置配置对话类型语料以及机器人服务，此处配置的语料和功能配置完毕，均需通过代码开发实现。

对话类型语料配置要求语料必须以一问一答的对话形式上传，且此类问答对话为严格按照配置好的内容进行对话（即被动消息），如需产生动态变化（如问我的战绩排名），可申请被动消息发 ark 的形式进行开发配置（邮件模板见下文）。

用户可以下载模板使用 csv 文件批量上传，也可以一条一条单独添加。

添加提交后会进行平台审核：对于已经审核通过的语料，仅支持删除，不可修改；未审核通过的语料，可修改后重新提交。

配置上限总量1000条，但批量新增提交审核单次上限100条。

输入： 填写用户@机器人的文本，不允许配置链接、缩写、火星文或大量符号，最多6个字符。

回复： 填写机器人的回答文本，不允许配置链接、缩写、火星文或大量符号，最多100个字符。

图片链接： 填写机器人回答中图片的url链接，图片链接url需带http或https前缀，图片不允许涉及政治敏感与色情。

温馨提示： 所有开发者注册完机器人默认拥有“不校验语料 id”能力，即不需要在管理端的对话型语料里进行语料报备，直接使用代码实现 AB 回复逻辑即可，一旦机器人被平台发现有违规行为，该能力将被收回，所有被动消息均需要在此处进行报备才可发出。

【消息类型】机器人发送消息分为主动消息和被动消息：

【主动消息限制 】

【被动消息申请 ark 能力】

邮件模板

标题：【QQ 机器人被动消息发 ark 申请】XX 机器人申请

邮件内容：

基础信息：机器人 Bot id、机器人名称、企业主体名称（具体写上申请公司名称）

机器人功能说明

被动消息发 ark 消息使用场景

承诺业务将严格遵守 QQ 机器人平台的运营规范，如果有违反，一切后果由业务使用侧自行承担。

承诺方： XX 公司

承诺日期： 20xx 年 xx 月 xx 日

以上信息，邮箱发送：[email protected]

功能配置分为服务配置与指令配置。

开发者需在管理端配置用于 C 端的机器人功能资料卡的小程序服务，可配置功能上限为18个。

名称：请简单凝练的描述功能，字数不超过5个字，内容需符合平台运营规范。

介绍：请简单的对功能进行介绍，字数不超过15个字，内容需符合平台运营规范。

appID：请输入小程序服务的ID号。

path：请输入小程序的路径。

extData：请输入小程序 extendData。

权限菜单：请选择本服务是开放给所有用户还是仅针对频道主和管理员。

温馨提示： 开发者可添加、删减功能，管理端配置的功能顺序与 C 端机器人资料卡展示的功能顺序一致

开发者在管理端配置用户 C 端指令集面板的服务，可配置上限为18个。

指令名：请简单凝练地描述指令，字数不超过5个字，，内容需符合平台运营规范。

指令介绍：请简单的对指令进行描述，字数不超过10个字，内容需符合平台运营规范。

权限菜单：请选择本指令是开放给所有用户还是仅针对频道主和管理员。

注意： 指令集的指令内容是上述【语料配置】模块中“输入”内容的子集，即指令必须包含在已经审核通过的“输入”内容中，否则指令会无法提交。

开发者可添加、删减指令，管理端配置的功能顺序与 C 端机器人指令集展示的功能顺序一致，建议将常用/核心的指令前置。

注意： 指令和服务模块暂不需要单独提审，自测完成后，填写自测报告与自测报告一起提审。

开发者需下载机器人自测报告模版，在自测频道内根据模板要求测试机器人的功能，并填写完自测报告后上传。

自测报告：机器人自测报告模板 。

审核结果：请自行在对应提审模块查看，如果审核不通过，则需要修改后再次提交审核。

审核时效：工作日24小时内审核，不支持催审，请耐心等待审核验收结果。

温馨提示： 提交功能配置审核前需完成机器人的资质认证，提交审核后，服务配置、指令配置和自测报告将一起送往平台进行审核。

机器人上线前需完成平台审核，因此开发者需将机器人的语料配置、功能配置和自测报告提交平台审核，如果审核不通过机器人则无法上线。

温馨提示： 此处配置的语料和功能配置完毕，均需通过代码开发实现；也可先代码开发，再将需要的语料和功能在管理端进行报备审核，请详细填写自测报告，如审核中发现未写明的功能将直接打回。

开发者在开发者管理端提交机器人上线后，需要平台进行配置，灰度频道 ID，只有被灰度到的频道才能搜到上线的机器人。

注意： 》 在机器人上线后，若开发者需要修改机器人功能配置或基本资料，则需要重新提交审核，并且在审核通过后重新上线；在新功能配置或基本资料上线前，机器人在线上展示原有信息。

提示: 所有 QQ 小程序必须遵守《QQ 小程序运营规范》 ，开发者可参考相关文档了解详细审核标准。

完成创建后，即可点击已创建的应用进入管理端

所选类目需与小程序本身服务相关，并按提示提供相关的资质； 每个小程序最多可以选择 5 个类目。

路径：设置——基本设置——服务类目

tips: 1、后续上线支持修改名称 2、此步骤不意味着抢占名字，最终以审核上线为准

为了帮助 QQ 小程序开发者简单和高效地进行编码工作，我们在提供集成调试、编码能力的开发工具。

tips: 开发文档会不断更新 API 及相关能力，请随时保持关注

登录QQ 小程序开发者平台首页 并进入开发管理，该页面将展示已上传的代码，管理员可提交审核或是删除代码。提交审核完成后，开发管理页中审核版本模块展示审核进度

tips: 提交代码审核前需完成小程序信息补全、主体审核

代码审核通过，需要开发者手动点击发布，小程序才会发布到线上提供服务，至此用户将能通过搜索、分享、推荐等场景体验到该小程序。

需注意是否已完成以下操作：小程序常见问题指引

tips: 如遇到社交/文娱视频/文娱 FM 电台等类目，第一次代码提审时会额外有个 7 个自然日的二审周期，不支持催审，请务必预留充足提审时间

开发者在后台完成发布后，24 小时以内，小程序会发布到线上提供服务，用户将能通过搜索、分享等场景体验到该小程序

在开发者点击发布并且小程序经过内部审核后，24 小时内即可上架应用商店供 QQ 用户搜索。平台会提供算法资源给到小程序，综合数据优质的 QQ 小程序，会获得可观的算法流量。

小程序需要进行相应的认证之后才能拥有更多接口能力，高级接口包括支付、广告、账号互通、社交分享等能力，后续新增接口内测也将会优先提供给已认证主体小程序。

QQ 小程序开发者平台提供了丰富的 API 和组件，具体的能力可以参照如下小程序示例：

已认证主体的小程序可申请支付能力，为了降低开发者的门槛 QQ 小程序平台提供两套解决方案：

QQ 钱包 与微信支付 同属于腾讯集团旗下为用户提供互联网支付与金融服务的综合平台，QQ 钱包在年轻用户中迅速普及，覆盖了 QQ 内手机充值、信用卡还款、理财通、微粒贷、Q 币充值、证券、演出赛事票、购物、竞彩、酒店预订、城市一卡通、汽车票、生活缴费、城市服务、腾讯公益等产品消费场景，使得数亿 QQ 用户生活更加便利。原 QQ 钱包商户无需重新申请、只需修改配置，即可把支付能力拓展到 QQ 小程序当中。

腾讯计费孵化于支撑腾讯内部业务千亿级营收的互联网计费平台(米大师 ，具备十余年计费经验，现面向各行业伙伴全面开放虚拟支付能力，在 QQ 小程序、小游戏中集成 QQ 支付、微信支付等能力，并提供账户管理、精准营销、安全风控、稽核分账、计费分析等多维度服务。QQ 小程序、小游戏开发者登录QQ 小程序开发者平台 后即可自助申请、开通使用。

tips: 小游戏暂未支持接入 QQ 钱包，若有支付需求请使用腾讯计费。 小程序支持使用 QQ 钱包和腾讯计费；后者在小程序场景灰度中，将会逐步提供广大开发者使用。

3.1 如何界定实体支付还是虚拟支付（实体支付和虚拟支付仅支持 1 个，不可同时接入 1 个小程序内）

后台管理端会自动根据小程序选择的类目，展示接入 QQ 钱包、微信支付或米大师的页面。如有错误，请联系 [email protected] 邮箱沟通修改。

具体界定说明文档：服务类目对应的支付类型说明

路径：管理端首页-小程序信息编辑-服务类目

3.2 虚拟支付

虚拟支付即米大师解决方案（目前支持 Q 币、QQ 钱包、微信支付）

接入说明：目前平台虚拟支付的米大师支付方案（支持 QQ 钱包+微信支付）正在内测阶段；

3.3 实体支付

(1) QQ 钱包（目前支持钱包余额、银行卡支付）

(2)微信支付

腾讯社交广告资源丰富既包括微信、QQ 等强势社交产品，也包括用户移动生活所必须的各类应用，贯穿用户每日 24 小时真实生活。

依托腾讯大数据精准的人群分析能力和海量的优质广告素材，通过丰富的广告形态为广大流量主提供优质的商业化解决方案。

接入过程仅需复制广告代码，并将其嵌入小程序、小游戏代码中，就可通过 Banner、激励视频等广告形态获得变现收益。数据精准透明，可按天查看广告流水，按月结算分成收入。

1.1 准入条件

2019 年 7 月 23 日起，未出现严重违规的企业主体小程序、小游戏均可接入广告；过去 7 天日均独立访问用户（UV）不低于 100 且已上线的个人开发者小程序均可接入广告； 详见开发者管理端 广告接入页面。

1.2 申请办法

在管理端后台申请，填写资料后，2 小时内审核通过生效

1.3 相关文档

广告技术赋能商业，腾讯社交广告平台每天有超过 8 亿用户使用 QQ、Qzone 等众多腾讯产品及第三方应用。我们为您提供了众多广告定向条件，您可以从中选择适合达成您商业目标的条件锁定人群、建立联系，将优质商业信息推送给真正需要的人。

小程序绑定QQ 互联 账号后，可通过 UnionID 机制打通多个 App、网站、小程序。

请注意:

1)打通后请换用 unionID 作为识别用户标识。

2)unionID 打通后，不会对 openID 造成任何影响。

3)应用开发者转移不对应用数据造成任何影响。

具体操作步骤如下： 第一步：在 QQ 小程序平台打开「开发设置」 页面获取 AppID(小程序唯一 ID)和 AppSecret(小程序密钥)； 第二步：登录 QQ 互联平台，切换到小程序 Tab 页后，点击「关联小程序」 并输入前述获取的 AppID(小程序唯一 ID)和 AppSecret(小程序密钥)； 第三步：绑定成功后，切换到「应用接口」页面即可自助开通 unionID 权限； 申请存量 openID 转换 对于已上线应用有存量 openID 需要转换 unionID 的，可以申请 openID+appID 转 unionID 接口，申请链接 。

请注意: 此接口处理速度 2000/S，处理速度极快，支持多线程，仅限使用 2 个月处理 所有存量数据。

至此即可用.getUserInfo 以获取 unionID。

为满足开发者对社交传播的诉求，我们提供了分享小程序到 QQ 好友、QQ 群聊和 QQ 空间的能力。

同时，为了进一步提升分享效率，平台也提供了特定场景下快速分享的能力。

在分享面板中，可以分享给 QQ 好友、QQ 空间，同时会显示用户的最近联系人列表，方便用户快速传播。

有以下两种调用方式：

1.1 qq.showShareMenu

开发者只需对 API showShareMenu 进行简单设置即可使用。

小程序&小游戏调用方式相同。

1.2 小程序/小游戏内调用分享组件

1.2.1 小程序

通过设置 button 组件的 share 属性，可以在小程序内调用上述分享面板，且开发者可以自由组合分享渠道，进一步提升分享效率。

分享面板内显示内容设置，具体见button 文档 。

1.2.2 小游戏

可以通过qq.shareAppMessage ，调用分享面板。

案例：

2.1 快速分享面板

在多人参与的场景中，有时用户不满足于仅分享到单个 QQ 会话。在当前能力下，用户操作路径较长，点击分享到 QQ--选择好友--发送--返回再点击按钮。

QQ 提供了一次调用、多次发送的快速分享面板，可大大降低用户操作成本，助力优秀内容的快速传播。

2.1.1 小程序

button 组件的 share-mode 需要设置元素值'recentContacts'（>=基础库 1.15.0）

2.1.2 小游戏

qq.shareAppMessage ，设置 shareAppType=qqFastShareList

2.2 直接分享到原会话

当用户从某会话中打开小程序，我们预期用户有一定可能性会把小程序分享回原聊天会话。

平台提供了直接分享到原会话能力，帮助开发者减轻用户分享心理门槛。

2.2.1 生效场景

2.2.2 小程序

button 组件的 share-mode 需要设置元素值'quickToDialog'（>=基础库 1.15.0）

2.2.3 小游戏

qq.shareAppMessage ，设置 shareAppType=qqFastShare

用户可通过小程序内的按钮，快速发表说说到自己的 QQ 空间。（图片/文字/视频等，暂不支持纯文字）

调用方式：

小程序，调用qq.openQzonePublish 接口即可。

在不同分享场景，分享消息内的内容&格式，都会不同。QQ 提供不同分享消息模板，方便开发商在不同情况下使用。

后续会有更多模板持续上线，可在开发者管理端-分享模板中持续关注。

已有 App 的开发者可以通过接入 QQ 互联 SDK，让用户可以将 App 分享文字、图片、视频、网页、小程序等内容分享给 QQ 好友、QQ 群聊和 QQ 空间，开发者仅需在 QQ 互联中将已有的 App 和小程序关联后即可实现。

互联 sdk 小程序分享文档：IOS 、Android

TIP

在下列场景接收小程序类型分享，将按照开发者设定的分享参数转成网页类型分享：

为满足开发者通过二维码扫描打开指定小程序，并且跳转到指定页面的诉求，我们提供了 url 跳转小程序的能力，开发者按照下述规则生成 url ，再生成 url 对应的二维码即可使用。

url 规则： https://m.q.qq.com/a/p/{appid}?s={encodeURIComponent(path)}

参数

示例：

https://m.q.qq.com/a/p/1108291530?s=pages%2Fgame-list%2Fgame-list%3Fmode%3Dwanba

https://m.q.qq.com/a/p/1108291530?s=a%3D1%26b%3D2

warning 注意

已有 App 的开发者可以通过接入 QQ 互联 SDK ，在相同主体前提下，通过 APP 打开 QQ 小程序。

互联 SDK 下载地址：Android 、iOS

基于 QQ 的通知渠道，我们为开发者提供了可以高效触达用户的消息能力，以便实现服务的闭环并提供更佳的体验。

为满足不同场景下的消息触达，平台提供一次性订阅&长期订阅&系统订阅消息能力。（备注：授权文案不可修改，授权时机可自行决定）

推送位置：

数据统计：

【注意】

步骤一：填写服务器配置

登录小程序后台 后，在「设置」-「开发设置」-「消息推送」中，填写服务器地址（URL）、令牌（Token） 等信息。详细请查阅相关文档

步骤二：获取模板 ID

在开发者管理端 ，手动配置获取模板 ID：

步骤三：引导用户授权下发订阅消息

向用户发起主动订阅小程序授权请求。调用后会立刻弹窗询问用户是否同意主动订阅小程序。

如果用户之前已经同意授权，则不会出现弹窗，直接返回成功。（授权体系详见相关文档 ）

步骤四：调用消息下发接口

为鼓励用户在 QQ 内沉淀关系链，加强未来在 QQ 内的传播，平台支持在小程序/小游戏内用户加 QQ 好友的能力。

步骤一：引导用户授权被加好友权限

为避免骚扰，需要用户先授权在当前 appid 允许被加好友后，才能进行被加好友操作。

使用qq.authorize ，引导用户完成授权。

参数填入为 setting.addFriend

TIPS：开发者可以调用 qq.openSetting 打开设置界面，引导用户开启授权。

步骤二：加好友按钮

使用button 组件，并填入对应参数 open-type="addFriend" open-id="对方 openid" bindaddfriend="addfriend"

使用qq.createAddFriendButton 接口。

支持从小程序加群，帮助开发商维护私域流量。

小程序调用方式示例：使用button 组件，并填入对应参数 open-type="openGroupProfile"。

小游戏调用方式示例：使用qq.openGroupProfile 接口。

支持从小程序加频道，升级开发商私域流量管理能力。

小程序调用方式示例：使用button 组件，并填入对应参数 open-type="openGuildProfile"。

支持从小程序关注公众号，同时支持公众号与小程序绑定，建立 QQ 内生态闭环。

小程序调用方式示例：使用button 组件，并填入对应参数 open-type="openPublicProfile"。

小游戏调用方式示例：使用qq.openPublicProfile 接口。

1）QQ 公众号绑定小程序

a、操作地址： https://mp.qq.com/vpage/login

b、小程序管理--添加--通过 appid or 小程序名称搜索并绑定

2）公众号菜单设置跳转小程序

a、完成小程序绑定

b、自定义菜单--跳转到小程序

3）公众号解绑小程序

a、通过公众号平台操作 https://mp.qq.com/vpage/login

b、通过小程序平台操作 https://q.qq.com

4）公众号绑定小程序规则

a、公众号最多可以绑定 3 个小程序

b、解绑后，30 天内不能重复绑定同一个小程序

c、小程序可以被无限公众号绑定；且默认无需确认即可被绑定

d、小程序可以在小程序管理端，设置被公众号绑定规则：不能被绑定、可以被绑定，但需要小程序管理员确认、可以被绑定，且不需要小程序管理员确认（默认状态）

5）小程序模板&订阅消息，通过绑定公众号下发

在调用对应接口下发小程序模板消息或订阅消息同时，设定 oac_appid 为绑定的公众号 appid，此时消息将通过指定公众号下发。

需关注，若因该用户未关注公众号等情况导致消息无法触达用户，需要开发者自行处理闭环逻辑。

涉及接口为小程序模板消息 和小程序订阅消息 。小程序和小游戏皆可通用。

应用子频道为 QQ 频道的子频道类型之一，以 QQ 小程序为主要载体，是频道提供给第三方应用的开放能力之一。频道用户将借助小程序探索更多丰富多样的玩法，而频道则为小程序开发商提供更多流量和用户。

用户体验示例图：小程序开发者入驻频道且获全量推荐后，频道主可自行添加使用小程序。

主要包括三个环节：

小程序开发者在 QQ 小程序开发平台-频道接入 ，上传频道素材，小程序 UI 等根据 QQ 频道场景值（5002）进行改造和适配。

注：开发者工具适配频道场景在开发中，前期调试可在测试频道中进行

【频道接入】入口

开发者通过【频道接入】入口提供外显信息，频道列表支持展示 3 类信息。

点击应用子频道标题、应用子频道外显内容（最多 5 行），可以打开不同的小程序页面。

子频道标题、外显信息在【频道接入】中提交，示例：pages/index/index。无需单独做 url 编码。

回调链接：用户创建应用子频道时，频道后台会调用的第三方接口；第三方可通过此接口，建立/清理子频道和自己业务的映射。

配置外显信息代码介绍请参考外显信息推送

小程序作为应用子频道的一种类型，希望给频道用户一致的交互和 UI 体验，对齐其他类型子频道样式，给用户更沉浸式的频道体验。因此交互和 UI 上需要开发者做一定的适配。

如下图所示，左侧为原生 titleBar，右侧为频道 titleBar

需注意：从子频道列表点击应用子频道标题打开小程序时，频道后台会在跳转链接中带上子频道名称，需要小程序开发者将应用子频道名称填入落地页 titleBar 的 title 部分。进入小程序子频道后，点击跳转其他子页面，title 同现有小程序设置 title 流程。

频道进入没有全屏小程序，全部为频道样式导航栏。如果原来是全屏小程序，需要小程序开发者自行适配 。

注意：频道顶部titlebar，即频道头像旁边的返回按钮，支持从小程序二级页面返回一级页面，故而可以替代自带导航，隐藏后无需担心无法返回上一级页面。

平台将选取 UI 适配、玩法新颖、内容丰富的小程序在应用子频道添加面板中分享，如下图的“腾讯投票”。

针对希望被推荐和分发的小程序，平台供开发者自查规范如下：