企业微信自建应用
@onebots/adapter-wecom 对接企业微信自建应用官方 API。微信客服使用独立的 wecom-kf,两套 API 不混用。
yaml
wecom.internal_app:
corp_id: ww1234567890abcdef
corp_secret: your_application_secret
agent_id: '1000001'
token: your_callback_token
encoding_aes_key: your_43_character_key
deduplicate_webhooks: true
onebot.v11:
use_http: true
use_ws: true接收消息 URL 默认为 https://bot.example.com/wecom/internal_app/webhook。适配器只接受验签并成功解密的企业微信回调,且会校验解密载荷中的 CorpID。
能力边界
- 私聊/直聊向企业成员发送应用消息;群聊指应用创建的
appchat。 - 部门和标签是组织管理对象,不映射为聊天群。
- 原生发送文本、媒体、文件、Markdown、卡片和图文;媒体先上传取得
media_id。 - 支持撤回具有服务端
msgid的应用消息、获取应用群与成员、通讯录和标签管理;appchat发送响应没有msgid,不虚构可撤回能力。 - 可发现平台动作覆盖日历、日程、审批、客户联系、客户群、群发、朋友圈和统计;复杂请求体保持企业微信官方结构。
- 网页动作覆盖 OAuth 地址、访问者身份与敏感信息,并分别缓存、签名
wx.config和wx.agentConfigticket。 - 通用
at段会文本化为@userid,不声明为可靠提醒能力。 - 所有事件保留解密 XML、密文 XML 和完整平台字段。
- Webhook 会等待异步监听器成功后再确认;同一事件的并发重投递只执行一次,失败不会写入去重状态。
wecom_call为新接口提供受限路径、统一 token 和结构化错误。
完整动作与嵌入式 Webhook 契约见 包 README。