跳转到主要内容
版本要求:所有版本均可创建 IM 应用用于 AI SRE 对话;将应用用于 On-call 分派通知,需有效的 On-call 专业版订阅。了解更多
支持 集成第三方应用 和 集成企业自建应用 两种方式,按需选择其一即可。新建企业微信集成时,应用版本 默认选中 企业自建应用(推荐),另一个选项是 第三方应用(扫码)。作战室和群聊 @ AI SRE 仅支持企业自建应用。

集成第三方应用

Flashduty 作为企业微信服务商,为您提供 Flashduty 应用的长期免费版本。该应用需要获得企业微信接口调用许可才能使用(免密登录 + 消息发送)。该许可目前支持 最多 60 天 免费,超出该使用时长后,Flashduty 需要为您购买企业微信许可,您方可继续使用。
第三方应用模式不支持私有化部署。这个模式下的企业 ID 不用填、也不能填:集成的企业归属只能通过企业微信扫码确认来绑定。

在企业微信中安装 Flashduty 应用

企业还没有装过 Flashduty 应用时,先在管理后台装好;已经装过的可以跳过本节。
  1. 访问 企业微信管理后台,进入 应用管理 → 应用 页面,点击 添加第三方应用。 企业微信:集成第三方应用 界面截图
  2. 在搜索栏输入 Flashduty,检索到应用后,点击 添加 按钮。 企业微信:集成第三方应用 界面截图
  3. 修改应用 可见范围,推荐选择全员或具体部门节点,以避免新增企业成员时仍需修改。然后,点击 同意以上授权并添加 完成安装。 企业微信:集成第三方应用 界面截图
没有事先安装也可以:保存集成时选 还没有安装 Flashduty 应用,Flashduty 会打开企业微信授权页,由企业管理员在那里完成安装。

在 Flashduty 扫码绑定企业

1

新建企业微信集成

进入 集成中心 → 新建集成,选择 企业微信,应用版本 选 第三方应用(扫码),填好 名称。
2

选择企业绑定方式

按企业的实际状态在 企业绑定方式 里二选一:
3

扫码并在企业微信里确认绑定

点击 保存,弹出企业微信授权窗口:
  • 选「还没有安装」时点 打开企业微信授权页,由企业管理员用企业微信完成授权安装。不是企业管理员的话,把窗口里的链接发给管理员,管理员装完后这里会自动继续。
  • 选「已安装」时用企业微信 App 扫描窗口里的二维码,或把链接发给该企业的任一成员在企业微信里打开。
企业微信识别出企业后,窗口显示「已识别企业 xxx,等待在企业微信页面点击「确认绑定」…」。在企业微信打开的 确认绑定企业微信 页面核对 Flashduty 账户、发起人和企业,点击 确认绑定。确认后 console 自动完成保存,不需要再点保存。
绑定完成后:
  • 企业 ID 变为只读,并提示「已通过企业微信确认,不能修改」。换企业只能重新扫码,没有直接改 ID 的入口。
  • 绑定会话 30 分钟内有效,且只能用一次。过期后窗口提示「链接已过期,请重新生成」,点 重新生成 后重新扫码。
  • 绑定失败时窗口给出原因:该企业还没有安装 Flashduty 应用,请关闭后改选「还没有安装」,先完成授权安装。(企业其实没装应用,却选了「已安装」)、已在企业微信页面上取消绑定。(在确认页点了取消)、企业微信没有完成确认,请重新生成后再试。(其他情况)。

集成企业自建应用

作战室和群聊 @ AI SRE 只能在这个模式下使用;新建企业微信集成时,应用版本 默认也是它。

新建集成并填写凭证

1

在企业微信管理后台创建应用

访问 企业微信管理后台,进入 应用管理 → 应用 页面,点击 创建应用。企业微信:集成企业自建应用 界面截图配置 应用 Logo、应用名称 和 应用可见范围。企业微信:集成企业自建应用 界面截图
2

填写企业 ID、AgentId 和 Secret

在 我的企业 页面取 企业 ID,在刚创建的应用的 应用详情 页取 AgentId 和 Secret,填入 Flashduty On-call 集成配置页面。企业微信为私有化部署版本时,还要填写 Endpoint。Flashduty 服务必须能访问该 Endpoint,您可以为它设置 白名单授权。
3

填写访问域名

访问域名 只填一个域名:不带 https://、不带路径,由 Flashduty 托管时也不带端口,例如 flashduty.example.com。保存后在详情页第 1 步接入这个域名:添加 CNAME 记录由 Flashduty 签发证书并转发,或用您自己的 Nginx 转发。企业微信要求可信域名和回调地址都使用这个域名。
私有化部署没有托管这一步:访问域名就是贵司 Flashduty 的访问域名,企业微信要能从公网访问它。
4

保存集成

点击 保存。接收消息和智能机器人的 Token、EncodingAESKey 都由 Flashduty 生成,创建集成时不需要填,保存后在详情页对应步骤生成。保存后,详情页的 在企业微信完成配置 会带您完成剩下的配置。

在企业微信完成配置

详情页按下面的顺序列出 6 步,编号与本节一致。能从企业微信侧看到结果的步骤会自动打勾;看不到结果的步骤在完成后点步骤里的确认按钮记录,需要集成编辑权限。
私有化部署没有第 1 步(访问域名就是自己的部署地址),后面各步编号依次提前一位,校验文件也要放到自己的服务器根目录。

1. 接入访问域名

访问域名有两种接入方式,选一种即可:
  • CNAME 托管(推荐):在 DNS 服务商添加 CNAME 记录,Flashduty 签发证书并转发,不用自己维护服务器。
  • 自己转发:用您自己的 Nginx 或负载均衡配证书,把这个域名的请求全部转发到 Flashduty。域名已被占用、不能托管时只能用这种方式。
详情页第 1 步默认选中 CNAME 托管;检测到自己转发已连通时会自动选中自己转发。

CNAME 托管

在访问域名所在的 DNS 服务商添加详情页第 1 步列出的 CNAME 记录: 记录值以页面显示的为准。证书托管 这条用来证明域名归您所有,Flashduty 据此通过 DNS-01 方式签发 HTTPS 证书;访问入口 这两条把访问转到 Flashduty,配其中一条即可。 入口选哪个:默认用国际访问入口 wecom.flashduty.com(香港),任何域名都能用;域名已在阿里云完成接入备案的,可以改用大陆访问入口 cn.wecom.flashduty.com,国内访问更快;DNS 服务商支持按地区解析的,两个都配。没在阿里云接入备案的域名指向大陆入口会被阿里云拦截。 记录生效且证书签发后,第 1 步自动打勾,显示「已生效 · 证书已签发」。有记录没生效时显示「N 条记录未生效」,记录都已生效但证书还在签发时显示「证书签发中」;可以点 重新检测 重新读一次。
这个域名如果已被某个状态页或另一个 Flashduty 账户占用,Flashduty 不能为这个集成托管它,第 1 步会显示「域名已被占用」,并直接给出自己转发的配置。不想自己转发就编辑集成换一个访问域名;域名确实属于您的,联系 Flashduty 支持。

自己转发

自己转发的要求:
  • 证书由受信任的 CA 签发。
  • 这个域名下的所有路径都转发到 wecom.flashduty.com,保留原来的 Host 头。Flashduty 按 Host 识别是哪个集成;以后 Flashduty 新增或调整路径时,您的配置不用改。
  • http 和 https 都要转发,不能跳转:企业微信会用 http 取域名校验文件。
  • 域名已在阿里云完成接入备案的,可以改为转发到 cn.wecom.flashduty.com,国内访问更快。
下面是 Nginx 示例,详情页第 1 步会按集成的访问域名生成,可以直接复制。其他代理或负载均衡按上面的要求配置:
配好后点 重新检测:https://<访问域名>/ping 返回 pong 时,第 1 步显示「自行转发 · 已连通」。

2. 设置可信域名

在应用详情页进入 开发者接口 → 网页授权及JS-SDK,点击 设置可信域名,填入访问域名。要求详见企业微信官方文档 《企业内部开发配置域名指引》。 企业微信:集成企业自建应用 界面截图 然后在这一页点 申请校验域名,下载 WW_verify_xxx.txt,回到详情页第 2 步点 上传校验文件 上传它。企业微信会从域名根路径取这个文件,由 Flashduty 返回(企业微信不跟随重定向,http 和 https 都要能直接取到)。 企业微信来取过之后,第 2 步自动打勾,显示「校验文件已被企业微信读取」;上传后等待企业微信来取时显示「待企业微信读取」,还没上传时显示「待上传校验文件」。 回到企业微信点 确定 完成校验。同一页的 OAuth2.0 网页授权回调域名也填这个域名。
企业微信要求域名的备案主体与本企业相同或有关联关系(母子公司、总分公司等),不符时企业微信不让保存,只能换域名或联系企业微信客服提交关联证明。
自己转发时,第 1 步的配置把 /WW_verify_*.txt 转给 Flashduty,照样上传到详情页即可。私有化部署,或者自己转发但把校验文件直接放在自己服务器根目录的,校验文件要 http 和 https 都能直接访问、不能跳转;校验通过后点 我已完成校验 记录这一步。

3. 设置 API 接收消息

在应用详情页进入 接收消息 → 设置 API 接收,把详情页第 3 步显示的三项填进去,点击 保存: 企业微信保存时会立刻访问这个 URL 做校验。校验通过后第 3 步自动打勾,显示「已通过校验」;还没通过时显示「等待企业微信校验」。
不要在企业微信里点 随机获取:Token 和 EncodingAESKey 用 Flashduty 生成的这一套,两边才一致。
Token 和 EncodingAESKey 只显示一次,离开页面后只看到掩码,请当次复制到企业微信。需要换一套时点 重新生成:重新生成后已保存的那一套立即失效,企业微信里填了旧值的要换成新值并保存,否则收不到回调;换过凭据后该步骤会退回「等待企业微信校验」,等企业微信重新校验通过后再打勾。 企业微信:集成企业自建应用 界面截图 企业微信:集成企业自建应用 界面截图

4. 配置企业可信 IP

在应用详情页底部 企业可信IP 点配置,把详情页第 4 步显示的整行 IP 复制填入。SaaS 版本是 47.93.12.134;47.94.95.118;123.56.8.183;47.94.193.81;1.13.19.96,所有使用 Flashduty 的企业都填这一行;私有化部署填写贵司 Flashduty 服务器访问企业微信的出口 IP。 企业微信要求先完成第 2 或第 3 步,才允许配置可信 IP。 第 4 步由 Flashduty 向企业微信发起一次检测:检测成功显示「已生效」;企业微信返回 60020 显示「待配置」,表示可信 IP 还没配好;其他错误码原样显示企业微信返回的码;调不通企业微信显示「检测失败」。可以点 重新检测 重读。 企业微信:集成企业自建应用 界面截图
只有在没有填写私有 Endpoint(即由 Flashduty 代理转发调用企业微信)时,详情页给出的 IP 才是正确的出口 IP。企业微信如果报「以下IP属于第三方服务商」,把报错截图发给 Flashduty 支持。私有化部署请填写贵司 Flashduty 服务器的出口 IP。

5. 设置工作台应用主页

在应用详情页的 工作台应用主页 点设置,选 网页,填入详情页第 5 步给出的地址。新建的集成不需要再单独配置「前端可信域名」。 企业微信不回传这项配置,设置完成后点 我已设置 记录这一步。 企业微信:集成企业自建应用 界面截图

6. 创建智能机器人(可选)

可选的一步,用于在单聊和群聊里 @ 智能机器人使用 AI SRE,详细步骤见 配置 AI SRE 智能机器人。第 6 步给出 https://<访问域名>/event/push/wecom/bot?integration_key=<integration_key>,Token 和 EncodingAESKey 同样由 Flashduty 生成、只显示一次,与接收消息那一套互不通用。企业微信校验通过后这一步自动打勾。

关联用户

在集成详情页的 关联用户 页签中,可按 全部 / 已关联 / 未关联 筛选成员,也可按名称或邮箱搜索。点击 一键关联,系统会用成员的手机号或邮箱匹配企业微信账号并自动关联,效果等同于成员在企业微信中登录 Flashduty。 成员完成关联后,才能收到企业微信消息通知。关联失败时,请确认成员的手机号或邮箱与企业微信账号一致。

配置作战室

作战室功能仅支持在 企业自建应用 模式下开启。
完成先前步骤后,在 Flashduty On-call 集成配置页面的 增强功能 模块,勾选 开启作战室 即可启用该功能,无需额外配置。 同一时间只能有一个 IM 集成开启作战室,需先在其他集成中关闭,详见 作战室。

AI SRE 控制项

在 增强功能 中配置 AI SRE 开关,默认均为开启,各开关含义见 IM 平台。企业微信的两种应用模式对 AI SRE 入口的支持不同:

配置 AI SRE 智能机器人

在企业微信单聊或群聊中 @ 智能机器人,即可发起 AI SRE 排障会话,无需离开企业微信。智能机器人只能在 企业自建应用 模式下配置。
  • 账户需已开通 AI SRE,且 Flashduty 企业微信集成中的 允许在 IM 中使用 AI SRE 已开启(无需开启作战室)。未开通时,机器人收到消息后不会响应。
  • 回调 URL 由集成里保存的 访问域名 拼出,所以要先按 集成企业自建应用 把集成和访问域名保存好,详情页第 6 步才会给出可用的 URL。
智能机器人使用独立的一套凭据(Token 和 Encoding-AESKey),与 集成企业自建应用 中 接收消息 的 Token / EncodingAESKey 不同。两套凭据混用会导致签名验证失败。
1

在企业微信中创建智能机器人

在企业微信应用左侧进入 工作台,找到 智能机器人,进入机器人管理页面。新建一个智能机器人,创建方式选择 手动创建,然后选择 使用 API 模式创建。建议由企业内部成员创建:即使可见范围设为 企业内部全体成员,其他成员也要等创建者分享后才能看到该机器人。
2

填写回调 URL

在智能机器人的 API 配置 页面,连接方式选择 使用 URL 回调,填入 Flashduty 企业微信集成详情页第 6 步给出的 URL,格式为:
企业微信会向该地址发送一次 GET 请求做 URL 验证,Flashduty 会自动应答。校验通过后详情页第 6 步自动打勾。
3

生成 Token 和 Encoding-AESKey

在详情页第 6 步点 生成并显示 生成 Token 和 EncodingAESKey,把这两个值连同上面的 URL 一起填到企业微信智能机器人的 API 配置 页并保存。不要在企业微信里点「随机获取」:两边必须用 Flashduty 生成的同一套值。明文只在生成的那一次显示,离开页面后只看到掩码。点 重新生成 后旧的那一套立即失效:企业微信里填了旧值的要换成新值重新保存,并重新校验回调 URL(校验通过后该步骤才会重新打勾)。
企业微信暂不支持在创建作战室后自动将智能机器人拉入群聊。要在作战室中使用 AI SRE,需要手动将智能机器人添加到对应群聊。

使用方式

配置完成后,在企微单聊或群聊中 @ 智能机器人,输入问题或故障描述,即可触发 AI SRE 会话。支持以下消息类型:

常见问题

请按以下顺序排查:
  1. 确认账户已开通 AI SRE,且集成中的 允许在 IM 中使用 AI SRE 已开启
  2. 确认回调 URL 中的 integration_key 与 Flashduty 集成详情页显示的值完全一致
  3. 确认企业微信里填写的 Token 和 Encoding-AESKey 是详情页第 6 步(智能机器人)生成的那一套,而不是第 3 步(接收消息)生成的那一套
  4. 在企业微信中查看该机器人的回调记录(如有),确认请求是否到达以及是否有错误码
  • 确认 Flashduty 服务能够被企业微信服务器正常访问(公网可达),且访问域名可访问:托管时第 1 步的 DNS 记录要已生效、证书已签发;自己转发时 https://<访问域名>/ping 要返回 pong
  • 确认企业微信里填写的 Token 和 Encoding-AESKey 与详情页第 6 步生成的那一套完全一致
  • 确认回调 URL 中的 integration_key 参数正确,且对应的集成处于启用状态
通常是 Token 或 Encoding-AESKey 填写有误。智能机器人的凭据与企业自建应用 接收消息 的凭据是两套独立凭据:在详情页第 6 步(智能机器人)或第 3 步(接收消息)重新生成对应的那一套,把新值填到企业微信保存,再重新校验回调 URL。
  • 请检查您是否已完成应用的安装步骤。例如,您是否可以在企业微信工作台中看到 Flashduty On-call 应用
  • 第三方应用的企业是通过扫码绑定确认的,请按 集成第三方应用 重新扫码绑定
  1. 登录企业微信客户端(桌面端和移动端均可),进入 工作台,找到并打开 Flashduty 应用
  2. 首次进入应用需要登录。选择您的成员账号,通过密码或单点登录方式登入成功后,即可完成 Flashduty 账号与企业微信账号的关联
  3. 后续进入应用将自动免密登录
  1. 发送通知前,必须参照上一问题完成账户关联
  2. 进入指定协作空间,导航至 分派策略 → 个人渠道,选择 企业微信 作为通知方式即可
  3. Flashduty On-call 支持对企业微信通知内容进行自定义。您可以前往 模板管理 页面,设定自定义模板
自定义区域最多可展示 8 行,超出部分将被企业微信截断。
企业微信:如何发送故障通知? 界面截图
  • 点击卡片消息,可直接进入告警详情页面
  • 点击 开始处理,可直接将告警置为 处理中 状态
  • 点击 直接关闭,可直接将告警置为 已关闭 状态
  • 点击 屏蔽 2 小时,可直接将告警屏蔽 2 小时。如果想屏蔽更长时间,可点击卡片右上角的 ... 查看更多屏蔽选项
根据企业微信的限制,一次卡片交互后,72 小时内只可更新一次。每一次按钮操作,都视为一次交互。当告警状态发生变化时,Flashduty On-call 会请求更新卡片内容。当告警状态频繁变化时,可能因超出更新次数限制导致卡片无法实时更新。此时,您可以点击 刷新 按钮,手动获取一次更新卡片状态的机会。
请联系 Flashduty 客服或您的专属技术支持,为您购买并开通许可。
请参考 作战室介绍文档 的 常见问题 部分。
请确认应用主页 URL 的 redirect_uri 参数中,域名已完成企业微信要求的归属认证,详见企业微信官方文档 《企业内部开发配置域名指引》。
Mac 桌面端默认使用企业微信的内置浏览器打开链接。您可以尝试使用快捷键 ctrl + command + shift + d 开启调试模式,然后选择 调试 → 浏览器、webView 相关 → 系统浏览器打开网页,来更改链接的打开方式。使用相同的快捷键可以关闭调试模式,设置将会保留。