> For the complete documentation index, see [llms.txt](https://o2oa.gitbook.io/course/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://o2oa.gitbook.io/course/ping-tai-shi-shi/yi-dong-ban-gong-pei-zhi-jie-shao/ji-cheng-dao-qi-ye-wei-xin.md).
# 集成到企业微信
{% hint style="info" %}
### 如果O2OA成功接入企业微信，O2OA将会自动从企业微信拉取所有的人员和组织进行同步，O2OA的所有人员和组织以企业微信中创建的组织架构为准（ 本地已经创建的人员和组织将保留不会被删除，可能会造成人员和组织重复 ）。
{% endhint %}
> ### O2OA接入企业微信建议先配置好企业微信应用，待组织和人员从企业微信同步完成后，再进行组织和人员的信息编辑，避免人员和组织信息的重复创建。
## 一、注册企业微信号（自行准备）
注册地址：
## 二、获取企业CropId信息
注册成功后，使用管理员账号登录企业微信，在\[我的企业]信息最后一行可以获取企业的CropId，如下图所示：
## 三、获取CropSecret信息
在管理工具 - 通讯录同步配置里进行API信息查询和配置
配置同步方式、权限，并且获取Secret，该Secret就是后续需要配置到O2OA里的**CropSecret**信息:
## 四、添加O2OA为企业微信自建应用
注册成功后，使用管理员账号登录企业微信，如下图所示：
点击\[应用与小程序]，如下图所示界面：
如上图所示，点击\[创建应用]，继续在自建程序区域创建应用：
填写好应用相关信息后进行应用创建：填写好应用相关信息后进行应用创建：
```
应用LOGO：可以自行制作合适大小的LOGO，此LOGO将在企业微信中展示。
应用名称：此应用的具体名称，可以随意命名，如O2OA，企业办公，XXOA都可以。
应用介绍：此应用的具体用途介绍。
可见范围：可使用此应用的人员范围设定，可以选择组织和个人成员。
```
应用创建完成后，如下图所示界面：
您可以在界面中获取**AgentId**信息，这两个信息以及之前获取的CropId将配置到O2OA相关的接入配置中，请牢记此信息。
### **网页授权及JS-SDK**
授权文件放置路径：o2server/servers/webServer/
### **工作台应用主页**
> [https://open.weixin.qq.com/connect/oauth2/authorize?appid=CORPID\&redirect\_uri=https%3A%2F%2F\[host\]\[port\]%2Fx\_desktop%2Fqiyeweixinsso.html%3Fredirect%3Dportalmobile.html%3Fid%3D\*\*\*\*\*\*\*\*\*\&response\_type=code\&scope=snsapi\_base\&agentid=1000004\&#wechat\_redirect](https://o2oa.gitbook.io/course/ping-tai-shi-shi/yi-dong-ban-gong-pei-zhi-jie-shao/www.o2oa.net)
其中：
```
appid : 企业的corpId
host : O2OA服务器提供服务的域名
port : O2OA服务器提供服务的端口
AgentId : 应用的agentId
```
{% hint style="info" %}
**redirect\_uri参数需要使用urlencode进行编码，不然会遇到50001错误，redirect\_uri不是可信域名。**
**这个url是：**[**http://\[host\]:\[port\]/x\_desktop/qiyeweixinsso.html?redirect=portalmobile.html?id=\*\*\*\*\*\*\*\*\*\*\*\***](https://o2oa.gitbook.io/course/ping-tai-shi-shi/yi-dong-ban-gong-pei-zhi-jie-shao/www.o2oa.net) **这样的形式。后面跟了一个redirect参数，就是需要跳转到一个门户页面，id就是门户的id，不配置这个参数也行，进入的是一个默认的待办列表页面。**
{% endhint %}
## 五、O2OA接入配置
1、进入o2oa安装目录，从o2server/configSample 目录下拷贝 qiyeweixin.json 到 o2server/config 目录（如果已经复制过了，请跳过此步骤）；
2、使用文本编辑器打开qiyeweixin.json进行编辑：
```
{
"enable": false,
"syncCron": "10 0/10 * * * ?",
"forceSyncCron": "10 45 8,12 * * ?",
"apiAddress": "https://qyapi.weixin.qq.com",
"corpId": "",
"corpSecret": "",
"agentId": "",
"token": "",
"encodingAesKey": "",
"messageEnable": true
}
```
参数说明：
```
"enable": "是否启用企业微信接入: true | false",
"syncCron": "拉入同步时间表达式, 默认每10分钟同步一次(10 0/10 * * * ?).",
"forceSyncCron": "强制拉入同步cron, 默认在每天的8点和12点强制进行同步(10 45 8,12 * * ?)",
"apiAddress": "企业微信api服务器地址, https://qyapi.weixin.qq.com",
"corpId": "企业微信参数corpId（从企业微信后台管理信息中获取 '企业ID'）",
"corpSecret": "企业微信参数corpSecret（从企业微信后台管理信息中获取 'Secret'）",
"agentId": "企业微信参数agentId（从企业微信后台管理信息中获取 'AgentId'）",
"messageEnable": "是否允许推送消息到企业微信: true | false"
```
{% hint style="info" %}
**token**和**encodingAesKey**可以先填1，不然无法进行保存，对微信集成不会产生影响。
{% endhint %}
完成以上配置后重启O2OA，即可完成O2OA在企业微信中的接入，可以在企业微信 - 工作台中看到自己配置的企业应用。
{% hint style="info" %}
**O2OA集成到微信时，需要将O2OA的HTTPS开启。方法请参考**[**《如何配置O2OA服务器来启用HTTPS（SSL）》**](https://my.oschina.net/u/3931542/blog/2999285)
{% endhint %}
## **六**、手工从企业微信拉取组织人员数据
服务地址：http\://**localhost**:20030/x\_program\_center/jest/index.html
服务名称：QiyeweixinAction.pullSync
如下图所示界面，点击GET之后，观察服务器控制台或者日志文件信息（o2server/logs），可以查看到同步日志。
{% hint style="info" %}
**不要多次点击GET，**点击一次后，控制台会有，正在拉取组织人员信息相关的日志。
{% endhint %}
