> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flashduty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 外部故障提交

> 开启外部提报后，客户或合作伙伴无需登录 Flashduty，即可通过专属链接或 API 向协作空间提交故障，并自动进入分派与通知流程

<Tip>**版本要求**：此功能需要 On-call 专业版及以上订阅。[了解更多](https://flashcat.cloud/flashduty/price/)</Tip>

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

## 开启外部提报

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

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

## 提交页面

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

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

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

## 提交后的处理

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

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

<Warning>
  如果协作空间没有配置分派策略，外部提交的故障不会分派给任何人，也不会产生通知。开启外部提报前，请确保协作空间已配置有效的[分派策略](/zh/on-call/channel/escalation-rule)。
</Warning>

## 通过 API 提交

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

```bash theme={null}
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：

```json theme={null}
{
  "data": {
    "incident_id": "664f1b2c8f2a1c0012ab34cd"
  }
}
```

## 延伸阅读

* [创建与配置协作空间](/zh/on-call/channel/create-edit)：外部提报开关所在的协作空间配置
* [配置分派策略](/zh/on-call/channel/escalation-rule)：决定外部提交的故障通知给谁