外部APIアクションタイプの呼び出し

概要

管理者は、ルールエンジンの「外部APIの呼び出し」アクションタイプにより、APIを介した外部システムからのリクエストアクションでGainsightと外部システムとの間の接続を確立することができます。

Gainsightでは、この記事を読む前に、ルールの詳細の設定、データ設定、スケジュールのステップについて読んでおくことを推奨しています。詳細については、 ルールエンジンのHorizonエクスペリエンスの概要 の記事にある新規ルールの作成のセクションを参照してください。

前提条件

外部アクションおよびカスタムコネクタは、外部アクションページで設定する必要があります。

外部アプリケーションへの接続を設定したら、外部アクションページでアクションを作成できます。

 詳細については、Gainsightからの外部アクションの設定 (近日公開予定) の記事にあるカスタムコネクタの設定と外部アクションの設定のセクションを参照してください。

「外部APIの呼び出し」アクションの設定

「外部APIの呼び出し」アクションタイプを設定するには:

1. アクション設定のステップで、データセットにカーソルを移動します。アクションの追加アイコンが表示されます。
2. アクションの追加アイコンをクリックします。クライテリアの追加スライドアウトパネルが表示されます。
3. （オプション）クライテリアの追加をクリックして、データセットの条件を設定します。アクション項目は条件が満たされた場合にのみ実行されます。
4.  （オプション）続行をクリックします。「アクションの追加」スライドアウトパネルが表示されます。
5. クライテリアの追加スライドアウトパネルで、次の詳細を指定します。
   1. クライテリア名: 名前を入力します。
   2. フィールド：フィールドドロップダウンリストからフィールドを選択します。
   3. 入力タイプ: 入力タイプドロップダウンリストから入力を選択します。
   4. 演算子: 演算子ドロップダウンリストから演算子を選択します。
   5. 値: 数値を入力します。
   6. +アイコン: +アイコンをクリックしてフィールドを追加します。
   7. Xアイコン: Xアイコンをクリックしてフィールドを削除します。
   8. 高度なロジック: ここに高度なロジックを入力します。
6. 続行をクリックして、アクションの追加のステップに移動します。

7. アクションの作成ドロップダウンリストから「外部APIの呼び出し」アクションタイプを選択します。外部APIの呼び出し設定スライドアウトパネルが表示されます。
8. 外部APIの呼び出し設定スライドアウトパネルで、次の詳細を指定します。

• コネクタドロップダウンリストからコネクタを選択します。
• 外部アクションドロップダウンリストから外部アクションを選択します。
• （オプション）ルールアクションの説明を入力します。
• URL: 管理者は表示モードでURL を見ることができます。
• フィールドマッピング: ソースフィールドドロップダウンリストからソースフィールドを選択して、外部アクションフィールドをソースフィールドにマッピングします。
• （オプション）ソースフィールドドロップダウンリストでカスタム静的値の追加をクリックして、カスタム値を入力します。
• （オプション）接続の作成をクリックし、新しい接続を作成します。
• アクションを保存をクリックします。「外部APIの呼び出し」アクションが正常に保存されます。

その他のリソース

• Gainsightからの外部アクションの設定 (近日公開予定) 
• ルールエンジンのHorizonエクスペリエンスの概要