現在のプランを確認
Suite、すべてのバージョン Growth、Professional、EnterpriseまたはEnterprise Plus
Support Team、ProfessionalまたはEnterprise
アクションビルダーをConfluenceなどの外部システムに接続すると、管理者は自動化ワークフロー内でZendeskを外部システムと連携させることができます。これにより、部門間のコラボレーションを強化し、複数のプラットフォームにまたがる一貫した利用体験を維持できます。
メモ：アクションフロー内の外部システムに関わるステップは、総称して「外部アクション」と呼ばれます。
この記事では、以下のトピックについて説明します。
  • Confluenceをアクションビルダーに接続する
  • アクションフローでConfluenceアクションを使用する
  • レシピ：Confluenceで事象レポートを作成し、Zendeskチケットをエスカレーションする

Confluenceをアクションビルダーに接続する

外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。

外部システムに接続して外部アクションをアクションフローで使用する場合は、以下のベストプラクティスをお勧めします。
  • アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
  • すべてのインテグレーションで、必要なスコープへアクセスできる必要があります。ただし、外部システムへの接続を許可する前に、スコープを確認し検証することが重要です。
  • APIキーベースのツール（OpenAIなど）の資格情報を管理する場合、キーをセキュアな保管場所または資格情報管理ツールに保存することが最適です。
アクションビルダーをConfluenceに接続するには
  1. 管理センターで、サイドバーにある「 アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。
  2. アクションフローを新規作成するか、既存のアクションフローを編集します。
  3. ステップサイドバーを開きます。
  4. 「外部アクション」セクションで、「Confluence」をクリックします
  5. 「接続」をクリックします。
  6. Atlassianの指示に従って認証を行い、接続を確立します。
    メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。

接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびConfluenceで利用可能なアクションが表示されます。

アクションフローでConfluenceアクションを使用する

ConfluenceのアクションステップはConfluenceページを作成、更新、コメントを追加する際に使用できます。

以下のConfluenceのアクションを選択できます。
  • Confluenceページを作成する
  • Confluenceページを更新する
  • フッターコメントを作成する
  • Confluenceページを検索する

Confluenceページを作成する

「ページを作成する」アクションを使用して、指定されたタイトルとテキストベースのコンテンツを含むConfluenceのページを新規作成します。

このアクションには以下の入力と出力が含まれます。

  変数
入力 space_id、title、value
出力 全メタデータ

Confluenceの既存のページを更新する

「Confluenceページを更新する」アクションを使用して、Confluenceの既存のページを指定されたテキストベースの変更で更新します。

このアクションには以下の入力と出力が含まれます。

  変数
入力 space_id、title、value
出力 全メタデータ

Confluenceの既存のページにフッターコメントを作成する

「フッターコメントを作成する」アクションを使用して、Confluenceの既存のページにコメントを追加します。

このアクションには以下の入力と出力が含まれます。

  変数
入力 page_id、value
出力 id、status

Confluenceページを検索する

「ページを検索する」アクションを使用して、Confluenceのぺージをタイトルで検索します。

このアクションには以下の入力と出力が含まれます。

  変数
入力 title
出力 id、title

レシピ：Confluenceで事象レポートを作成し、Zendeskチケットをエスカレーションする

以下のアクションフロー例では、Zendeskチケットが事象と判断された際、自動的にConfluenceにインシデントレポートを作成します。これらを自動化することで、開発チームへの迅速な共有、インシデントの一貫した記録、そして関係チーム間のスムーズな引き継ぎが可能になります。

このアクションフローは、次のステップで構成されることがあります。
  1. 以下の詳細情報を設定してアクションフロートリガを追加します。
    1. 「トリガを追加」をクリックします。
    2. ステップサイドバーのZendeskセクションで「チケット」をクリックします。
    3. 「プロパティ」をクリックし、「チケットタイプの変更」を選択します。
    4. 「条件を追加」をクリックします。
    5. 「変数」で、「チケットタイプの変更」と「タイプ」を選択します。
    6. 「演算子」には「=」を設定します。
    7. 「値」に「事象」と入力します。
  2. チケットの情報を検索するステップを追加します。
    1. アクションビルダーで、アクションフロートリガの下にあるステップを追加アイコン（）をクリックします。
    2. ステップサイドバーの「Zendeskアクション」で、「チケットを検索」をクリックします。
    3. 「チケットID」で、フィールドをクリックし、「変数を選択する」をクリックします。
    4. 変数メニューから、使用したい変数を出力するステップとして「チケットのエージェントの割り当て変更」を選択した後、「チケットID」を選択します。
  3. チケット担当者に関するユーザーの詳細を検索するステップを追加します。
    1. アクションビルダーで、ステップを追加アイコン（）をクリックします。
    2. ステップサイドバーのZendeskアクションで、「ユーザーを検索」をクリックします。
    3. 「ユーザーIDタイプ」で、「ZendeskユーザーID」を選択します。
    4. 「ユーザーID」で、「変数を追加」をクリックします。
    5. 変数メニューから、使用する変数を出力するステップとして「チケットを検索」を選択した後、「リクエスタID」を選択します。
  4. チケットのリクエスタの組織に関する詳細を検索するステップを追加します。
    1. アクションビルダーで、ステップを追加アイコン（）をクリックします。
    2. ステップサイドバーの「Zendeskアクション」で、「組織を検索する」をクリックします。
    3. 「組織IDタイプ」で、「Zendesk組織ID」を選択します。
    4. 「組織ID」で、「変数を追加」をクリックします。
    5. 変数メニューから、使用する変数を出力するステップとして「ユーザーを検索」を選択した後、「組織ID」を選択します。
  5. チケット、リクエスタ、組織について収集した情報に基づいてConfluenceページを作成するステップを追加します。
    1. アクションビルダーで、ステップを追加アイコン（）をクリックします。
    2. ステップサイドバーの「外部アクション」で、「Confluence」をクリックした後、「ページを作成する」を選択します。
    3. 「スペース」で、ページを作成する接続済みアカウントから適切なスペースを選択します。
    4. 「タイトル」に「事象レポート：」と入力した後、「変数を追加」をクリックします。
    5. 変数メニューから、使用する変数を出力するステップとして「チケットを検索」を選択した後、「チケットID」を選択します。
    6. 「コンテンツ」で、すべての事象で取得したいテンプレート内容を記述します。事象の解決を効率化するため、関連するチケットの情報とユーザー情報をそれぞれ「チケットを検索」、「ユーザーを検索」、「組織を検索する」の各ステップの変数として含めます。以下の例では変数はすべて斜体で表示されています。
      An incident was identified via the following Zendesk ticket: Ticket ID.

**Incident owner**
The following team member is serving as the incident owner: Ticket Assignee. They should be included in all decisions.

**Summary**
- Incident: Ticket Description
- Status: Ticket Status ID
- Reported by: Requester Name (Requester ID)
- Reporter's Organization: Requester's Organization Name (Organization ID)
- Reported at: Ticket Created at
  6. 「保存」をクリックします。
  7. 「テスト」をクリックし、アクションフローをテストします。
  8. オプションメニュー（）をクリックし、アクティベートを選択すると、Confluenceで事象レポートを自動作成するアクションフローの使用を開始できます。
Powered by Zendesk