アクションビルダーをJiraなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskを外部システムと連携させることができます。これにより、部門間のコラボレーションを強化し、複数のプラットフォームにまたがる一貫した利用体験を維持できます。
メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。
この記事では、以下のトピックについて説明します。
Jiraをアクションビルダーに接続する
外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。
外部システムに接続して外部アクションをアクションフローで使用する場合は、以下のベストプラクティスをお勧めします。
- アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
- すべてのインテグレーションで、必要なスコープへアクセスできる必要があります。ただし、外部システムへの接続を許可する前に、スコープを確認し検証することが重要です。
- APIキーベースのツール（OpenAIなど）の資格情報を管理する場合、キーをセキュアな保管場所または資格情報管理ツールに保存することが最適です。
Jiraをアクションビルダーに接続するには
- 管理センターで、サイドバーにある「
アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。 - アクションフローを新規作成するか、既存のアクションフローを編集します。
- ステップサイドバーを開きます。
- 「外部アクション」セクションで、「Jira」をクリックします
- 「接続」をクリックします。
- Atlassianの指示に従って認証を行い、接続を確立します。メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびMicrosoftカレンダーで利用可能なアクションが表示されます。
アクションフローでJiraアクションを使用する
Jiraアクションを使用すると、チケットに基づいてJira課題を自動的に作成したり更新したりできます。たとえば、Zendeskのチケットで報告されたバグに対して自動的にJira課題を作成したり、Zendeskのチケットを終了する前にJira課題のステータスを確認したり、チケットの割り当てに基づいてJira課題の割り当てを更新したり、チケットの処理中にJira課題のステータスを変更したりするなど、多様な操作が可能になります。
以下のJiraアクションを選択できます。
Jira課題を作成する
課題を作成アクションを使用して、接続されたJiraプロジェクトに新しい課題を作成します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 |
project_id、summary、issue_type_id、assignee_id、priority_id、description、labels
|
| 出力 |
id、key、self
|
Jira課題を取得する
課題を取得アクションを使用して、特定のJira課題の詳細情報を取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 |
issue_idまたはissue_key
|
| 出力 | 課題の全メタデータ |
Jira課題を編集する
課題を編集アクションを使用して、Jira課題の詳細情報（概要、担当者、説明など）を変更します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 |
project_id、summary、issue_type_id、assignee_id、priority_id、description、labels
|
| 出力 |
id、key、self
|
Jira課題のステータスを変更する
課題をトランジションアクションを使用して、Jira課題のワークフローのステータスを変更します。たとえば、作業開始時に「ToDo」から「進行中」に変更します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 |
issue_id または issue_key、transition_id
|
| 出力 | なし |