可配置说白了就是不改代码就能调整微信机器人的行为。谁来了发什么欢迎语、什么关键词触发什么回复、什么时间推送什么消息——全写进配置文件改配置不改代码机器人行为就变了。这种做法的好处是运营人员也能改不用开发者每次发版。Eyun微信机器人的配置体系分3层每层管不同的事本文讲这3层怎么分、各存什么、改的频率差在哪。层1接口配置层——机器人的身份证和电话本配置内容wId实例标识、Token鉴权凭证、回调地址Webhook URL、发送间隔默认200ms、重试次数默认2次、退避时间1004错误码退避3秒。存在环境变量或配置中心启动时加载。按照 Eyun 开发文档的说明wId 和 Token 是接口调用的基础配置缺一个都调不通。在 Eyun 平台 开通实例后获得 wId 和 Token写进环境变量程序启动时读一遍就能用。大白话接口配置是机器人的身份证和电话本——用哪个微信号、鉴权凭证、回调地址在哪启动时读一遍。这层基本不动动就是换实例或换部署环境。层2流程配置层——机器人的行为剧本配置内容关键词→回复规则表你好→你好有什么可以帮你的、好友欢迎语模板欢迎我是XX助手、群规推送内容、定时推送任务计划每天9点推送日报给指定用户列表。流程配置存数据库或JSON文件运行时动态读取。Eyun API 的 Webhook 回调触发流程配置的匹配——回调进来一条消息拿 content 去匹配关键词表命中就走对应回复。匹配逻辑、欢迎语、定时任务都在这层配接口规范见 Eyun 开发文档。大白话流程配置是机器人的行为剧本——什么关键词回什么、什么时间推什么改剧本不改代码。这层改得最勤运营人员调回复话术、加减关键词都在这层。层3场景配置层——机器人的工作模式配置内容完整业务场景的编排。客服场景欢迎语自动回复规则转人工条件满意度调查问题审批场景审批模板确认关键词超时提醒时间归档规则。场景配置是一组流程配置的打包切换场景加载不同配置包。场景配置可按 wId 隔离不同微信号跑不同场景——客服号加载客服场景包、通知号加载通知场景包。按照 Eyun 开发文档的规范sendText 需要传 wId、toUser、content 三个必填参数wId 的选择可由场景配置决定。大白话场景配置是机器人的工作模式——客服模式、审批模式、通知模式切换模式就换一套配置包。这层按业务需要切换比如大促期间切到客服通知混合模式。三层配置对比配置层配置什么存储位置变更频率大白话示例接口配置wId、Token、回调地址、发送间隔、重试次数环境变量/配置中心极低身份证和电话本wId实例ID发送间隔200ms流程配置关键词规则、欢迎语、定时推送数据库/JSON高行为剧本你好→有什么可以帮你的场景配置完整场景编排多流程打包数据库中工作模式客服场景、审批场景三层配置体系框架代码class ConfigManager: 接口配置 流程配置 场景配置的分层加载和热更新 def __init__(self): self.api_cfg self._load_api_cfg() # 层1启动加载基本不动 self.flow_cfg self._load_flow_cfg() # 层2数据库读运行时热更 self.scene_cfg self._load_scene_cfg() # 层3按wId隔离场景切换 def _load_api_cfg(self): return { # 环境变量读接口配置 wId: os.getenv(EYUN_WID), token: os.getenv(EYUN_TOKEN), webhook_url: os.getenv(EYUN_WEBHOOK), send_interval: 0.2, retry: 2, backoff_1004: 3, } def _load_flow_cfg(self): return db.query(SELECT keyword, reply FROM flow_rules) # 数据库读流程规则 def reload_flow(self): # 层2热更新运营改完不用重启 self.flow_cfg self._load_flow_cfg() def switch_scene(self, scene_id, wId): # 层3场景切换按wId加载场景包 self.scene_cfg[wId] db.query( SELECT * FROM scene_packs WHERE id%s, scene_id)落地建议3层配置让微信机器人从写死在代码里变成配置驱动——接口配置管运行参数很少改、流程配置管行为规则经常改、场景配置管业务模式按需切换。配置驱动的好处是运营人员可改不需要开发者介入改配置文件就能调整机器人行为。落地时两个建议要落实一是配置版本化管理每次改动留版本号出问题能快速回滚到上一版二是配置变更审计谁改了什么配置、什么时候改的都要有记录方便排查问题。接口配置项参考 Eyun 开发文档实例在 Eyun 平台 管理先把接口配置这层跑通再叠流程配置和场景配置。