# 网站应用分享内容到 PC 微信

## 1、功能介绍

为方便网站应用将优质内容分享至微信，平台开放提供 PC OpenSDK 能力，支持网站应用分享内容（小程序、网页以及图片）到 PC 微信会话及朋友圈。

网站应用接入此功能后，微信 4.1.0 for Mac 或者微信 4.1.0 for Windows 及以上版本的用户，即可支持从网站应用分享内容到 PC 微信。

目前该功能正在灰度测试中。开发者在微信开放平台账号下申请网站应用、登记业务域名并通过审核且获得【发送给朋友】和【分享到朋友圈】权限后，即获得网站应用分享内容到 PC 微信特定场景的功能权限。当网站应用在已登记的业务域名发起请求时，如果用户此时在 Windows / Mac 设备已经登录了符合要求的微信客户端，且处于非锁定状态，会使用当前账号分享内容到 PC 微信。

- 对于此前已配置了业务域名且审核通过的网站应用，开发者只需重新进入业务域名编辑页重新提交，符合条件即可获得【发送给朋友】和【分享到朋友圈】能力权限。
- 对于尚未完成业务域名配置的审核已通过网站应用，需按照要求配置[业务域名](/doc/oplatform/Website_App/guide/domain)后才可获得【发送给朋友】和【分享到朋友圈】能力权限。

## 2、准备工作

- 创建网站应用并且提交审核，待审核通过
- 配置业务域名，详情可查看[网站应用业务域名配置](/doc/oplatform/Website_App/guide/domain)
- 然后，申请开通「发送给朋友」和「分享到朋友圈」权限：开发者需前往[微信开发者平台](https://developers.weixin.qq.com/platform)绑定网站应用后，前往「网站应用 - 开放能力 - 发送给朋友或分享到朋友圈」申请开通这两项能力。

![](https://testchu-7gy8occc8dcc14c3-1304825656.tcloudbaseapp.com/img%2Fmelody%2F20250811202036753.png)

## 3、接口调用说明

### 3.1 分享小程序至 PC 微信接口调用方式

请先接入 [PC OpenSDK](guideline) 后再调用此接口。

接口名： wxopensdk.shareMiniProgram

参数：

| 名称     | 是否必填 | 格式   | 描述                                                                                                                                         |
| -------- | -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| appid    | 是       | string | 当前网站应用的 appid，非小程序的 AppID                                                                                                       |
| userName | 是       | string | 需要分享的小程序的原始 id                                                                                                                    |
| txt      | 是       | string | 分享卡片的标题名称                                                                                                                           |
| thumburl | 是       | string | 分享卡片的图片地址，注意为必填。图片建议长宽比是 5:4。                                                                                       |
| path     | 否       | string | 分享 PC 小程序的启动路径，默认空                                                                                                             |
| scene   | 否       | string | 分享到的目标场景，"chat" 为聊天会话，"timeline" 为朋友圈，默认 "chat"。ticket                                                                |
| ticket   | 是       | string | 通过后台接口获取的单次调用 ticket                                                                                                            |
| timeout  | 否       | number | 微信未登录时尝试拉起微信调用接口的超时时间，单位 ms，允许 0-60000，默认 30000。若微信已登录不受该参数的影响。若设置为 0 则不会尝试拉起微信。 |

示例：

```javascript
wxopensdk.shareMiniProgram({
  appid: "wxd930ea5d5a258f4f",
  userName: "gh_d43f693ca31f",
  txt: "示例标题",
  path: "",
  thumburl:
    "https://sticker.weixin.qq.com/htdocs/zh_CN/images/index/register_3.2x47d04f.png",
  scene: "chat", // "timeline" 朋友圈
  ticket: "84_5JjOIqRU8dUjR3wVGA0_rdF0UdgvdiFZIyxi8qTaDBuann5POOKAzjbwtmE",
});
```

### 3.2 分享链接至 PC 微信接口调用方式

请先接入 [PC OpenSDK](guideline) 后调用此接口。

接口名： wxopensdk.shareLink

参数：

| 名称     | 是否必填 | 格式   | 描述                                                                                                                                         |
| -------- | -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| appid    | 是       | string | 当前网站应用的 appid，非小程序的 AppID                                                                                                       |
| txt      | 是       | string | 分享链接的标题名                                                                                                                             |
| desc     | 否       | string | 分享链接的描述名                                                                                                                             |
| thumburl | 是       | string | 分享链接的缩略图地址，注意为必填。                                                                                                           |
| url      | 否       | string | 分享链接的启动路径，默认空                                                                                                             |
| scene   | 否       | string | 分享到的目标场景，"chat" 为聊天会话，"timeline" 为朋友圈，默认 "chat"                                                                |
| ticket   | 是       | string | 通过后台接口获取的单次调用 ticket                                                                                                            |
| timeout  | 否       | number | 微信未登录时尝试拉起微信调用接口的超时时间，单位 ms，允许 0-60000，默认 30000。若微信已登录不受该参数的影响。若设置为 0 则不会尝试拉起微信。 |

示例：

```javascript
wxopensdk.shareLink({
  url: "分享链接",
  txt: "标题",
  desc: "卡片的描述",
  appid: "网站应用 appid",
  thumburl: "缩略图url",
  scene: "chat", // "timeline" 朋友圈
  ticket: "后台获取的ticket",
});
```

### 3.3 分享图片至 PC 微信接口调用方式

请先接入 [PC OpenSDK](guideline) 后调用此接口。

接口名： wxopensdk.shareImage

参数：

| 名称     | 是否必填 | 格式   | 描述                                                                                                                                         |
| -------- | -------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| appid    | 是       | string | 当前网站应用的 appid，非小程序的 AppID                                                                                                       |
| imageUrl | 是       | string | 分享的图片 url，最大 10mb。                                                                                                                  |
| scene   | 否       | string | 分享到的目标场景，"chat" 为聊天会话，"timeline" 为朋友圈，默认 "chat"                                                               |
| ticket   | 是       | string | 通过后台接口获取的单次调用 ticket                                                                                                            |
| timeout  | 否       | number | 微信未登录时尝试拉起微信调用接口的超时时间，单位 ms，允许 0-60000，默认 30000。若微信已登录不受该参数的影响。若设置为 0 则不会尝试拉起微信。 |

示例：

```javascript
wxopensdk.shareImage({
  imageUrl: "分享图片 url",
  appid: "网站应用 appid",
  scene: "chat", // "timeline" 朋友圈
  ticket: "后台获取的 ticket",
});
```

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2026 年 05 月 27 日修复参数描述
