跳转到内容
Nick Blogs

企业微信API对接

1. 简介

Section titled “1. 简介”

本文主要介绍企业微信（WeCom）后台接口对接的技术实现，包括官方提供的回调加解密算法、基本的 API 授权机制、接收用户消息的服务器配置流程，以及微信客服模块的对接要点。

2. 官方加解密库使用

Section titled “2. 官方加解密库使用”

为了保证消息交互的安全性，企业微信在回调模式下发送的报文均经过加密处理。在 Node.js 环境下，建议使用企业微信官方推荐的加解密库 @wecom/crypto。

  • 依赖安装
Terminal window
npm install @wecom/crypto
  • 签名校验与加解密实现
import { getSignature, decrypt, encrypt } from '@wecom/crypto';


// 1. 签名校验：验证请求是否确实来自企业微信后台
const signature = getSignature(token, timestamp, nonce, ciphered);
if (signature === query.signature) {
    console.log("签名校验成功");
}


// 2. 解密接收到的密文数据
const { message, id } = decrypt(encodingAESKey, ciphered);
console.log("解密后的消息主体与企业Corpid:", { message, id });


// 3. 对准备回复给企业微信的消息执行加密
const replyCiphered = encrypt(encodingAESKey, replyMessage, id);
console.log("加密后的密文数据:", replyCiphered);

3. 授权认证流程

Section titled “3. 授权认证流程”

企业微信所有管理接口的调用都必须基于全局凭证 access_token。

  • 鉴权机制： 开发者通过企业微信的 corpid (企业 ID) 和应用的 corpsecret (应用凭证) 请求微信授权网关换取 access_token。

企业微信授权流程图

4. 接收消息回调配置

Section titled “4. 接收消息回调配置”

要实现被动接收用户发送的消息，开发者需要在企业微信管理后台配置消息端点（接收消息服务器 URL）。

  1. 服务器验证：当保存配置时，企业微信后台会向填写的 URL 发送一个带有 echostr 参数的 GET 请求，开发者需对该密文进行解密并原样返回解密明文，以验证服务器可用性。

    服务器验证交互

  2. 消息端点接收：验证通过后，用户发送的消息及系统事件会通过 POST 请求持续投递到该消息端点 URL。

    消息接收流

5. 微信客服接口对接

Section titled “5. 微信客服接口对接”

企业微信提供了对外的“微信客服”能力，可让用户在微信端直接发起咨询，企业在企业微信或自建系统中统一回复。

微信客服 API

6. 参考资料

Section titled “6. 参考资料”