# Jira + Instatus

Source: https://instatus.com/help/zh-tw/integrations/jira

1. 前往 [Instatus Jira 整合](https://dashboard.instatus.com/integrations/jira)
2. 選擇自動建立與解決事件時要使用的範本
3. 複製你頁面的 webhook URL
4. 在你的 Jira 儀表板中，前往 Space Settings → Automation → Create rule → Create from scratch

![Jira Space Settings 的 Automation](https://instatus.com/help/integrations/jira-1.png)

![Jira 從頭建立規則](https://instatus.com/help/integrations/jira-2.png)

若要把自動化規則套用到所有 space，你需要切換到 _Global administration_ 並套用下列相同的規則：

5. 建立一條規則，在 Jira 議題被建立時建立事件

新增觸發條件 → 搜尋並選擇 _Work item created_

![Jira Work item created 觸發條件](https://instatus.com/help/integrations/jira-3.png)

6. 點擊 _Add condition_，然後選擇 _Work item fields condition_。把 Field 設為 _Issue type_，值設為你選定的議題類型。你也可以為此建立一個新的議題類型。

![Jira 針對 Issue type 的 Work item fields 條件](https://instatus.com/help/integrations/jira-4.png)

7. 新增一個動作元件，選擇 _Send web request_

8. 把步驟 1 的 webhook URL 貼到 request URL 欄位。HTTP 方法選 `POST`，request body 選 Custom data，並貼上下列內容：

```json
{
  "trigger": "down"
}
```

![Jira 使用 POST 方法的 Send web request 動作](https://instatus.com/help/integrations/jira-5.png)

9. 請確認這條自動化規則的 Actor 設為 _Automation for Jira_，以避免權限問題。你可以在 Rule details → Actor 中確認。

10. 點擊 next → Turn on rule，並為它命名

建立事件的規則完成了。接下來我們來建立
解決事件的規則：

11. 新增觸發條件 → 搜尋並選擇 _Work item transitioned_ → 把 To status 設為 _Done_，或任何代表已解決的狀態

![Jira 以 Done 狀態為目標的 Work item transitioned 觸發條件](https://instatus.com/help/integrations/jira-6.png)

12. 點擊 add condition，然後選擇 Work item fields condition。把
    Field 設為 _Issue type_，值設為與建立事件規則中
    所用的議題類型相同（步驟 6）

![Jira Issue type 條件](https://instatus.com/help/integrations/jira-7.png)

13. 新增一個動作元件，選擇 _Send web request_

14. 把步驟 1 的同一個 webhook URL 貼到 request URL 欄位。HTTP 方法選 `POST`，request body 選 Custom data，並貼上下列內容：

```json
{
  "trigger": "up"
}
```

![解決事件規則中的 Jira Send web request 動作](https://instatus.com/help/integrations/jira-8.png)

15. 請確認這條自動化規則的 Actor 設為 _Automation for Jira_，以避免權限問題。你可以在 Rule details → Actor 中確認。

16. 點擊 next → Turn on rule，並為它命名。解決事件的規則就建立完成了。

完成了！🎉