跳转到主要内容
本章节介绍 Xpert 插件体系中与 Workflow Trigger 相关的扩展实现，以及外部消息平台如何通过触发器把消息路由到数字专家。 当你希望数字专家不仅能在平台内聊天界面被触发，还能从外部消息系统或定时任务触发时，可以通过 Trigger 插件扩展。

​
集成与触发器的边界

外部 IM 接入通常拆成两个对象：
  • 集成：保存平台凭证、回调地址、长连接配置和运行状态，负责让 Xpert AI 与外部平台连通。
  • 触发器：出现在数字专家工作流中，负责把某个集成绑定到当前数字专家，并决定会话超时、消息汇总和消息路由。
因此，创建飞书、企业微信或钉钉机器人时，不是只保存集成就结束了。还需要在目标数字专家工作流中添加对应触发器并发布版本，消息才会进入该数字专家。集成的通用安装要求和推荐接入模式见 集成说明。

​
当前文档范围

​
设计要点

Trigger 插件通常实现以下能力：
  1. 触发器元数据（meta）：用于在前端展示触发器名称、图标和配置表单。
  2. 配置校验（validate）：在发布前检查必填项和绑定冲突。
  3. 发布与停用（publish / stop）：负责注册与释放触发器运行时资源。
  4. 启动恢复策略（bootstrap）：控制系统重启后触发器是否自动恢复。
飞书、企业微信、钉钉触发器都采用持久化绑定：
这可以避免同一个外部机器人同时触发多个数字专家。系统重启后，外部消息到达时会继续按持久化绑定分发；如果运行时回调暂时不存在，会进入插件的 handoff 分发队列。

​
关联功能