企业微信自建应用开发：消息回调、客服会话与权限配置

1. 引言

很多团队一提到企业微信开发，首先搜的是「企业微信自建应用」「企业微信消息回调」「企业微信客服接口」。和第三方自动化思路不同，官方自建应用走的是企业微信开放平台：创建应用、配置回调、按权限调接口。

本文只讲官方路径，方便后端把企业内部的通知、审批结果、简易客服接到企微里。

2. 自建应用能做什么

常见且相对稳妥的能力包括：

向成员发送应用消息（文本、卡片、文件）
接收成员在应用里发送的消息（需配置回调）
通讯录只读或通讯录写（按权限）
审批、打卡等办公应用的事件通知
客户联系相关接口（需企业开通对应权限）

做之前先在管理后台确认：应用可见范围、可信 IP、回调 URL、Token 与 EncodingAESKey。

3. 开发前清单

有企业微信管理后台权限
创建自建应用，记录 corpid、secret
服务器能通过可信 IP 访问开放接口
回调 URL 必须公网 HTTPS
明确消息是「应用消息」还是「客户联系消息」，两者权限完全不同

access_token 需要缓存，过期前刷新，避免每次请求都重新取 token，把频率打满。

4. 获取 token 与发消息

python 复制代码

import time
import requests

class WeComToken:
    def __init__(self, corpid, secret):
        self.corpid = corpid
        self.secret = secret
        self.token = None
        self.expire_at = 0

    def get(self) -> str:
        if self.token and time.time() < self.expire_at - 60:
            return self.token
        url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken"
        r = requests.get(url, params={"corpid": self.corpid, "corpsecret": self.secret}, timeout=10)
        data = r.json()
        self.token = data["access_token"]
        self.expire_at = time.time() + int(data.get("expires_in", 7200))
        return self.token

发送应用消息时，接收人是成员账号，不是外部客户。若要把消息发给客户，需要走客户联系相关权限和接口，并在后台完成配置。

5. 回调校验与解密

企业微信回调一般要处理 URL 验证（echostr）和正式报文解密。注意：

GET 用于验证，返回明文 echostr
POST 为加密 XML/JSON，需按官方加解密方案处理
回调要在规定时间内响应，业务逻辑异步化
重复通知必须幂等

建议单独做 wecom_callback 模块，不要和业务 Controller 混在一起，方便以后加事件类型。

6. 简易客服会话模型

如果只是内部 IT 服务台：

text 复制代码

成员在应用里发消息
  → 回调进入工单系统
  → 按关键词自动回复，或生成工单
  → 用应用消息把处理结果推回成员

如果是外部客户：

需要客户联系、或微信客服（wechat customer service）等独立能力
外部联系人 ID、跟进人、离职继承都要纳入数据模型
权限不足时接口会返回 4xxxx，应在日志里保留 errcode 和 errmsg

7. 常见问题

48009 / IP 不在白名单：把出口 NAT IP 配进可信 IP
回调验证失败：Token、AESKey、URL 三件套不一致
成员收不到消息：不在应用可见范围，或未关注该企业
客户消息调不通：应用缺少客户联系权限，或未安装对应应用

8. 总结

企业微信官方自建应用适合通知、内部服务台、已开通权限的客户联系场景。开发顺序应当是：权限和可见范围 → token 缓存 → 发通一条应用消息 → 配好回调验签解密 → 再上业务。这样排期可控，也便于和安全、运维一起验收。