跳转到主要内容
钉钉触发器用于把一个钉钉集成绑定到一个 Xpert，确保钉钉回调消息可以稳定路由到目标专家。

​
为什么需要钉钉触发器

只有钉钉集成时，系统仅完成“连接钉钉 + 接收回调”。 要回答“这条消息交给哪个 Xpert 处理”，需要触发器建立绑定关系： 
integrationId -> xpertId

​
配置项

钉钉触发器当前包含：
  • 启用
  • 钉钉集成（必填）
:::tip 触发器配置后，必须重新发布专家才会生效。 :::

​
生效流程

  1. 创建钉钉集成
  2. 在工作流添加“钉钉触发器”
  3. 选择目标钉钉集成
  4. 发布专家
  5. 平台写入触发器绑定
  6. 后续该集成的消息路由到当前专家

​
路由优先级

钉钉消息路由优先级：
  1. 已有会话绑定
  2. 触发器绑定
  3. 集成里的 xpertId 兜底
如果三者都没有，消息无法找到处理目标。

​
绑定与数据表

钉钉插件包含两类持久化绑定：
  1. plugin_dingtalk_trigger_binding
  2. plugin_dingtalk_conversation_binding
含义：
  • trigger_binding：定义集成默认归属哪个 Xpert
  • conversation_binding：定义某个钉钉会话用户键续接到哪个对话会话

​
使用限制

  • 一个 integrationId 只能绑定一个 xpertId
  • 群聊中只有 @机器人 才会触发
  • 停用触发器或下线专家后，会清理对应绑定

​
常见问题

​
1. 配置了触发器但不生效

检查是否已重新发布专家。

​
2. 单聊正常，群聊不触发

检查机器人是否在群中，以及是否 @机器人。

​
3. 已有会话为何没切到新专家

已有会话会优先续接历史绑定；需要结束会话后再触发新路由。