集成
连接 Sentry
Sentry 项目中未解决的错误会显示在项目中，新错误会立即显示。
在哪里连接
在 VentionDesk 中的运维 › 来源 › “添加来源”，类别选择错误，然后选择Sentry。只有所有者可以连接、编辑和移除。
分步说明
- 在 Sentry 中打开 Settings › Developer Settings › Custom Integrations，点击“Create New Integration” › “Internal Integration”。名称：“VentionDesk”。
- 权限尽量收紧：Project“Read”、Issue & Event“Read”、Organization“Read”，其余全部“No Access”。这样 VentionDesk 只读取。
- 如需使用“已解决”按钮（在 VentionDesk 中，以及 Claude 通过“将错误标记为已解决”），请将 Issue & Event 设为“Read & Write”——即作用范围 event:write。VentionDesk 会先在 Sentry 中将错误标记为已解决，然后才在自己这边标记。没有此权限时，VentionDesk 只读取：“已解决”会让错误保持未解决，并告知缺少哪项权限。
- 在“Webhooks”下勾选“issue”。保存后，VentionDesk 会在“运维” › “来源” › Sentry 下显示 Webhook 地址；然后将其填为“Webhook URL”。
- 保存集成，复制“Tokens”下的令牌和“Credentials”下的 client secret，并将两者连同组织 slug 一起填写在这里。VentionDesk 通过查询未解决的 issue 检查访问权限。
- VentionDesk 每十分钟获取一次已分配项目中未解决的 issue；Webhook 会立即报告新出现和重新打开的 issue。然后在项目页面的“分析” › “关联错误来源”中，将每个项目与其在服务商处的项目对应起来。
- 对于每个错误，VentionDesk 只获取标识、缩短的标题（其中的电子邮件和 IP 地址会被遮盖）、级别、状态、事件数和受影响用户数、首次和最近出现时间以及指向服务商的链接。堆栈跟踪、事件、用户数据、IP 地址和请求保留在服务商处，也不会从 Webhook 中存储。
对话框需要填写的内容
| 字段 | 填写内容 | 来源 |
|---|---|---|
| API 令牌 | 必填 | 机密 | 内部集成的令牌（Settings › Developer Settings › Custom Integrations › 您的集成 › Tokens）。 |
| 组织 slug | 必填 | 位于地址中：sentry.io/organizations/<slug>/ 或 <slug>.sentry.io。 |
| 区域 | 可选 | 欧盟区域的账户（de.sentry.io）填“de”，否则留空。不支持自托管的 Sentry 服务器。 |
| Client secret | 可选 | 机密 | 仅用于 Webhook：VentionDesk 用它校验签名（Sentry-Hook-Signature）。位于集成的“Credentials”下。 |
| 自动创建任务 | 可选 | “an”（默认，开启）或“aus”（关闭）。开启时：达到阈值或级别为“fatal”的错误会为 Claude 创建一次任务。 |
| 阈值（事件数） | 可选 | 事件数达到该值时创建任务。留空则为 10。 |
VentionDesk 加密存储机密信息，且不会再次显示。只有在服务商确认访问后才会保存；编辑连接时如果机密字段留空，则保留原有值。