企业微信 · 微信客服
@onebots/adapter-wecom-kf 对接微信客服的 kf/sync_msg、kf/send_msg 与会话管理 API。普通企业自建应用使用独立的 wecom，两者不共享 Secret 或会话模型。
yaml
wecom-kf.customer_service:
corp_id: ww1234567890abcdef
corp_secret: your_wecom_customer_service_secret
token: your_callback_token
encoding_aes_key: your_43_character_key
open_kfid: wkxxxxxxxxxxxxxxxx
cursor_store_path: ./data/wecom-kf-cursor.json回调 URL 默认为 https://bot.example.com/wecom-kf/customer_service/webhook。回调必须是企业微信官方加密 XML，且解密载荷的 CorpID 必须匹配配置。
字段含义、默认值与 Web 表单分组见微信客服配置。
能力边界
- 回调校验后立即确认，Token 触发后台
sync_msg；同一客服账号串行分页并原子持久化游标。 - 停止会取消在途同步，快速重启使用 generation 隔离旧生命周期请求。
- 客户、接待人员、平台事件及未知条目均保留完整原始数据。
- 事件身份从官方
event内层读取；同步 Token 和回调明密文不会暴露给下游协议。 - API 响应按官方 envelope 与具体资源结构校验，业务监听器异常不会阻断游标推进。
- 支持文本、媒体、文件、链接、位置、小程序、菜单与原生消息体。
- 支持客服账号、接待人员、客户详情、会话分配、事件响应消息、升级服务、统计与视频号绑定状态动作。
- 临时素材接口不需要
agent_id；媒体发送使用上传后得到的media_id。 - 仅存在客户私聊，不声明好友列表、普通企业微信员工消息或群聊能力。
wecom_kf_call为后续官方接口提供受限底层入口。
完整动作、消息示例与 ingest/acceptHttp 嵌入契约见 包 README。