Skip to content

企业微信(企业内部开发)

平台集成企业微信,可以实现:企微单点登录、组织信息同步、企微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