Appearance
企业微信(企业内部开发)
平台集成企业微信
,可以实现:企微单点登录、组织信息同步、企微API调用,等诸多能力
1.创建自建应用
使用企微管理员账号
,登录企业微信管理后台,并创建自建应用
特别说明
必须是企微管理员账号
,普通账号不具备相关权限

设置应用图标、名称,并设置应用可见范围
注意
这里的可见范围,建议设置为企业组织架构的:根部门
,这样才能获取到全部的部门列表

创建完成示例

2.应用开发配置
必须配置自建应用的:网页授权及JS-SDK
、企业可信IP
,然后才能正常调用企微接口
注意
- 网页授权及JS-SDK:为访问平台的域名地址
- 企业可信IP:企微仅允许
可信IP
发起接口请求

网页授权及JS-SDK
注意
假设平台访问地址为:https://apaas.0codepaas.com/apaas
,则可信域名为:apaas.0codepaas.com
提示:可以通过
零代码插件
进行可信域名归属
认证校验(域名代理 或 自动证书)

认证校验通过示例

企业可信IP
将服务器的公网IP
填写到企业可信IP

3.配置通讯录同步
当需要同步企微的组织架构
、企业员工
时,需要配置通讯录同步

需要配置项目如下
注意
- 权限:需要开启手动编辑(否则无法调整通讯录)
- 企业可信IP:企微仅允许
可信IP
发起接口请求,填写服务器的公网IP
- 接收事件服务器:配置接收通讯录变更事件的服务器,通讯录变更消息会自动通知给服务器

接收事件服务器
配置说明
特别说明
请注意:点击保存前,请确保已绑定企微自建应用,否则无法校验通过!
请注意:点击保存前,请确保已绑定企微自建应用,否则无法校验通过!
请注意:点击保存前,请确保已绑定企微自建应用,否则无法校验通过!
点击查看配置参数,绑定成功示例:

注意
URL
为接收通讯录变更消息的地址,其格式必须固定为以下结构!
根域名地址
+/api/cw/msg_callback/
+企微组织ID
配置示例:
https://apaas.0codepaas.com
/api/cw/msg_callback/
wwddef915668866623

4.配置参数说明
绑定自建应用
时需要填写相关配置项,以下为配置项的查看位置说明
企业名称
这里填写企业实际名称即可,无特殊要求
企业ID(corpid)
每个企业都拥有唯一的corpid
,可在管理后台我的企业 → 企业信息
下查看

应用ID(agentid)
每个应用都有唯一的agentid
,在管理后台应用管理 → 应用 → 自建
,点进某个应用查看

应用秘钥(secret)
每一个应用都有一个独立的访问密钥,在管理后台应用管理 → 应用 → 自建
,点进某个应用查看

消息校验凭据(Token)
配置通讯录同步:接收事件服务器
中的Token

消息解密秘钥(EncodingAESKey)
配置通讯录同步:接收事件服务器
中的EncodingAESKey
