Slack連携でチケット作成～なんだかんだでこれが便利～

:santa:これは「[Atlassian Advent Calendar 2024](https://qiita.com/advent-calendar/2024/atlassian)」の参加記事です。
:star:自社のアドベントカレンダーでも機械翻訳のことについて記事を書きました！よかったら[こちら](https://qiita.com/NaokoSatoL10N/private/90cf2d1a87a139dd1ebe)もご覧ください。

私はAtlassian製品を使用して6年以上が経ちます。タスク管理、バグのトラッキング、ナレッジシェアなど、便利な使い方を挙げればキリがないのですが、プレイヤーレベルで手軽に管理・運用でき、なおかつ使用頻度が高い機能は、私にとってはなんだかんだ「JiraとSlackの連携」でした。以下に紹介する使い方はごくシンプルなものですが、シンプルだからこそ汎用性が高いと感じます。

# 実現すること
社内のSlackで業務の依頼を受けた場合に、特定の絵文字でリアクションするだけで必要なJiraチケット（課題）が作成されるワークフローを作ります。
私はローカライズ（製品の日本語化支援/翻訳がメイン業務）のチームで仕事をしているので、Slackで翻訳の依頼が来た際にこのワークフローでよくチケットを作っています。

# 便利ポイント
- ラベルやコンポーネントの設定モレを防止できる
- チケット（課題）を作りつつ定型文の返信も自動で行える
- 要約（サマリー）の命名規則を統一できるため情報の一貫性が担保される

# 方法
1. Slackの任意のスペースで「ツール」を選択し、「ワークフロービルダー」を開きます。![2024-12-17_14-56-25.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/db5ac17c-3b31-ba1b-83e9-d9e526b607a0.png)


2. 「＋新しいワークフロー」→「ワークフローを構築する」をクリックします。![2024-12-17_14-58-19.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/b1c61d8f-9407-74fc-7048-e15fcfb001b3.png)


3. Workflowの開始条件として、「絵文字リアクションが使用された時」を選択します。![2024-12-17_14-59-27.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/7e248670-bbb0-fe19-1946-ea9bc9f7dbf2.png)

4. 絵文字と対象のチャンネルを設定して、「続行」をクリックします。![2024-12-17_15-03-09.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/571f4eaa-ea5c-94e6-0f1d-e52d71d53b69.png)


5. 次にいよいよJIRAをつなげます。（今回はJIRA Cloudを使用）ただし…連携機能を使用する場合はSlack管理者にあらかじめ許可されている必要があります。まだの場合は青字の「リクエスト」をクリックして管理者に聞いてみましょう。![2024-12-17_15-08-10.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/a6563512-fb17-df18-c43d-5a84426b7b4b.png)


6. 「JIRA Cloud」を展開し、今回は「課題を作成する」を選択します。![2024-12-17_15-13-43.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/8d54c971-3486-2107-df08-4b505b1dbd6b.png)

7. 使用するドメイン、プロジェクト、イシュータイプを選択します。「このステップのための情報収集フォームを生成する」のチェックボックスは空欄でかまいません。（ワークフローを使用するたびに異なる情報を入力したい場合は、チェックを入れてフォームの作成に進むこともできます。）ですが、今回はとことんシンプルにいきます。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/10bcb8d3-0b35-c709-d1a0-df1e3ab7eaff.png)
8. 「このステップに使用されているAtlassianアカウント」には自分のアカウントを設定します。そうでないとエラーメッセージが出てしまい、ワークフローを公開できませんのでご注意ください。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/70611b6e-301b-c342-76ff-18a7a02f57dc.png)

9. 次の画面は自由度が高いです。いつも手動でチケットを作成しているときと同じように、要約、担当者、コンポーネントなどを設定してください。終わったら「保存する」をクリックします。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/593a1708-f238-898b-2145-a55ab4ee4b47.png)
10. 課題が作成されたことをすぐに確認できるよう、チャンネルにメッセージが投稿されるようにします。今回は「スレッドでメッセージに返信する」を選択します。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/117beef9-3c1f-479c-c2b4-9199104f5d5c.png)
11. メッセージの設定を行います。メッセージにチケットのURLを含めたい場合は、「変数を挿入する」から「イシューURL」を選択してみてください。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/f183384a-32e8-fbd3-fd96-5b6752f5e1df.png)
12. 満足いくかたちに仕上がったら、ビルダー右上の「完了」をクリックし、必要な設定を行ってワークフローを公開します。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/3be8ed2b-0f11-6ce4-f533-dc2d201993ce.png)

# 使ってみると
自作自演ですが、Slackのメッセージにハートの絵文字を付けると…![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/f19767f8-074d-7a81-0e71-83e36e5cd5c2.png)
スレッドでボットがお返事してくれると共にJiraの課題のURLが共有されます。![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3945862/fe8b0530-b106-45b6-f0f7-f766c7dd108a.png)