# Frappe WXWork

**Repository Path**: mediad/frappe-wxwork

## Basic Information

- **Project Name**: Frappe WXWork
- **Description**: Frappe企业微信接入
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 24
- **Created**: 2025-03-31
- **Last Updated**: 2026-04-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Frappe WXWork

Frappe企业微信接入

#### 安装方法：
  - `$ bench get-app https://gitee.com/mediad/frappe-wxwork.git`
  - `$ bench --site <your-site> install-app frappe_wxwork`
#### 功能：
- 企业微信登录
  - <font color="success">【已完成】</font>企业微信扫码登录
  - <font color="success">【已完成】</font>企业微信授权登录
  - <font color="success">【已完成】</font>企业微信客户端无密码登录
- 微信登录
  - <font color="success">【已完成】</font>微信授权登录
  - <font color="orange">【未开始】</font>微信扫码登录
- 企业微信通知
  - <font color="success">【已完成】</font>系统通知
  - <font color="orange">【未开始】</font>邮件通知
  - <font color="orange">【未开始】</font>工作流快捷处理通知

#### 设置

##### 1. 添加企业微信社交登录密钥
**位置：企业微信 > 社交登录密钥**
<br>
企业微信身份验证区分网页授权登录和扫码登录，两者的授权URL不同，可根据自己的情况选择使用。
<br>
<br>
![企业微信授权登录](https://mediad.s3.mediad.cn/frappe_wxwork/企业微信授权登录.jpg)
<br>
**企业微信授权登录**
<br>
企业微信授权登录要求在微信或企业微信中打开。
<br>
参考文档：[构造网页授权链接](https://developer.work.weixin.qq.com/document/path/91022)
<br>
<br>
![企业微信扫码登录](https://mediad.s3.mediad.cn/frappe_wxwork/企业微信扫码登录.jpg)
<br>
**企业微信扫码登录**
<br>
参考文档：[Web登录组件](https://developer.work.weixin.qq.com/document/path/98152)


##### 2. 绑定企业微信用户
**位置：企业微信 > 企业微信用户**
![企业微信用户](https://mediad.s3.mediad.cn/frappe_wxwork/企业微信用户.jpg)
<br>
用户名可以在企业微信后台通讯录中查看，可批量导出。
<br>
建议批量导入企业微信用户。


##### 3. 网页授权登录 
  - 企业微信后台进入应用设置
  - 设置**网页授权及JS-SDK**、**企业微信授权登录**、**企业可信IP**
  - 将主页或菜单中的ERP链接设置为 https://{erp域名}/api/method/frappe_wxwork.oauth2_logins.authorize?provider={网页授权登录的社交登录密钥名称}&redirect_to={登录成功后的跳转url}

##### 4. 扫码登录
  - 企业微信后台进入应用设置
  - 设置**网页授权及JS-SDK**、**企业微信授权登录**、**企业可信IP**

![社交登录密钥](https://mediad.s3.mediad.cn/frappe_wxwork/4.png)
![社交登录密钥](https://mediad.s3.mediad.cn/frappe_wxwork/5.png)

#### License

mit