ZendeskからJira課題を作成する｜緊急通知と重複防止の設計
実現すること
Zendeskで障害として扱う問い合わせからJira課題を作成し、課題キーをチケットへ記録して、Slackへ緊急連絡する流れを設計します。課題作成と通知の成功を分けて管理することがポイントです。
解決する課題
担当者がZendesk、Jira、Slackのそれぞれに同じ内容を転記すると、Jira課題の作成漏れや、すでに作成した課題の二重登録が起こり得ます。調査依頼の入口と、課題キーを残す場所を揃えます。
自動化前後
- 自動化前
- 問い合わせを読んでJiraに登録し、課題URLをZendeskとSlackへ手動で貼り付ける。
- 自動化後の構成例
- 対象の変更を検知し、既存キーを確認して課題を作成・記録。通知が失敗した場合も、作成済み課題を見て引き継げる。
全体構成図
- 対象の変更を検知
障害用フォームへの変更など、運用で決めたイベントを起点にする。
- 既存の課題キーを確認
チケットを取得し、登録済みなら新しい課題を作らない経路へ分ける。
- Jira課題を作成
プロジェクト、課題タイプ、要約など必要な情報を渡す。
- Zendeskへ結果を記録
戻り値の課題キーを管理用の項目や内部メモへ残す。
- Slackへ緊急連絡
チケットと作成した課題の参照先を担当チームに知らせる。
必要な機能・契約条件・外部サービス
Zendeskのアクションフローと、Jira・Slackの接続を使います。基本フローの利用可否は契約と管理画面で判断します。各サービスで対象プロジェクト・投稿先にアクセスできるアカウントが必要です。外部で実行する操作は、接続したアカウントに帰属します。
Jiraの課題作成は標準コネクタで提供されています。必須の入力はプロジェクト、要約、課題タイプです。接続先プロジェクトの必須項目やカスタムフィールドによって、追加の設定が必要になります。
課題キーを内部メモに残すことと、Jira連携の「チケットをリンクする」操作は別です。後者にはZendesk Support for Jira integrationの設定が必要です。本構成例の中心は、課題を作り、キーをZendesk側に記録するところまでです。
設定手順
- テスト用のチケット、Jiraプロジェクト、Slackチャンネルを用意します。Jiraキーを保存する項目と、何を緊急とするかを決めます。
- 管理センターでフローを作成し、対象フォームへの変更など、開始するチケットイベントと条件を設定します。対象外の問い合わせで動かない条件を含めます。
- チケット情報を取得し、保存済みのJiraキーがあれば新規作成を見送る分岐を設けます。作成済み案件を通知だけ再実行する場合は、別の経路として設計します。
- Jiraのコネクタを選び、Atlassian側の案内で接続します。課題作成アクションにプロジェクト、要約、課題タイプを指定し、必要な説明や項目を割り当てます。
- 作成結果の課題キーをチケットの管理用項目や内部メモへ保存します。Slack通知はその後に置き、必要な場合だけ優先度を緊急へ更新します。
- Slackの通知にチケットURLと課題キーを含めます。両方へのアクセス権を持つ担当チームだけが読める投稿先を使います。
- 課題作成成功、キーの記録失敗、Slack通知失敗をそれぞれ確認するテストを設計します。実行ログとJiraの実データを照合してから、限定した範囲で有効化します。
テストでも実際の課題作成や通知が起こり得ます。実顧客の問い合わせや本番プロジェクトを、そのまま試験データにしないようにします。
注意と制限
「Jiraは作成できたがSlack通知は失敗した」という状態は、フロー全体の成否だけでは判断できません。通知のために最初から再実行すると、課題を二重に作る可能性があります。ログと保存済みキーを見て、どのステップまで終わったかを確認します。
事前にキーを調べる設計でも、並行実行、外部処理の成功後に応答を受け取れない場合、キーを保存する前の失敗までは完全に防げません。厳密に重複を防ぐ必要があれば、Jira側の検索・照合や、重複を管理する連携処理を追加して検証します。単純なタグだけで1回の実行を保証しません。
Jira課題作成とSlack投稿は外部操作としてクレジットの見積もり対象です。処理件数に加え、1件で行う外部操作の回数を見積もります。再試行が多い場合は、使用状況と実行ログを照合して運用を見直します。
標準機能と追加開発の境界
課題作成、Zendeskへの結果記録、Slack投稿は標準のステップを組み合わせる範囲です。チケットと課題の正式なリンクには別のJira連携設定が必要で、内部メモを書いただけでは双方向同期になりません。
独自の障害IDによる厳密な重複管理、複数Jira環境への振り分け、特殊な必須項目の変換、処理結果の継続同期は、標準コネクタで扱える入出力を確認したうえでAPI連携・追加開発を検討します。API・システム連携の支援では、例外時の復旧手順も含めて相談できます。
関連記事
設計・構築の相談
対象業務に合わせて、標準機能とAPI連携・追加開発の範囲を整理します。