分类： 开放能力

从基础库 2.17.3 开始支持

一、功能介绍

在前后端开发联调过程中，开发者通常会使用代理软件对自己开发的项目服务做请求转发，便于切换开发环境和进行测试。

代理软件可以在 客户端 与 真实服务器 之间进行数据传输。

这时，代理软件可以解密并查看通过 SSL 加密的数据，然后再重新加密数据发送给原始目的地。对于客户端和服务器来说，它们仍然认为自己处于一个安全的加密连接中，实际上数据的安全性已被破坏。

除了监听之外，由于代理软件可以解密 SSL 加密的通信，因此也支持修改传输中的数据，甚至插入恶意内容。上述这种中间人代理，也会被不法分子恶意使用，用于任意监听自己设备中的所有请求。

他们会在自己的设备中运行其他开发者开发的「微信小程序」、「WEB 网页」 或「原生APP」，然后通过中间代理获取和篡改正常请求的「请求包」和「响应包」，并有针对的对目标请求进行重放，用于实现恶意的目的（比如刷经验、修改游戏结果、创建 1 分钱订单等）。

为了防止中间人代理攻击，我们就需要在 SSL 加密的基础上，对请求包和响应包的明文再进行一次加密，这种方法可以提供额外的安全层次，保障数据即使在被代理软件解密后仍保持安全。

目前微信团队针对加密网络通道提供两种解决方案：

1. API 自实现方案： 微信平台维护了一个用户维度的可靠 Key，开发者可以分别通过微信小程序前端 API 和微信后台提供的服务端接口获取到，并自己实现对请求包的加密。
2. 微信网关方案： 微信团队结合多年安全防护经验积累推出的微信网关，具备系统化、多层级的安全防护能力。开发者接入后，就会将「微信小程序」到「开发者服务端」的通信链路自动从公网链路切换到微信专线链路，并且全程对请求内容进行二层加密，有效防止中间人代理攻击。

获取加密 key 信息需要向微信平台发送请求，产生耗时，从而对业务性能产生负担。如开发者希望安全加密的同时减少业务无关的耗时，可以使用微信网关方案。

二、API 自实现方案

为了避免微信小程序与开发者后台通信时数据被截取和篡改，微信平台维护了一个用户维度的可靠 Key，用于微信小程序和后台通信时进行加密和签名。

开发者可以分别通过微信小程序前端 API 和微信后台提供的服务端接口，获取到用户加密 key。

微信平台只提供可靠的加密 key，开发者需自行实现加密方式，对向服务端接口请求的数据进行端处加解密。

在微信小程序中开发者可以使用UserCryptoManager.getLatestUserKey获取获取用户最新的加密密钥信息。

2.1 前端调用示例

const somedata = 'xxxxx'
const userCryptoManager = wx.getUserCryptoManager()
userCryptoManager.getLatestUserKey({
    success({encryptKey, iv, version, expireTime}) {
        const encryptedData = someAESEncryptMethod(encryptKey, iv, somedata)
        wx.request({
           data: encryptedData,
           success(res) {
                const decryptedData = someAESDEcryptMethod(encryptKey, iv, res.data)
                console.log(decryptedData)
           }
        })
    }
})

someAESEncryptMethod 和 someAESDEcryptMethod 分别为加解密函数，由开发者自行引入加解密库来实现，基础库暂时不提供加解密能力。

开发者可参考开源加密库: https://github.com/flash1293/aes-wasm https://github.com/ricmoo/aes-js

根据自身业务情况，寻找合适的加密方式：

• 非对称加密： 客户端和服务器维护两组公私加密密钥，每次接口请求时，先对明文数据进行加密，另一方收到密文后用对应的反向密钥解密。常见的非对称加密有 RSA、DSA、ECC，非对称加密安全性高，但加解密速度慢，不太适合请求体或响应体太大的情况。
• 对称加密： 客户端和服务端维护一组密钥，每次接口请求时，对明文数据进行加密，另一方收到时用同样的密钥解密。常见的对称加密有 DES、3DES、IDEA、RC5、RC6、Blowfish，对称加密加解密速度快，适合对大数据做加解密处理，安全性有所下降。
• 整合方案： 请求时，客户端对明文用对称加密方式加密，对称密钥随机生成，然后用非对称加密方式加密前面的对称密钥，最后将密文和加密后的对称密钥内容合并发出；服务端收到时，按照反向流程进行解密，响应包也是相同的处理流程。

在开发者服务端，可以调用getUserEncryptKey后台接口获取用户最近三次的key。在获取key的同时，接口会携带version信息，开发者可以比较version版本来选择使用对应的key对数据进行加解密。

2.2 服务端调用示例

curl -X POST "https://api.weixin.qq.com/wxa/business/getuserencryptkey?access_token=ACCESS_TOKEN&openid=OPENID&signature=SIGNATURE&sig_method=hmac_sha256"

三、微信网关方案

可以参考此文档接入微信网关：微信小程序一键接入微信网关

从基础库 2.18.0 开始支持

很多微信小程序业务需要输入一些敏感信息，比如密码口令，身份证，手机号等。不专业的做法是使用明文提交到业务后台，在网络传输中非常容易泄漏出去，同时也不满足合规要求。也有一些改进的做法，利用javascript对敏感信息进行加密，比如把明文的密码口令加密成为密文后再提交到业务后台。但因为微信小程序本质是基于H5技术，安全性不高，比如在H5上使用javascript比较容易能看到加密逻辑，或者加密强度不够，第三方输入法监听，内存遍历等，还是会造成口令泄露等问题。

为提高微信开放平台生态安全性，针对微信小程序内数字密码输入场景中可能存在的安全问题，微信侧在input组件开放了安全键盘类型。通过引入安全键盘，微信小程序可以在用户输入过程中对关键信息时进行加密，防止键盘窃听，内存保护，有效保障用户数据资产的安全。

安全键盘保护原理

安全键盘采用非对称加解密算法，该算法需要两个密钥，一个叫公钥，可以公开，另一个叫私钥，需要私密保管。其中公钥加密的密文，只有私钥才能解开，而且通过公钥没办法计算出私钥，这样黑客即使拿到公钥也没办法解密密文。我们一般把公钥放到客户端上（比如微信小程序环境）做加密，私钥放到业务后台，这样就只有后台才能解密。黑客比较容易攻击本地客户端，但是攻破后台则难很多，甚至有些业务把私钥存储到硬件加密机芯片里面，这种情况黑客更是没办法获取得到私钥，因此采用非对称加解密算法是安全键盘推荐的模式，安全性可以得到保障。 为了保证私钥的私密性价值，我们要求不同的微信小程序业务使用自己独有的公钥私钥对，这样就可以完美的做到业务加密的数据隔离，业务A的公钥加密数据，就只有业务A自己的私钥可以解开，业务A的责任就是负责保护好自己的独有私钥即可。 为了证明一个公钥是属于业务A的，我们会颁发一个数字证书给到业务A的开发者，数字证书由腾讯官方签名，保证了可靠性与不可篡改性，数字证书里面会绑定一个业务独有的公钥， 业务的私钥是在向腾讯申请数字证书的过程中产生的，业务负责管理好自己的私钥，这个过程中，腾讯仅能接触到公钥，没办法得到业务自己的私钥，意味着即使是腾讯也没办法去解密微信小程序业务的用户输入的密码口令。为了国家合规的要求，我们颁发的是国产密码算法的数字证书，意味着非对称加解密算法是使用sm2算法，而非rsa等国际算法。

不同微信小程序业务，可能要加密的数据的格式可能有不同的要求，比如当用户输入的口令是“123456”，有些业务直接对明文做加密即可， 有些业务可能想先做一个哈希处理再加密，比如使用md5(“123456”), 做了哈希后，能更有效的保护用户的明文密码，让业务都不好推测用户实际密码是什么， 另一些业务可能采用sha1哈希算法sha1(“123456”), 也有业务采用更合规的国产密码哈希算法sm3（“123456”），甚至有些业务希望加上一些混淆字符（密码学中叫加盐）到口令明文里面，做更好的保护，就可能会变成sm3(“123456+abc”), 这里面”+abc”就是额外加上的混淆字符示例。 所以为了能让不同的微信小程序业务有符合自己业务需求的加密格式，微信小程序安全键盘也开放了密码格式配置的能力，从而更好的跟自己的整体业务结合在一起，但是这个格式做不到万能兼容所有，所以当你应用微信小程序安全键盘的时候，可能会涉及部分后台验密服务的改造工作量，请提前评估可行性。

使用流程

1 生成证书签署请求

开发者可自行生成公钥私钥、证书签署请求，也可通过微信侧提供的工具生成证书签署请求。通过微信侧提供的工具（Windows / Mac）生成证书签署请求的步骤如下：

1. 通过SM2 Generate Key Pair功能生成公钥私钥

2. 通过SM Generate Cert CSR功能生成CSR

2 生成证书

在微信小程序管理后台「开发」-「开发管理」-「开发设置」-「安全键盘证书」板块填入CSR进行生成。

3 使用证书

1. 将生成的证书放入微信小程序代码包中。
2. 在input组件中设置type=“safe-password”，并设置相关参数（safe-password-cert-path、safe-password-time-stamp、safe-password-length、safe-password-nonce、safe-password-salt、safe-password-custom-hash）。

代码示例

<input 
  style="border: 1px solid blue;"
  type="safe-password"
  placeholder="123456"
  safe-password-cert-path="/minipro_test_cert.crt" 
  safe-password-time-stamp="1618390369" 
  safe-password-nonce="1618390369" 
  safe-password-salt="zefengwang" 
  safe-password-custom-hash="md5(sha1('foo' + sha256(sm3(password + 'bar'))))"
  bind:blur="onBlur"
  bind:input="onInput"
  value="{{value}}"
></input>
<button bind:tap="onClear">clear</button>

<view>{{detail}}</view>

Page({
  data: {
    value: '123'
  },
  onInput(res) {
    console.log('onInput', res)
    this.setData({
      value: res.detail.value,
    })
  },
  onClear() {
    this.setData({
      value: '',
    })
  },
  onConfirm() {
    console.log('confirm')
  },
  onBlur(res) {
    console.log('onBlur', res)
    this.setData({
      detail: JSON.stringify(res.detail, null, 2)
    })
  },
})

密文

密文格式

安全键盘为了保护用户口令，采用了各种密码学算法来保护用户敏感信息，这些算法是可以根据微信小程序业务的实际需要做灵活配置的，因为不同的微信小程序，采用的口令加密格式不同，所以有必要做符合自己业务的配置。

微信小程序安全键盘对用户密码口令加密后的通用格式如下：

'V02_' + sm2(header + timestamp + '\0' + pbkdf_hmac_hex(password, salt) + '\0' + nonce + '\0' + 随机数)

其中，pbkdf_hmac_hex()为安全键盘计算hash的算法表达式，可通过safe-password-custom-hash属性进行设置。 header前两个字节，用于标识密码hash算法：

1. 0x00 0x00: custom hash
2. 0x00 0x07: pbkdf_hmac_hex

这个格式考虑了几点安全因素：

1. 防重放：传入正确的时间戳timestamp，每次加密nonce 保持自增，保证了即使口令相同，每次加密密文也不相同
2. 防暴力破解：sm2非对称算法本身保证了防暴力破解的可能
3. 防追溯原文：内置pbkdf_hmac_hex 算法，也可以自定义hash算法；
4. 防彩虹表攻击：微信小程序开发者可以自定义动态salt；

微信小程序开发者如果打算使用安全键盘，首先在本地生成sm2 秘钥对，然后前往微信小程序管理后台申请微信小程序安全键盘数字证书。证书下发下来后，需要和微信小程序代码一起发布。 微信小程序调用安全键盘时，需要传入微信小程序安全键盘数字证书，完成证书合法性校验之后，再提取证书公钥并采用sm2 算法对用户数据进行加密。 由于采用证书公钥加密，只有用开发者自己持有的私钥才可以解密出数据明文。网络传输过程中，即使密文被恶意拦截，攻击者也无法拿到明文。

如何解密或验密

'V02_' + sm2(header + timestamp + '\0' + hash(password, salt) + '\0' + nonce + '\0' + 随机数)

后台接收到密文后，参照以上格式进行解析： 1、 移除密文4字节前缀； 2、 使用微信小程序安全键盘证书对应的sm2 私钥解密，得到明文数据； 3、 解析明文数据，可以得到时间戳、密码hash、nonce 等字段；

首先，微信小程序开发者后台只能得到脱敏后的密码hash，无法得到明文。当然，根据合规要求，后台也不应该获取到用户密码明文。 其次，微信小程序开发者后台应妥善保存密码hash，作为匹配用户密码是否一致的依据。比如在用户注册或修改密码流程中，后台SM2 私钥解密出密码hash 之后，应当在数据库中（或者其它存储技术）持久化保存该密码hash。在后续用户登录或其它需要校验密码的场景，通过对比用户请求过来的密码hash 和之前保存的密码hash 是否一致，来确定密码是否验证通过。

一、功能简介

用工关系功能，支持与微信小程序有用工关系的用户能与对应的微信小程序进行绑定。绑定后

1. 微信小程序可以向已绑定的用户推送用工关系消息通知
2. 绑定用户将能在微信「微信小程序助手」中接收用工关系消息通知

通过这个功能，确保微信小程序在用工场景下的关键业务信息高效触达。

二、功能详情

支持基础库版本：3.10.0以上
支持微信版本：8.0.62以上

1、开通功能

• 此功能只支持非个人主体下的物流服务/医疗服务/政务民生/金融业/教育服务/交通服务/房地产服务/生活服务/IT科技/餐饮服务/旅游服务/商家自营/商业服务类目下的微信小程序

• 这些类目下的，可登录微信公众平台，符合类目要求即可在侧边栏找到「用工关系」，点击开通，填写申请内容后，等待审核（审核时长平均<24h）。

2、新增用工消息模版

在微信公众平台开通了用工关系功能后，可以新增所需要的用工消息模版，模版审核通过后即可使用。

3、用工关系管理接口

• 绑定用工关系接口：wx.bindEmployeeRelation
  开发者可以通过接口，给与微信小程序有用工关系的用户调用订阅弹窗，允许后的用户，可以在「微信小程序助手」插件中收到绑定系统消息。

• 解绑接口：UnbindUserB2CAuthInfo
  开发者可以通过接口，直接解绑已与微信小程序有用工关系的用户，用户可以在「微信小程序助手」插件中收到解绑的系统消息。

• 检查关系接口：wx.checkEmployeeRelation
  开发者可以通过接口，检查微信小程序用工关系功能和用户之间的绑定关系

4、用工消息订阅

拉起用工消息订阅有两个时机

1. 在用户确认绑定用工关系后，可直接让用户订阅消息，详细可见技术文档wx. bindEmployeeRelation。
2. 已绑定用工关系后，可调用接口让用户订阅消息，详细可见技术文档wx.requestSubscribeEmployeeMessage。

5、发送用工消息

在用户已绑定用工关系，且订阅了对应用工消息的前提下，开发者可以通过SendEmployeeRelationMsg 向用户发送用工消息。用户将在「微信小程序助手」中接收到对应的消息。

三、注意事项

务必确保正确使用该功能

• 此功能仅支持微信小程序在用工场景下的消息传递诉求，若在开发者其他场景滥用，则功能会被回收。
• 绑定关系弹窗和订阅消息弹窗都为强监控行为场景，请提前告知用工关系的用户，确保绑定弹窗的通过率。请勿给无用工关系的用户滥发消息，滥发会回收该功能。

一、功能介绍

聊天工具模式是为了帮助微信小程序更好与微信聊天结合而推出的模式，可用于实现群问卷、群拼单、群任务等功能。其与微信小程序普通模式相比开放更多与聊天紧密结合的能力：

1. 聊天成员相关能力：开发者可调用聊天成员选择器并获取成员相关id，通过开放数据域渲染聊天成员的头像昵称
2. 发送内容到聊天能力：开发者可发送文本、提醒、图片、表情、视频等内容类型到聊天中
3. 动态消息能力：微信小程序卡片上的辅标题可以动态更新，在用户完成或参与了活动后下发系统消息

同时，聊天工具模式需要使用独立分包基于skyline开发，该分包也可被普通模式打开。开发者可通过「微信小程序示例-接口Tab-聊天工具」入口体验平台推出的Demo：

二、开发指南

从基础库 3.7.8 开始支持

支持平台：Android：微信8.0.56及以上版本、iOS：微信8.0.56及以上版本

1. 聊天工具分包配置

开发者需要在微信小程序全局配置 (app.json)中声明 subPackages 与 chatTools：

1. subPackages 为分包的基本配置，属性说明可参考分包结构配置
2. chatTools 为聊天工具配置，类型为 Object[] ，字段包括：

注意事项：

1. desc字段请按照自己的功能设计填写，不得包含虚假或营销信息；scopes 字段请如实填写；否则将影响微信小程序审核的结果
2. 开发者需保证分包的首页路径进入后可以使用聊天工具的完整功能，否则将影响微信小程序审核的结果
3. 每个微信小程序目前仅支持配置一个聊天工具，后续可能放开
4. 聊天工具的分包体积需不超过 500KB
5. 聊天工具分包页需使用 skyline 渲染，若开发者未配置，微信会在预览或上传代码包时提示出错

配置示例：

{
  "subPackages": [
    {
      "root": "packageA",
      "name": "alias",
      "pages": ["pages/cat"],
      "independent": true,
      "entry": "index.js",
      "componentFramework": "glass-easel",
      "renderer": "skyline",
    },
  ],
  "chatTools": [{
    "root": "packageA",
    "entryPagePath": "x",
    "desc": "功能描述",
    "scopes": ["scope.userLocation"]
  }],
  "rendererOptions": {
    "skyline": {
      "disableABTest": true,
      "defaultDisplayBlock": true,
      "defaultContentBox": true,
      "tagNameStyleIsolation": "legacy",
      "sdkVersionBegin": "3.7.0",
      "sdkVersionEnd": "15.255.255"
    }
  }
}

2. 聊天工具模式的进入与退出

2.1 进入聊天模式

聊天工具模式在进入时需要绑定一个微信单聊或群聊的聊天室，目前有三种进入方式：

1. 当微信小程序处于普通模式时，开发者调用 wx.openChatTool 但不传入聊天室id，微信会拉起聊天列表让用户选择，用户选择后绑定聊天室进入聊天工具模式
2. 当微信小程序处于普通模式时，开发者调用 wx.openChatTool 并在接口中传入聊天室id（群聊为opengid，单聊为open_single_roomid），会直接绑定该聊天室进入
3. 用户在聊天工具模式里发送各种类型内容到绑定的聊天后，当用户从同一个聊天的这些内容入口再次回到微信小程序中，会使用聊天工具模式打开，此时绑定的聊天不变

2.2 退出聊天模式

聊天工具目前有三种退出方式：

1. 在聊天工具中回到非聊天工具分包页面中（包括用户自己触发返回、开发者调用 wx.navigateBack 或 wx.switchTab ），会触发退出聊天工具模式
2. 微信小程序 reLaunch 到普通页面（包括用户点击其他非聊天工具模式入口、开发者调用 wx.reLaunch 等），会触发退出聊天工具模式

注意：在聊天工具分包页，无法通过 wx.navigateTo 或者 wx.redirectTo 跳转到非聊天工具分包页。如需跳转，先通过 wx.navigateBack 退出当前聊天工具分包，再使用路由接口进行跳转。

2.3 聊天工具模式的判定

开发者可通过 wx.getApiCategory 中的 apiCategory字段是否为 chatTool，判断当前是否处于聊天工具模式。

3. 聊天成员相关能力

3.1 获取相关id接口

聊天工具模式下有以下3种id信息：

1. opengid：微信群的唯一标识id
2. open_single_roomid：单聊的唯一标识id
3. group_openid：微信用户在此聊天室下的唯一标识，同一个用户在不同的聊天室下id不同

相关接口如下：

1. wx.getGroupEnterInfo：进入聊天工具模式前，获取群聊id信息
2. wx.getChatToolInfo：进入聊天工具模式后，获取群聊id信息

这两个接口的区别在于，在聊天工具分包页，推荐用 wx.getChatToolInfo 获取绑定群相关信息即可。在进入聊天工具分包页之前，例如从群聊会话卡片打开微信小程序，此时希望复用卡片所在的群聊，可通过 wx.getGroupEnterInfo 获取卡片所在群的 opengid, 并在 wx.openChatTool 时传入，此时可不唤起群选择列表，直接进入。

3.2 选择聊天成员接口

开发者可调用wx.selectGroupMembers让用户选择聊天室的成员，并返回选择成员的group_openid。需要注意的是，若当前聊天室为单聊，则直接返回对方用户的group_openid，不再拉起选择器。

3.3 渲染聊天成员的头像昵称

开发者可通过 open-data-list 与 open-data-item 渲染聊天成员的头像昵称

4. 发送到聊天能力

可将微信小程序卡片、提醒消息、文本、图片、表情、文件发送到聊天中，相关接口如下：

1. wx.shareAppMessageToGroup：将微信小程序卡片发送到绑定的聊天室
2. wx.notifyGroupMembers：提醒用户完成任务，发送的内容将由微信拼接为：@的成员列表+“请完成：”或“请参与：”+打开微信小程序的文字链，如「@alex @cindy 请完成：团建报名统计」
3. form bind:submitToGroup="onSubmitToGroup" 与 button form-type="submitToGroup"：将输入框内的文本内容发送到绑定的聊天室
4. wx.shareImageToGroup：将图片发送到绑定的聊天室
5. wx.shareEmojiToGroup：将表情发送到绑定的聊天室
6. wx.shareVideoToGroup：将视频发送到绑定的聊天室
7. wx.shareFileToGroup：将文件发送到绑定的聊天室

5. 动态消息能力

从聊天模式中发送的微信小程序卡片，可以获得动态消息能力，该能力的用户表现包括：

1. 微信小程序卡片上的辅标题可以动态更新
2. 可以在聊天中下发系统消息，内容为：成员A+“完成了”或“参与了”+成员B+“发布的”+打开微信小程序的文字链，如「alex 完成了 cindy 发布的 团建报名统计」

该功能的开发步骤包括：

5.1 创建activity_id

服务端通过创建activity_id接口创建activity_id

5.2 声明分享卡片为动态消息

前端通过 wx.updateShareMenu 声明要分享的卡片为动态消息，请求参数如下：

注意事项：

1. useForChatTool 为 true 时，chooseType 和 participant 才会生效
2. chooseType = 1，表示按指定的 participant 当作参与者
3. chooseType = 2，表示群内所有成员均为参与者（包括后加入群）

代码示例：

wx.updateShareMenu({
        withShareTicket: true,
        isUpdatableMessage: true,
        activityId: 'xxx',
        useForChatTool: true,
        chooseType: 1,
        participant: that.data.members,
        templateInfo: {
          templateId:    '4A68CBB88A92B0A9311848DBA1E94A199B166463'
        },
)

模版区别（target_state与participator_state含义见步骤3）：

5.3 更新活动状态或用户完成情况

服务端通过 setChatToolMsg 接口更新活动状态或用户完成情况。

也可通过云开发调用，接口名 chattoolmsg.send。

调用示例：

//变更单个成员状态
{
    "activity_id": "xxx",
    "target_state":1,
    "version_type": 0,
    "participator_info_list": [
        {
            "group_openid": "aaa",
            "state": 1
        },
        {
            "group_openid": "bbb",
            "state": 1

        }
    ]
}
//变更动态消息状态
{
    "activity_id": "xxx",
    "target_state":3,
    "version_type": 0,
}

6. 聊天工具模式内禁用的能力

以下能力暂不支持聊天工具模式下使用，请开发者做好适配。

1. 聊天工具模式禁用普通转发能力，请使用上文「发送到聊天能力开放」中的接口实现：button open-type=share 和 微信小程序右上角「…-发送给朋友」
2. 聊天工具模式希望服务尽可能闭环在微信小程序中，外跳类接口暂不支持使用：
   • navigateToMiniProgram;
   • openEmbeddedMiniProgram;
   • openOfficialAccountArticle;
   • openChannelsUserProfile;
   • openChannelsLive;
   • openChannelsEvent;
   • openChannelsActivity。
3. 聊天工具模式暂不支持广告：ad 和 ad-custom

一、功能介绍

聊天工具模式是为了帮助微信小程序更好与微信聊天结合而推出的模式，可用于实现群问卷、群拼单、群接龙等功能。其与微信小程序普通模式区别在于：

1.  开放更多与聊天紧密结合的能力：

支持有「交易保障」标识的微信小程序，或「社交」、「金融-证券/期货」、「金融-公募基金」、「金融-银行」类目的微信小程序申请相关接口权限。开发者需要登录微信小程序管理后台 ，在「管理-开发管理-其他接口-聊天工具」中申请获得接口权限，审核通过后可使用。

二、开发指南

从基础库 3.12.0 版本开始支持

支持平台：iOS 8.0.65 及以上版本；Android 8.0.65 及以上版本

1. 进入聊天工具模式

开发者调用 wx. enterChatToolMode 后，可选择在 chatToolRooms 传入 opengid 以进入聊天模式，并获得聊天成员相关接口的调用权限；如果未传入 opengid，则将拉起群聊选择器；

开发者可通过 wx.isChatTool 判断当前是否处于聊天工具模式；

聊天工具模式下应使用 group_openid 作为用户唯一标识。

1.1 wx.getGroupEnterInfo

功能描述：进入聊天工具模式前，获取群聊 id 信息

入参：

返回参数（数据加密返回，解密请参考：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/group/wx.getGroupEnterInfo.html）：

1.2 wx.getChatToolInfo

功能描述：进入聊天工具模式后，获取群聊 id 信息

返回参数（数据加密返回，解密请参考：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/group/wx.getGroupEnterInfo.html）：

1.3 wx.selectGroupMembers

功能描述：选择聊天室的成员，并返回选择成员的 group-openid。若当前为群聊，则会拉起成员选择器；若当前为单聊，则直接返回对方用户的 group-openid

请求参数：

返回参数：

1.4 <open-data-list> <open-data-item>

功能描述：用于渲染聊天成员的头像昵称

属性：

<open-data-list>

<open-data-item>

代码示例：

<open-data-list type="groupMembers" members="[groupOpenID1, groupOpenID2]">
  <view class="userinfo" slot:index>
    <open-data-item class="avatar " type="userAvatar" index="{{index}}" />     <open-data-item class="" type="userNickName" index="{{index}}" />
  </view>
</open-data-list>

2. 发送到聊天能力

可支持微信小程序卡片、提醒消息、文本、图片、表情、文件的发送，如果选择了多个群聊，单次仅支持将内容发送到特定的单个群聊中。

2.1 wx.shareAppMessageToGroup

功能描述：将微信小程序卡片发送到绑定的聊天室

请求参数：

返回参数：

2.2 wx.notifyGroupMembers

功能描述：提醒用户完成任务，发送的内容将由微信拼接为：@的成员列表+“请完成：”/”请参与：”+打开微信小程序的文字链，如「@alex @cindy 请完成：团建报名统计」

请求参数：

返回参数：

2.3 form 组件

<form bind:submitToGroup="onSubmitToGroup"> <button form-type="submitToGroup">

功能描述：将输入框内的文本内容发送到绑定的聊天室，可携带返回聊天工具模式的微信小程序的小尾巴

属性：

<form>

<button>

2.4 wx.shareImageToGroup

功能描述：将图片发送到绑定的聊天室，可携带返回聊天工具模式的微信小程序的小尾巴

请求参数：

返回参数：

2.5 wx.shareEmojiToGroup

功能描述：将表情发送到绑定的聊天室，可携带返回聊天工具模式的微信小程序的小尾巴

请求参数：

返回参数：

2.6 wx.shareVideoToGroup

功能描述：将视频发送到绑定的聊天室，可携带返回聊天工具模式的微信小程序的小尾巴

请求参数：

返回参数：

2.7 wx.shareFileToGroup

功能描述：将文件发送到绑定的聊天室，可携带返回聊天工具模式的微信小程序的小尾巴

请求参数：

返回参数：

wx.updateShareMenu({
  withShareTicket: true,
  isUpdatableMessage: true,
  activityId: 'xxx',
  useForChatTool: true,
  chooseType: 1,
  participant: that.data.members,
  templateInfo: {
    templateId:  '4A68CBB88A92B0A9311848DBA1E94A199B166463'
  }
})

POST https://api.weixin.qq.com/cgi-bin/message/wxopen/chattoolmsg/send?access_token=ACCESS_TOKEN

//变更单个成员状态
{
  "activity_id": "xxx",
  "target_state":1,
  "version_type": 0,
  "participator_info_list": [
    {
      "group_openid": "aaa",
      "state": 1
    },
    {
      "group_openid": "bbb",
      "state": 1 
    }
  ]
}

//变更动态消息状态
{
  "activity_id": "xxx",
  "target_state":3,
  "version_type": 0,
}