アカウント ID の機会を取得カスタムアクション

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:2分
  • アカウント ID の機会を取得アクションは、特定の Salesforce アカウントの機会レコードを取得します。このアクションは、エージェントが、関連付けられている Salesforce アカウントに基づいて、顧客アカウントで利用可能な Salesforce 機会を表示するときに呼び出されます。

    このアクションは、[ すべての機会を取得] アクションに似ています。

    アクションの入力

    このアクションは、クエリーによって返される最大レコード数に加えて、クエリーパラメーターとして使用される入力として Salesforce アカウント ID も受け取ります。このパラメーターの値は、関連する Salesforce アカウント ID を使用して、顧客アカウントと Salesforce の機会をリンクする関係によって提供されます。詳細については、「定義済みの関連リストの作成」を参照してください。

    参照に必要な具体的な関係の例については、「関連リストを使用して顧客アカウントと Salesforce 機会の間の接続を作成する」で説明されています。

    Salesforce アカウント ID アクションの入力パラメーターには、デフォルト値がありません。

    アクション入力とそのデフォルト値が表示されている入力画面。

    [入力]:[前処理スクリプト]、[REST ステップ]、[後処理スクリプト] が表示されている [アクションアウトライン]。[ラベル]、[名前]、[タイプ]、および [必須] トグルボタンが表示されている [アクションの入力]。

    前処理ステップ

    前処理スクリプトステップでは、アクション入力自体を受け取ります。

    クエリを生成するためのピルピッカーを使用したアクション入力が表示されている前処理ステップ画面。

    前処理ステップスクリプトは、[ すべての機会を取得] アクションで作成されたものと同様の SELECT クエリを作成し、Salesforce アカウント ID に対するチェックを追加します。

    (function execute(inputs, outputs) {
      
      outputs.query = "query/?q=SELECT+Name,Id,AccountId,CloseDate,Amount,” +
                      “StageName,Probability,Type+FROM+Opportunity”         +
                      
                      "+WHERE+AccountId='" + inputs.salesforce_account_id + "
    
                      “+LIMIT+” + inputs.max_number_of_opportunity_records; 
      
    })(inputs, outputs);
    

    前処理出力は、すべての機会を得る アクションに類似したクエリです。

    REST ステップ、後処理ステップ、およびアクション出力

    これらのステップと出力は、[すべての機会を取得] アクションの場合と同じです。