外部故障提交

版本要求：此功能需要 On-call 专业版及以上订阅。了解更多

外部故障提交允许外部人员（如您的客户或合作伙伴）在无需登录 Flashduty 的情况下，通过一个独立页面或 API 提交故障。提交成功后，故障直接创建到对应的协作空间中，自动匹配分派策略并通知处理人员，适合把对客服务的报障入口接入统一的故障处置流程。

开启外部提报

进入 协作空间详情 → 配置 → 设置 → 高级配置，打开 外部提报 开关（创建协作空间的向导中也可以开启）。开启后系统会为该协作空间生成一条专属的外部提报链接，复制并分享给外部人员即可。

外部提报链接是免登录提交入口，任何持有链接的人都可以提交故障，请仅分享给需要的对象
关闭外部提报后，已分享的链接立即失效；再次开启会生成新的链接，旧链接不可恢复

提交页面

外部人员打开提报链接后，在独立页面填写并提交故障，全程无需登录：

字段	必填	说明
故障标题	是	最长 500 字符
详细描述	是	支持 Markdown 格式，最长 10000 字符
附件或截图	否	最多上传 10 个文件，支持 JPEG、PNG、WebP、GIF、TIFF、BMP、ICO 格式，单个文件不超过 5 MB
邮箱	是	提报人的联系方式，便于处理人员跟进时获取更多信息
公司	否	提报人所在公司名称

提交前需完成人机验证（验证码）。提交成功后页面会展示成功提示；如果链接已被关闭或重新生成，页面会提示链接无效，提报人需要联系您的团队获取新链接。

提交后的处理

外部提交的故障会创建到链接所属的协作空间中，并带有以下特征：

严重程度：固定为 Warning
处理进度：待处理，与告警自动触发的故障一致
提报人信息：邮箱和公司分别记录为故障的 reporter_email、reporter_company 标签，可在故障详情的标签区域查看
自动分派：故障创建后自动匹配协作空间下的分派策略并发出通知

如果协作空间没有配置分派策略，外部提交的故障不会分派给任何人，也不会产生通知。开启外部提报前，请确保协作空间已配置有效的分派策略。

通过 API 提交

除独立页面外，您还可以将提交能力集成到自己的系统中。外部提报链接形如 https://<控制台域名>/incident/external-create/<token>，取其中的 token，以 multipart/form-data 方式调用：

curl -X POST "https://<控制台域名>/api/incident/external-create?token=<token>" \
  -F 'data={"title":"支付接口报错","description":"从 14:00 开始所有支付请求返回 500","reporter_email":"ops@example.com","reporter_company":"示例公司","captcha_verify_param":"<验证码校验参数>"}' \
  -F "images=@/path/to/screenshot.png"

部分	说明
`data`	必填，JSON 字符串。字段：`title`（必填，最长 500 字符）、`description`（必填，最长 10000 字符）、`reporter_email`（必填，最长 100 字符）、`reporter_company`（可选，最长 100 字符）、`captcha_verify_param`（SaaS 环境必填的人机验证码参数；私有化部署无需提供）
`images`	可选，图片文件，可携带多个；单个文件不超过 5 MB，请求整体不超过 50 MB，超出的图片将被忽略，仅保留前 10 个

调用成功返回创建的故障 ID：

{
  "data": {
    "incident_id": "664f1b2c8f2a1c0012ab34cd"
  }
}

快速开始

协作空间

故障管理

故障复盘

状态页

分析看板

集成配置

配置中心

高级功能

集成中心

最佳实践

开启外部提报

提交页面

提交后的处理

通过 API 提交

延伸阅读

​开启外部提报

​提交页面

​提交后的处理

​通过 API 提交

​延伸阅读

开启外部提报

提交页面

提交后的处理

通过 API 提交

延伸阅读