集成第三方应用
Flashduty 作为企业微信服务商,为您提供 Flashduty 应用的长期免费版本。该应用需要获得企业微信接口调用许可才能使用(免密登录 + 消息发送)。该许可目前支持 最多 60 天 免费,超出该使用时长后,Flashduty 需要为您购买企业微信许可,您方可继续使用。
在企业微信中安装 Flashduty 应用
企业还没有装过 Flashduty 应用时,先在管理后台装好;已经装过的可以跳过本节。-
访问 企业微信管理后台,进入 应用管理 → 应用 页面,点击 添加第三方应用。
-
在搜索栏输入
Flashduty,检索到应用后,点击 添加 按钮。
-
修改应用 可见范围,推荐选择全员或具体部门节点,以避免新增企业成员时仍需修改。然后,点击 同意以上授权并添加 完成安装。
没有事先安装也可以:保存集成时选 还没有安装 Flashduty 应用,Flashduty 会打开企业微信授权页,由企业管理员在那里完成安装。
在 Flashduty 扫码绑定企业
1
新建企业微信集成
进入 集成中心 → 新建集成,选择 企业微信,应用版本 选 第三方应用(扫码),填好 名称。
2
选择企业绑定方式
按企业的实际状态在 企业绑定方式 里二选一:
3
扫码并在企业微信里确认绑定
点击 保存,弹出企业微信授权窗口:
- 选「还没有安装」时点 打开企业微信授权页,由企业管理员用企业微信完成授权安装。不是企业管理员的话,把窗口里的链接发给管理员,管理员装完后这里会自动继续。
- 选「已安装」时用企业微信 App 扫描窗口里的二维码,或把链接发给该企业的任一成员在企业微信里打开。
- 企业 ID 变为只读,并提示「已通过企业微信确认,不能修改」。换企业只能重新扫码,没有直接改 ID 的入口。
- 绑定会话 30 分钟内有效,且只能用一次。过期后窗口提示「链接已过期,请重新生成」,点 重新生成 后重新扫码。
- 绑定失败时窗口给出原因:
该企业还没有安装 Flashduty 应用,请关闭后改选「还没有安装」,先完成授权安装。(企业其实没装应用,却选了「已安装」)、已在企业微信页面上取消绑定。(在确认页点了取消)、企业微信没有完成确认,请重新生成后再试。(其他情况)。
集成企业自建应用
作战室和群聊 @ AI SRE 只能在这个模式下使用;新建企业微信集成时,应用版本 默认也是它。新建集成并填写凭证
1
在企业微信管理后台创建应用
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。域名已被占用、不能托管时只能用这种方式。
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,国内访问更快。
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 只显示一次,离开页面后只看到掩码,请当次复制到企业微信。需要换一套时点 重新生成:重新生成后已保存的那一套立即失效,企业微信里填了旧值的要换成新值并保存,否则收不到回调;换过凭据后该步骤会退回「等待企业微信校验」,等企业微信重新校验通过后再打勾。
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。
1
在企业微信中创建智能机器人
在企业微信应用左侧进入 工作台,找到 智能机器人,进入机器人管理页面。新建一个智能机器人,创建方式选择 手动创建,然后选择 使用 API 模式创建。建议由企业内部成员创建:即使可见范围设为 企业内部全体成员,其他成员也要等创建者分享后才能看到该机器人。
2
填写回调 URL
在智能机器人的 API 配置 页面,连接方式选择 使用 URL 回调,填入 Flashduty 企业微信集成详情页第 6 步给出的 企业微信会向该地址发送一次 GET 请求做 URL 验证,Flashduty 会自动应答。校验通过后详情页第 6 步自动打勾。
URL,格式为:3
生成 Token 和 Encoding-AESKey
在详情页第 6 步点 生成并显示 生成
Token 和 EncodingAESKey,把这两个值连同上面的 URL 一起填到企业微信智能机器人的 API 配置 页并保存。不要在企业微信里点「随机获取」:两边必须用 Flashduty 生成的同一套值。明文只在生成的那一次显示,离开页面后只看到掩码。点 重新生成 后旧的那一套立即失效:企业微信里填了旧值的要换成新值重新保存,并重新校验回调 URL(校验通过后该步骤才会重新打勾)。使用方式
配置完成后,在企微单聊或群聊中 @ 智能机器人,输入问题或故障描述,即可触发 AI SRE 会话。支持以下消息类型:常见问题
机器人收到消息后没有任何响应
机器人收到消息后没有任何响应
请按以下顺序排查:
- 确认账户已开通 AI SRE,且集成中的 允许在 IM 中使用 AI SRE 已开启
- 确认回调 URL 中的
integration_key与 Flashduty 集成详情页显示的值完全一致 - 确认企业微信里填写的
Token和Encoding-AESKey是详情页第 6 步(智能机器人)生成的那一套,而不是第 3 步(接收消息)生成的那一套 - 在企业微信中查看该机器人的回调记录(如有),确认请求是否到达以及是否有错误码
配置回调 URL 时提示「URL 验证失败」
配置回调 URL 时提示「URL 验证失败」
- 确认 Flashduty 服务能够被企业微信服务器正常访问(公网可达),且访问域名可访问:托管时第 1 步的 DNS 记录要已生效、证书已签发;自己转发时
https://<访问域名>/ping要返回pong - 确认企业微信里填写的
Token和Encoding-AESKey与详情页第 6 步生成的那一套完全一致 - 确认回调 URL 中的
integration_key参数正确,且对应的集成处于启用状态
签名验证失败(invalid signature)
签名验证失败(invalid signature)
通常是
Token 或 Encoding-AESKey 填写有误。智能机器人的凭据与企业自建应用 接收消息 的凭据是两套独立凭据:在详情页第 6 步(智能机器人)或第 3 步(接收消息)重新生成对应的那一套,把新值填到企业微信保存,再重新校验回调 URL。如何完成账户关联或消息发送提示「未关联应用」?
如何完成账户关联或消息发送提示「未关联应用」?
- 登录企业微信客户端(桌面端和移动端均可),进入 工作台,找到并打开 Flashduty 应用
- 首次进入应用需要登录。选择您的成员账号,通过密码或单点登录方式登入成功后,即可完成 Flashduty 账号与企业微信账号的关联
- 后续进入应用将自动免密登录
如何发送故障通知?
如何发送故障通知?
- 发送通知前,必须参照上一问题完成账户关联
- 进入指定协作空间,导航至
分派策略→ 个人渠道,选择企业微信作为通知方式即可 - Flashduty On-call 支持对企业微信通知内容进行自定义。您可以前往 模板管理 页面,设定自定义模板
自定义区域最多可展示 8 行,超出部分将被企业微信截断。

如何在企业微信内处理告警?
如何在企业微信内处理告警?
- 点击卡片消息,可直接进入告警详情页面
- 点击 开始处理,可直接将告警置为
处理中状态 - 点击 直接关闭,可直接将告警置为
已关闭状态 - 点击 屏蔽 2 小时,可直接将告警屏蔽 2 小时。如果想屏蔽更长时间,可点击卡片右上角的
...查看更多屏蔽选项
为什么卡片消息提供了「状态刷新」按钮?
为什么卡片消息提供了「状态刷新」按钮?
根据企业微信的限制,一次卡片交互后,72 小时内只可更新一次。每一次按钮操作,都视为一次交互。当告警状态发生变化时,Flashduty On-call 会请求更新卡片内容。当告警状态频繁变化时,可能因超出更新次数限制导致卡片无法实时更新。此时,您可以点击 刷新 按钮,手动获取一次更新卡片状态的机会。
故障通知失败,并提示「未开通企微许可」?
故障通知失败,并提示「未开通企微许可」?
请联系 Flashduty 客服或您的专属技术支持,为您购买并开通许可。
为什么作战室功能未按预期工作?
为什么作战室功能未按预期工作?
请参考 作战室介绍文档 的 常见问题 部分。
为什么在企微工作台打开应用后提示「redirect_uri需使用应用可信域名」?
为什么在企微工作台打开应用后提示「redirect_uri需使用应用可信域名」?
请确认应用主页 URL 的
redirect_uri 参数中,域名已完成企业微信要求的归属认证,详见企业微信官方文档 《企业内部开发配置域名指引》。Mac 桌面端如何设置使用系统默认浏览器打开?
Mac 桌面端如何设置使用系统默认浏览器打开?
Mac 桌面端默认使用企业微信的内置浏览器打开链接。您可以尝试使用快捷键
ctrl + command + shift + d 开启调试模式,然后选择 调试 → 浏览器、webView 相关 → 系统浏览器打开网页,来更改链接的打开方式。使用相同的快捷键可以关闭调试模式,设置将会保留。
