Skip to main content

企业微信对接教程

注：对接企业微信需要有一个 https 证书的域名连接到系统 ip 访问地址。

第一步 【企业微信方】进入企业微信开发者中心​

https://developer.work.weixin.qq.com

第二步 【企业微信方】创建企业内部应用​

应用名写ChatBI

图标可自选或者从此处下载：

https://cdn.askdataservice.com/alisa.png

第三步 【ChatBI方】必要信息​

将以下信息提供给我方：

  1. 企业的 CorpID：在我的企业 -> 企业信息页的最后（企业 ID）
  2. 应用的 AgentId 和 Secret：在应用详情页

注：以下由实施工程师完成

在项目实施文件夹的 config.json 内，加入如下配置信息：

{
  "thirdParty": {
    "wxwork": {
      "corpId": "xxxxx",
      "appId": "xxxxx",
      "appSecret": "xxxxxxx"
    }
  }
}

第四步 【企业微信方】设置应用主页​

网页网址为私有化部署后的访问页面。

第五步 【ChatBI方配合】安全设置​

注：可信域名必须有 ICP 备案且在管理端验证域名归属。验证域名归属的方法在企业微信的管理后台“我的应用”里，进入应用，设置应用可信域名。可能企业微信会发一个验证文件过来，发给我们。

在项目配置页 -> 开发者接口板块

1. 网页授权及 JS-SDK​

  • 可作为应用 OAuth2.0 网页授权功能的回调域名： 填入域名
  • 可调用 JS-SDK、跳转小程序的可信域名： 填入域名

注: 上述行为企业微信会发一个验证文件过来，发给我们，由我们配置入系统。

2. 企业微信授权登录​

  • Web 网页的授权回调域： 填入域名

3. 企业可信 IP​

填服务器 IP 地址（如果是要借助公网 IP 出去的，要填公网 IP）

第六步 【企业微信方】发布应用​

发布后，在手机端企业微信 app 中 -> 工作台 -> 拉到最后 -> 可以看到新建的应用。

配置回复机器人​

如果需要有机器人私聊回复功能，可在接收消息 -> 启用API接收处获得应用的Token和EncodingAESKey，并填入系统全局配置中的wxwork字典内。

其中，URL填：https://xxxx.com/api/v1/util/wxwork/chat

注：截止2024年5月11日，企业微信暂不支持把机器人拉入群内并回复@消息

注意事项

企微报错：没有得到用户手机权限。无法登陆​

因为没有给应用获取手机号权限，看下列图片给权限。 截图 截图 截图 截图

企微推送消息用户没有收到。​

因为没有给应用接受消息权限或者开启了应用消息免打扰，看下面图片解决。 输入图片说明 截图 截图 截图