54 lines
3.0 KiB
Markdown
54 lines
3.0 KiB
Markdown
# 企业微信获客助手配置
|
|
|
|
管理端菜单：`一诊 / 企业微信获客助手`
|
|
|
|
该功能使用当前企业的内部自建应用配置，不使用服务商第三方应用，也不需要 SuiteID、suite_ticket、永久授权码或企业扫码安装。
|
|
|
|
系统直接复用 `server/.env` 已有配置：
|
|
|
|
```ini
|
|
[work_wechat]
|
|
CORP_ID = "当前企业 CorpID"
|
|
AGENT_ID = "内部自建应用 AgentID"
|
|
CUSTOMER_ACQUISITION_SECRET = "获客助手可调用应用的 Secret"
|
|
```
|
|
|
|
兼容已有项目：没有 `CUSTOMER_ACQUISITION_SECRET` 时，会依次回退读取 `AGENT_SECRET`、`SECRET`。如果现有 `SECRET` 就是获客助手中配置的“可调用应用”Secret，无需重复配置。
|
|
|
|
企业微信管理后台还需完成三项外部配置：开通获客助手、将该内部应用设置为获客助手可调用应用、将接口服务器公网 IP 加入可信 IP。页面“验证获客助手 API”会通过只读列表接口检查这些条件。
|
|
|
|
## 官方 API 对接范围
|
|
|
|
按[企业微信获客链接管理文档](https://developer.work.weixin.qq.com/document/path/97297)完成以下五个接口：
|
|
|
|
- 获取获客链接列表 `list_link`
|
|
- 获取获客链接详情 `get`
|
|
- 创建获客链接 `create_link`
|
|
- 更新获客链接 `update_link`
|
|
- 删除获客链接 `delete_link`
|
|
|
|
“永久删除企业微信链接”会调用官方删除接口且无法恢复；“从本地移除”只退出当前分流池，不会修改企业微信后台。
|
|
|
|
获客成员来自后台管理员的 `work_wechat_userid`。管理员可管理全量；组长、医助等账号只返回 `DataScopeService` 当前角色与部门范围内的成员。同步远端链接时，非全量账号只导入 `range.user_list` 与其可见成员有交集的数据；企业微信部门 ID 尚未建立本地映射时按安全原则隐藏，不会越权放行。
|
|
|
|
`list_link` 只返回当前获客助手可调用应用通过 API 创建的官方链接。后台历史手工粘贴的 `work.weixin.qq.com/ca/...` 链接，以及其他应用创建的链接，不会出现在当前应用的同步列表中，也无法仅凭 URL 反查为官方 `link_id`。需要官方客户、统计和消息归因时，应在本页面使用“创建官方获客链接”。
|
|
|
|
链接分流只接受企业微信获客助手生成的链接：
|
|
|
|
```text
|
|
https://work.weixin.qq.com/ca/xxxxxxxx
|
|
```
|
|
|
|
“联系我”、客户群、自有网页或其他外部链接均会被拒绝；已有的非获客助手历史链接也不会参与随机分流。Secret 与 access_token 不会返回到浏览器，也不会写入接口错误日志。
|
|
|
|
如果需要为点击 IP 生成不可逆服务端哈希，可在 `[qywx_promotion]` 下额外设置独立的 `CREDENTIAL_KEY`。
|
|
|
|
公开 JS 示例：
|
|
|
|
```html
|
|
<script src="https://你的域名/api/qywx-promotion/js/分流方案KEY" defer></script>
|
|
<a href="#" data-wecom-promotion="分流方案KEY">添加企业微信</a>
|
|
```
|
|
|
|
随机分流在服务端完成。候选链接必须同时满足：方案启用、链接上线、处于有效时间段、未超过当日上限。权重越大，被选中的概率越高。
|