# 平台入驻文档

# 亮点

# 1.机器人

  • 便捷:通过开放接口的形式,QQ 开放平台允许开发者进行机器人定制化开发。
  • 高效:提供一套标准化、易接入的API与websocket事件,可以帮助开发者实现机器人的快速开发和迭代。
  • 趣味:机器人创新 C 端交互方式,通过指令的方式承载服务,让多样化服务变得触手可达。
  • 赋能:频道、群、单聊等QQ场景全面打通,深度融入QQ社交生态,用户基础大,服务范围广。

# 2.小程序

  • 开放:快速进驻和多场景应用曝光,助力小程序/小游戏进入亿级流量通道。
  • 多样:打通即时通讯(QQ)与异步社交(Qzone) ,最大化地进行社交流量传播。
  • 赋能:围绕广告、支付等商业化模式提供解决方案,让开发者更专注于业务。
  • 兼容:支持多种小程序框架,兼容现有小程序语法,降低接入门槛。

# 阅读文档

# 1.机器人

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

# 2.小程序

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

# 注册开放平台账号

# 1.个人主体

步骤总览

# 1.1 点击「立即注册」

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

# 1.2 选择个人

# 1.3 填写邮箱

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

# 1.4 激活邮箱

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

绑定管理员

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

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

# 2.企业主体

步骤总览

注意:

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

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

# 2.1 点击「立即注册」

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

# 2.2 选择企业

# 2.3 填写邮箱

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

# 2.4 激活邮箱

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

# 2.5 上传工商信息

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

# 2.6 绑定管理员

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

# 2.7 资质审核

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

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

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

资质审核详细流程

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

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

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

    • 打款账号主体:深圳市腾讯计算机系统有限公司,打款银行账号:755901658210820
  • 审核中-校验金额: 收到打款后,请在规定时间内于开发者管理端回填收到的打款金额进行验证。

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

# 3.开发QQ机器人

# 3.1 创建机器人

# 3.1.1 点击「创建机器人」

# 3.1.2 机器人资料填写页面

# 3.1.3 进入管理端

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

# 3.2 机器人发布流程

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

# 3.3 基础信息设置

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

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

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

操作步骤:

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

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

(3)等待审核通过

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

# 3.4 开发场景选择

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

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

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

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

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

温馨提示

(1)配置沙箱群/频道,需要先在QQ客户端创建符合沙箱要求的QQ群/QQ频道;

(2)在频道场景,机器人仍然保留「公域」/「私域」机器人的区分,设置为公域机器人保存确认后不可切换为私域机器人,但在「使用范围与人员」可设置公域机器人的允许添加范围:"全部用户可添加"/"仅白名单用户可添加";

(3)配置沙箱频道/群后,机器人会出现在沙箱频道/沙箱群的机器人列表当中。

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

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

3.4.2.1 添加到沙箱频道

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

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

温馨提示

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

【进入私信沙箱】

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

温馨提示

指令、服务和快捷菜单模块暂不需要单独提审,自测完成后,填写自测报告与自测报告一起提审

3.4.2.2 添加到沙箱群

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

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

温馨提示

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

3.4.2.3 添加到沙箱账号消息列表

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

# 3.5 开发基础设置

获取与配置开发所需信息

# 3.5.1 机器人 AppID

此处主要展示机器人QQ号AppIDTokenAppSecret

温馨提示

此信息不要对外传播

# 3.5.2 回调地址

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

# 3.5.3 消息 URL 白名单配置

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

温馨提示

域名需提前进行 ICP 备案,并通过域名校验才可报备成功。

# 3.5.4 频道用户意见反馈

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

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

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

温馨提示

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

# 3.6. 发布设置

开发者可以通过【发布设置】来配置机器人指令与服务,此处配置的指令与服务将会在C端指令面板、资料卡等处展示,以便用户与机器人快捷完成交互,后端逻辑均需通过代码开发实现。

# 3.6.1 功能配置

功能配置分为服务配置、指令配置、快捷菜单配置。其中指令面板对应C端频道、群、消息列表单聊场景下输入框"/"拉起的指令面板,指令面板的服务与指令在"服务配置"、"指令配置"页面分别操作配置;快捷菜单对应C端消息列表单聊场景下拉起的输入框下的功能面板,快捷菜单的服务与指令在同一页面下操作配置。

3.6.1.1 服务配置

消息列表单聊、群聊、频道文字子频道 "/" 指令面板与机器人资料卡「服务」所展示的供用户快捷跳转机器人服务小程序页面的功能,开发者需在管理端配置,可配置功能上限为24个。

  • 名称 :请简单凝练的描述功能,字数不超过8个中文字符或 16个英文字符,内容需符合平台运营规范。
  • 介绍 :请简单的对功能进行介绍,字数不超过40个中文字符或 80个英文字符,内容需符合平台运营规范。
  • appID :请输入小程序服务的ID号。
  • path :请输入小程序的路径。
  • extendData :请输入小程序extendData目前仅频道场景可用

参考:获取频道和当前人信息|QQ机器人文档

  • 权限菜单 :请选择本服务是开放给所有用户还是仅针对管理员。

  • 使用场景 : 请选择该指令所需配置的用户场景,包括QQ频道、频道私信、QQ群、消息列表等共四个场景,实际所展示的可配置场景取决于当前机器人开发者的角色、所具备的场景权限和沙箱配置状态。

注意

extendData仅支持在频道场景下开放频道ID、子频道ID,群场景、消息列表单聊场景暂无相关字段开放

当配置了extendData字段且使用场景同时支持频道及其他场景时,用户在非频道场景打开该服务小程序,频道ID、子频道ID返回为空。

3.6.1.2 指令配置

消息列表单聊、群聊、频道文字子频道 "/" 指令面板与机器人资料卡「指令」所展示的供用户快捷输入的指令入口,开发者需在管理端配置,可配置功能上限为24个。

  • 指令名 :请简单凝练地描述指令,字数不超过8个中文字符或16个英文字符,内容需符合平台运营规范。

  • 指令介绍 :请简单的对指令进行描述,字数不超过15个中文字符或30个英文字符,内容需符合平台运营规范。

  • 权限菜单 :请选择本指令是开放给所有用户还是仅针对管理员。

  • 使用场景 :请选择该指令所需配置的用户场景,包括QQ频道、频道私信、QQ群、消息列表等共四个场景,实际所展示的可配置场景取决于当前机器人开发者的角色、所具备的场景权限和沙箱配置状态。

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

3.6.1.3 快捷菜单

服务

开发者需在管理端配置用于 C 端的消息列表单聊场景快捷菜单的小程序服务,可配置功能上限为12个。

  • 名称 :请简单凝练的描述功能,字数不超过8个中文字符或16个英文字符,内容需符合平台运营规范。
  • 介绍 :请简单的对功能进行介绍,字数不超过40个字或80个英文字符,内容需符合平台运营规范。
  • appID :请输入小程序服务的ID号。
  • path :请输入小程序的路径。

指令

开发者需在管理端配置用于 C 端的消息列表单聊场景快捷菜单的功能指令,可配置功能上限为12个。

  • 指令名 :请简单凝练地描述指令,字数不超过8个中文字符或16个英文字符,内容需符合平台运营规范。
  • 指令介绍 :请简单的对指令进行描述,字数不超过15个中文字符或30个英文字符,内容需符合平台运营规范。

注意

指令、服务和快捷菜单模块暂不需要单独提审,自测完成后,填写自测报告与自测报告一起提审

# 3.6.2 自测报告

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

# 3.7 使用范围与人员配置

开发者可根据机器人实际运营需要控制可添加机器人至频道、群、消息列表单聊的范围。

  • 机器人首次上线前,开发者可配置各场景下机器人使用范围为"全量"/"白名单",切换为白名单后需等待机器人完成首次上线审核后方可配置添加白名单。

  • 机器人首次上线后,使用范围的从"全量"切换为"白名单"无需等待审核结果,立即生效;使用范围从"白名单"切换为"全量"时需要等待审核结果。

  • 审核结果返回前,不可重复提交审核。

  • 频道白名单、群白名单、消息列表单聊用户白名单上限各20条。

温馨提示

  • 将频道/群/消息列表单聊的使用范围设置为全量,即允许全部频道/群/用户通过机器人资料卡添加该机器人,开发者可将机器人资料卡通过链接、二维码等形式分享给频道主/群主/管理员、用户进行机器人添加
  • 频道/群/消息列表单聊的使用范围设置为白名单,即仅允许白名单内频道的频道主/管理员、群的群主/管理员、用户通过资料卡添加该机器人至对应频道群、消息列表单聊;
  • 将指定频道、群、用户从白名单删除后,并不会在C端移除机器人与该频道、群、用户的关系链,但在QQ客户端操作机器人移除后,无法再通过机器人资料卡添加该机器人,并可能影响机器人在该关系链场景的消息对话服务。

# 3.8 成员管理

# 3.8.1 角色

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

  • 管理员 :支持修改,但仅管理员本人可操作
  • 普通成员 :可添加最大限度为50
# 3.8.2 权限
  • 登陆权限 :拥有该权限的成员可登陆和查看开发者管理端信息,但不可编辑。

  • 发布权限 :拥有该权限的成员可编辑和提交服务、指令等模块。

  • 开发设置 :拥有该权限的成员可编辑和提交回调地址、URL 模块。

温馨提示

登陆权限是基础权限,要拥有发布权限和开发权限的前提是拥有登陆权限

# 3.9 高阶功能

# 3.9.1 基础消息功能

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

  • 被动消息 :严格的 AB 对话形式(用户艾特机器人发送 A,机器人回复 B),被动消息有效期为5分钟。
  • 主动消息 :主动触发类型的消息,满足条件机器人主动发送(如定时提醒),主动消息无需在管理者平台进行上传审核。

【主动消息限制 】

  • 主动消息每日每个频道限制发送20条,且仅允许在2个子频道下发主动消息。
  • 暂不开放"入群欢迎语"服务。
  • 监听事件"当机器人被添加进频道"后,限制机器人仅在1个子频道内下发主动消息。
  • 普通消息不支持图文+文本,如需配置图文+文本,可使用ark消息实现。
# 3.9.2 Markdown能力申请
  • 申请方式:点击 QQ机器人消息模板能力,填写申请表进行能力申请。

  • 申请条件:

    • 私域机器人:已审核上架、使用目的 场景合理;
    • 公域机器人:已审核上架、过去7天平均使用频道数达3个及以上、使用目的 场景合理。
    • 群机器人:已审核上架、过去7天平均使用群数达3个及以上、使用目的 场景合理。
  • 审核周期: 每月15-20日统一审核,审核结果会进行邮件通知。

机器人平台联系邮箱:QQ_Bot_API@Tencent.com

# 4.开发QQ小程序

# 4.1 创建小程序

# 4.1.1 点击「创建小程序」

# 4.1.2 小程序资料填写页面

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

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

# 4.1.3 开发设置
  • 基础库最低版本:建议设置为 1.0.15/1.0.0
  • 服务器配置
# 4.1.4 成员管理
  • 路径:权限管理——成员管理
# 4.1.5 选择服务类目

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

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

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

# 4.2 编码开发小程序

# 4.2.1 编码开发小程序

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

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

# 4.2.2 提交审核

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

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

# 4.2.3 小程序发布

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

# 4.3 审核发布

# 4.3.1 提审前

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

# 4.3.2 代码提审
  • 审核时效:审核一般为 1-3 个工作日。不支持催审,请耐心等候审核验收结果
  • 审核结果:请自行在后台查收,如审核不通过,则按照要求修正后
  • 审核申诉:如对审核结果有异议,请直接在后台的站内信中有个申诉入口,进行申诉即可

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

# 4.4 发布

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

# 4.5 上线运营

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

# 4.6 开放能力

# 高级接口

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

# 开发能力

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

# 支付能力

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

1.QQ 钱包

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

2.腾讯计费

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

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

3.支付接入指引

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

后台管理端会自动根据小程序选择的类目,展示接入 QQ 钱包、微信支付或米大师的页面。如有错误,请联系 qq-miniprogram@tencent.com 邮箱沟通修改。

3.2 虚拟支付

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

  • 接入说明:目前平台虚拟支付的米大师支付方案(支持 QQ 钱包+微信支付)正在内测阶段;

3.3 实体支付

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

(2)微信支付

# 广告能力

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

1. 流量主

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

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

1.1 准入条件

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

1.2 申请办法

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

1.3 相关文档

2. 广告主

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

  • 广告买量指引路径:管理端-我要推广。蓝色箭头为指引文档。中间的投放展示,是支持落地小程序/小游戏的资源位置。

# QQ 互联

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

  • 已进驻 QQ 互联的开发者
  1. 申请 unionID 能力 在 QQ 互联中,将同一个开发者账号下的多个应用可以申请 unionID 打通。

请注意:

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 个月处理 所有存量数据。

  1. 开发者需要先登录 QQ 互联注册账号;
  2. 在使用小程序的 AppID、AppSecret 在 QQ 互联-管理应用页面中添加绑定小程序;
  3. 选中需要创建的应用(App、小程序等)创建 unionID。

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

# 社交分享

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

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

  • 分享面板&最近联系人列表
  • 快速分享能力
  • 设置多种分享消息模板

1. 分享面板&最近联系人列表

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

有以下两种调用方式:

  • qq.showShareMenu
  • 小程序/小游戏内调用分享组件

1.1 qq.showShareMenu

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

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

qq.showShareMenu

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

1.2.1 小程序

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

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

1.2.2 小游戏

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

案例:

小程序内调用分享组件

2. 快速分享能力

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

3. 一键发空间说说

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

调用方式:

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

4. 设置多种分享消息模板

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

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

# 外部分享

1. 从外部 App 分享

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

互联 sdk 小程序分享文档:IOSAndroid

TIP

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

  • Mobile QQ ≥ 8.1.0
  • PC QQ
  • macOS QQ
  • iPad
  • AndroidPad

2. 通过二维码打开

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

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

参数

属性 类型 默认值 必填 说明
s string 需要跳转到的指定页面路径,如果需要传入参数,可以拼在路径之后,此参数需要进行 url encode

示例:

  1. 打开小程序,appid 为 1108291530,path 为 pages/game-list/game-list,参数为 mode=wanba,url 如下:

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

  1. 打开小游戏,appid 为 1108291530,(小游戏不涉及 path),参数为 a=1&b=2,url 如下:

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

warning 注意

  1. s 参数必须进行 encode
  1. QQ 低版本的场景会展示为默认页,不需要额外做兼容逻辑
  1. url 生效版本如下:
  • Android QQ Version ≥ 8.05
  • iOS QQ Version ≥ 8.03

3. 外部 APP 打开小程序

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

互联 SDK 下载地址:AndroidiOS

# 消息触达

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

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

  • 一次性订阅:一次授权下发一条,可推送小程序/小游戏内最新活动/版本信息/回流活动等。(进行长线的用户关系维护,从而提高用户活跃和留存)
  • 长期订阅:小程序/小游戏累计用户数达到 20w 后自动开通该能力,用户授权同意后,小程序/小游戏每天可向用户下发一条社交互动类消息。
  • 系统订阅:一次授权,当有用户成功触发互动行为(排行超越、赠送礼物)时由平台下发消息

推送位置:

  • 一次性订阅&系统订阅消息:QQ 提醒

  • 长期订阅消息:QQ 主界面下拉-右上角信封-小程序通知(如果存在订阅消息的未读通知,小程序/小游戏 icon 和信封会有红点显示)

数据统计:

  • 一次性订阅&系统订阅消息:场景值=2102,场景名称为“QQ 提醒”
  • 长期订阅消息:场景值=2085,场景名称为“长期订阅消息”

【注意】

  • 原模板消息接口已全部停用,开发者管理端入口已下线,模板消息相关接口调用失败,请改为使用上述订阅消息进行消息通知
  • 长期订阅仅用于社交互动类消息下发,如果是版本/活动等信息推送请使用一次性订阅下发;对于已经停用的长期订阅模板,管理端已经进行了标红提示,请从模板库中重新选择合适的模板使用。
  • 长期订阅消息授权开关的有效期为一周,如果用户一周未登陆小程序/小游戏则授权自动关闭,小程序/小游戏无法再向用户下发消息(错误码:46006),需要引导用户进入小程序/小游戏设置页面重新打开授权开关后才可继续下发消息

使用说明

步骤一:填写服务器配置

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

步骤二:获取模板 ID

开发者管理端,手动配置获取模板 ID:

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

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

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

  1. 小程序端授权接口
  2. 小游戏端授权接口

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

  1. 小程序端消息订阅接口
  2. 小游戏端消息订阅接口

授权弹窗展示

审核说明

  1. 标题 标题意思不能存在过度相似 标题不能带特殊符号、个性化字词等没有行业通用性的内容 标题必须能体现具体服务场景 标题不能涉及营销相关内容,包括不限于:消费优惠类、购物返利类、商品更新类、优惠券类、代金券类、红包类、会员卡类、积分类、活动类等营销倾向通知
  2. 关键词 同一标题下,关键词不能存在相同 同一标题下,关键词不能存在过度相似 关键词不能带特殊符号、个性化字词等没有行业通用性的内容 关键词内容示例必须与关键词对应匹配 关键词不能太过宽泛,需要具有限制性,例如:“内容”这个就太宽泛,不能审核通过
  3. 违规说明 除不能违反运营规范外,还不能违反以下规则,包括但不限于: 不允许恶意诱导用户进行触发操作,以达到可向用户下发模板目的 不允许恶意骚扰,下发对用户造成骚扰的模板 不允许恶意营销,下发营销目的模板
  4. 处罚说明 根据违规情况给予相应梯度的处罚,一般处罚规则如下: 第一次违规,删除违规模板以示警告, 第二次违规,封禁接口 7 天, 第三次违规,封禁接口 30 天, 第四次违规,永久封禁接口 处罚结果及原因以站内信形式告知

温馨提示

  1. 用户主动订阅路径 第一次进入小游戏/小程序时若选择“暂不接受”订阅消息,后续仍可通过“浮点-关于-设置-小程序订阅消息“开启该功能。
  2. 增加“订阅”图标 为了提升该能力的利用率,开发商可以在小游戏/小程序界面中添加”订阅“的图标,并且为订阅的用户提供一定的小游戏/小程序奖励,激励用户主动添加该功能。(下图为《一起打桌球》游戏界面)

  1. 用户分层 我们建议小游戏/小程序在发送通知时进行用户分层,针对不同的用户群体推送不同内容的信息,如对流失用户推出回流礼包,对新注册用户推出新手礼包,对老用户进行版本和活动通知等。
  2. 推送内容建议 为提升用户体验,推送文案可以设计得诙谐有趣。
# 私域流量运营

加好友能力

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

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

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

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

参数填入为 setting.addFriend

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

步骤二:加好友按钮

  1. 小程序调用方式示例

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

  1. 小游戏调用方式示例

使用qq.createAddFriendButton接口。

加群能力

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

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

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

加频道能力

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

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

公众号能力

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

  1. 关注公众号

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

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

  1. 绑定公众号

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 频道

1. 应用子频道介绍

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

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

用户体验示例图

主要包括三个环节:

  • 上架小程序至应用子频道推荐池:需通过基础安全审核、根据频道场景适配 UI 样式,并按需求调用接口开展新玩法
  • 平台筛选优质小程序分发
  • 管理员添加小程序至子频道列表

1.1 上架小程序至应用子频道推荐池

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

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

【频道接入】入口

入口

1.1.1 上传小程序介绍素材

  • 开发者通过【频道接入】入口提供上架素材内容,帮助频道用户更好地理解小程序的玩法和用途,吸引频道主添加
    • 子频道 icon 图片:规范是156x156 px,正方形,直角
    • 子频道名称
    • 子频道描述
    • 子频道预览图:最多 3 张,规范是918x1506 px,矩形,直角,期望效果参考 APPstore 的应用预览图

上传小程序介绍素材

  • 开发者提交图片和文案后,需通过 QQ 开发平台的安全审核,通过的素材内容将正常展示在开发者选取的测试频道中,可供体验 UI 和功能的完整性。
    • 应用子频道走快速过审流程,请及时刷新审核状态。如超过2天审核状态未变化,请联系qq-miniprogram@tencent.com,说明提审时间、小程序 appid,由专门的运营人员对接联系。
  • 开发者在开放平台可下拉选择测试频道,当操作者为小程序的管理员或开发权限的 QQ 号,该 QQ 号作为频道主或管理员的频道,将会出现在下拉选项中。
    • 如需配置超过 5 个的测试频道,请发送申请邮件至 qq-miniprogram@tencent.com,内容需包含小程序名称、appid、测试频道外显频道号和需要申请超过 5 个测试频道的理由。
    • 重点提示:开发者可优化 UI 和体验争取被推荐,而非单独申请配置,应用商店搜索能力开发中。
    • 目前在管理端频道接入后,只能在配置的不超过5个频道能被添加体验,如需申请全量,后续有专门的申请上推荐功能,待开放。前期如需申请全量,请联系qq-miniprogram@tencent.com,说明申请理由和体验录屏,由专门的运营人员对接联系。

1.1.2 配置外显信息

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

    • 应用子频道标题:小程序开发者提交默认名称,但频道主/管理员可修改。如示例图的【开黑组队】。
    • 应用子频道副标题:由小程序开发者通过后端接口,推送至频道后台。如示例图的【36 支车队招募中】。
    • 应用子频道外显内容(最多5行):由小程序开发者通过后端接口,推送至频道后台。

    36支车队招募中

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

    • 点击跳转不同的页面。
  • 子频道标题、外显信息在【频道接入】中提交,示例:pages/index/index。无需单独做 url 编码。

    • 跳转链接:分为子频道跳转链接和外显信息跳转链接,由第三方配置,链接中可以选择配置指定参数占位符,频道后台会在解析时替换占位符返回到客户端。
  • 回调链接:用户创建应用子频道时,频道后台会调用的第三方接口;第三方可通过此接口,建立/清理子频道和自己业务的映射。

    回调

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

1.1.3 小程序适配子频道 titleBar

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

  • 小程序原生 titleBar :右侧有胶囊;
  • 改造后的频道 titleBar:返回箭头+频道 icon + title+分享按钮

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

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

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

    • 需要适配的样式问题举例: titlebar_demo

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

1.1.4 小程序内调用接口获取频道相关数据

  • 获取用户openid:调用小程序后端登录接口
  • 获取频道身份组信息:小程序 API 接口,getGuildRoles,可获取用户身份组信息

1.2 平台筛选优质小程序分发

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

vote_app

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

  • 应用子频道内目前所有场景不可出现广告,需根据5002场景值做屏蔽
  • 应用子频道 titleBar 在所有场景需显示应用子频道规范的名称及频道头像
  • 除了 titleBar 区域内,应用子频道其他场景中不出现重复的返回按钮;小程序开发者用平台提供的左上角返回按钮即可
  • 页面适配完整,不出现因为未适配导致的页面某块区域留白
  • 所有写入场景(包括文字、图片、语音等),需接入 QQ 侧安全审核
  • 所有界面中不可出现按钮、文字重叠现象
  • 同一场景下,所有字体类型、大小统一,无明显字体不匹配现象

1.3 管理员添加小程序至频道列表

  • 管理员添加应用子频道入口:
    • 频道列表点击“+”
    • 频道资料页——子频道管理——右上角“+”——新建子频道
  • 添加应用子频道流程:
    • 新增子频道-选择应用频道
    • 选择对应的应用子频道(小程序)
    • 设置频道名称、可见范围
    • 打开应用子频道,使用该小程序

add_app_to_guild