要約：◀▼
アクションビルダーをincident.ioと連携させることで、ワークフロー内でのインシデント管理を自動化できます。このインテグレーションにより、アクションフローで直接インシデントの作成、更新、参照、検索が可能になり、コラボレーションとインシデント対応が向上します。認証には専用のサービスアカウントを使用し、APIトークンを安全に管理することで、インシデント管理インテグレーションの制御とセキュリティを維持できます。
Incident.ioは、チームがインシデントに効果的に対応し、解決するためのインシデント管理プラットフォームです。アクションビルダーでincident.ioコネクタを使用すると、Zendeskのアクションフローで直接、インシデンドの作成や管理、インシデントの詳細の更新、およびインシデント情報の取得を行うことができます。
incident.ioをアクションビルダーに接続する
外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。
- アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
- すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
- APIキーベースのツール（OpenAIなど）の資格情報を管理する場合、キーは、セキュアな保管場所または資格情報管理ツールに保存することをお勧めします。
認証用のAPIトークンを生成するには
- incident.ioアカウントにサインインします。
- 「設定」に移動します。
- 「APIトークン」に移動します。
- 必要な権限を設定して、新しいAPIトークンを作成します。
- APIトークンを保存するか、ウィンドウを開いたままにして、Zendeskにコピー＆ペーストできるようにしておきます。このトークンは、incident.ioをアクションビルダーに接続する際に必要になります。
- 管理センターで、サイドバーにある「
アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。 - アクションフローを新規作成するか、既存のアクションフローを編集します。
- ステップサイドバーを開きます。
- 「外部アクション」セクションで、「incident.io」をクリックします。
- 「接続」をクリックします。
- incident.ioの指示に従って認証を行い、接続を完了します。メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細情報、およびincident.ioで利用可能なアクションが表示されます。
アクションフローでのIncident.ioアクションの使い方
incident.ioアクションステップを使用して、インシデントの作成、更新、参照、検索を行うことができます。
インシデントを作成する
「インシデントを作成」アクションを使用して、指定した詳細情報を含む新しいインシデントをincident.ioに作成します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Name、Severityオプション：
メモ：Visibilityの設定には「パブリック」または「プライベート」があります（デフォルトは「パブリック」です）。Call URLには、インシデントコールへのリンクや、ZoomやGoogle Meetなどのブリッジへのリンクを設定できます。
|
| 出力 | インシデントの詳細情報：ID、名前、ステータス、深刻度、作成日時など |
インシデントを更新する
「インシデントを更新する」アクションを使用して、incident.ioの既存のインシデントのプロパティを更新します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Incident IDオプション：
メモ：Visibilityの設定には「パブリック」または「プライベート」があります（デフォルトは「パブリック」です）。Call URLには、インシデントコールへのリンクや、ZoomやGoogle Meetなどのブリッジへのリンクを設定できます。
|
| 出力 | 更新インシデントの詳細情報：ID、名前、ステータス、深刻度、更新日時など |
インシデントを参照する
「インシデントを参照する」アクションを使用して、特定のインシデントに関する詳細情報を取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Incident ID
|
| 出力 | インシデントに関するすべての詳細情報：ID、名前、概要、ステータス情報（IDおよび名前）、深刻度の情報（IDおよび名前）、コールURL、およびタイムスタンプなど |
インシデントを検索する
「インシデントを検索する」アクションを使用して、さまざまなフィルター条件に基づいてインシデントを検索します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | オプション：Status category、Severity、Incident
type、Created at (date range)、Updated at (date range)、After
cursor、Page size
メモ：日付範囲のフィルターは、「YYYY-MM-DD~YYYY-MM-DD」の形式を使用します。1ページあたりのインシデント数は1～250件です。
|
| 出力 | インシデントのリスト：ID、名前、概要、ステータス情報（IDおよび名前）、深刻度の情報（IDおよび名前）、作成日時などの情報を含む。ページネーションカーソルも含まれる。 |