43 lines
1.7 KiB
Markdown
43 lines
1.7 KiB
Markdown
# 企业微信推广助手配置
|
||
|
||
管理端菜单：`一诊 / 企业微信推广助手`
|
||
|
||
该功能使用企业微信“服务商第三方应用”授权模式。服务商参数只保存在服务器环境变量中，企业永久授权码会使用 AES-256-GCM 加密后存入数据库。
|
||
|
||
在 `server/.env` 中增加：
|
||
|
||
```ini
|
||
[qywx_promotion]
|
||
ENABLED = true
|
||
PROVIDER_CORP_ID = "服务商企业 CorpID"
|
||
SUITE_ID = "第三方应用 SuiteID"
|
||
SUITE_SECRET = "第三方应用 SuiteSecret"
|
||
TOKEN = "应用指令回调 Token"
|
||
AES_KEY = "应用指令回调 EncodingAESKey"
|
||
CREDENTIAL_KEY = "至少32字节的独立随机密钥"
|
||
REDIRECT_URI = "https://你的域名/api/qywx-promotion/auth/callback"
|
||
ADMIN_RETURN_URL = "https://你的域名/admin/first_visit/wecom_promotion"
|
||
```
|
||
|
||
企业微信服务商后台需要配置：
|
||
|
||
- 应用指令回调 URL：`https://你的域名/api/qywx-promotion/provider/callback`
|
||
- 授权完成回调域名：与你的 `REDIRECT_URI` 域名一致
|
||
|
||
保存配置并让企业微信成功推送一次 `suite_ticket` 后，管理端的“发起企业授权”按钮才会生成安装链接。
|
||
|
||
推广链接默认仅允许企业微信官方域名。如需跳转企业自有的可信中间页，可在环境变量中追加：
|
||
|
||
```ini
|
||
ALLOWED_LINK_HOSTS = "promo.example.com,crm.example.com"
|
||
```
|
||
|
||
公开 JS 示例：
|
||
|
||
```html
|
||
<script src="https://你的域名/api/qywx-promotion/js/分流方案KEY" defer></script>
|
||
<a href="#" data-wecom-promotion="分流方案KEY">添加企业微信</a>
|
||
```
|
||
|
||
随机分流在服务端完成。候选链接必须同时满足：方案启用、链接上线、授权企业有效、处于有效时间段、未超过当日上限。权重越大，被选中的概率越高。
|