文字列、数値、およびブール変数は 入力 そして 出力 プロパティ 変数が 入力 財産は はいその値は外部データソースによって設定できます。 変数が 出力 財産は はいその値は対話オブジェクトに保存され、呼び出しが終了した後にプログラムで取得できます。 これらの特性は相互に排他的ではありません。 いずれかまたは両方を変数に対して有効にできます。

これらのプロパティを有効にした変数は、入力変数、出力変数、またはその両方と呼ばれます。 これらの用語を理解する方法は次のとおりです。

  • 変数は 入力変数 InputプロパティがYesの場合 その値は からの入力 Architectコールフローなどの外部ソース。

  • OutputプロパティがYesの変数は 出力変数。 スクリプトが実行されると、変数に割り当てられた値はスクリプト外で使用するために保存されます。 その値は に出力 スクリプト実行時の外部ストレージ

  • どちらのプロパティもYesに設定できるため、変数は入力変数と出力変数の両方になることができる。

  • リスト変数を入力として使用すると、会話上の値がカンマで分割されます。
  • リスト変数を出力として使用する場合、そのリストは会話上でカンマで結合されます。

動的変数を入力変数または出力変数として使用することはできません。

新しい変数の場合、入力と出力は両方ともデフォルトのnoになります。 変数を使用する既存のスクリプトがある場合、Genesys Cloudはこれらの変数に対して入力と出力をyesに設定し、スクリプトが下位互換性を持つようにします。

出力プロパティ

出力 propertyを使用すると、データアクションを設定したり、連絡先リストに補足列を追加したりすることなく、呼び出し終了後に使用するスクリプト変数の値を格納できます。 「出力」が「はい」に設定されていると、このスクリプト変数の値が会話オブジェクトに書き込まれます。 その保存された値は、顧客の外部プロセスによってプログラムで取得できます。 変数を出力変数変数として使用するには、有効にします 出力. スクリプトの実行中にこの変数の値が変わると、会話オブジェクトは3秒で更新されます。

会話オブジェクト内のキーと値のペア

変数は、キーと値のペアとして対話オブジェクトに書き込まれます。 プラットフォームAPIを使ってそれらを取得することができます。 会話エンドポイント。 変数名をキーとして使用して会話の参加者属性オブジェクトを照会します。

"participants": [
  {
    "attributes": {
      "scripterOutputVariable1": "value",
      "scripterOutputVariable2": "value"
    },
],
  • 変数が出力のみの場合、Genesys Cloudは、別の参加者の変数データを確認しない限り、その変数の値をエージェント参加者に適用します。その場合、データの同期を維持するために、GenesysCloudは他の参加者を更新します。
  • 入力と出力の両方が真の場合、スクリプトはデータが見つかった参加者にデータを添付します。ほとんどの場合、それはカスタマー参加者です。 それ以外の場合、デフォルトの場所はエージェントの参加者です。

例えば、 もしの データが来る から アーキテクト スルー 入力変数 それからArchitectを配置 可変データ にの カスタマー参加者 そして 今後のアップデート にそれ 変数オーバーライド の 値 にの カスタマー参加者

 メモ:   Genesys Cloudは、v2/分析/会話ではなく、v2/会話に出力変数を追加します。 

データアクションに関するよくある質問 出力変数

スクリプトからデータを保存する外部データアクション方法は、複雑な情報を出力してからストアドプロシージャを介してデータベースに転送する必要があるカスタマーに適しています。 Outputプロパティを使用すると、スクリプトで収集したデータを簡単に保存できます。

  • [出力]を[はい]に設定すると、文字列、数値、またはブール変数が、検索、取得、および関連付けが容易なキー/値ペアとしてパブリックAPIの会話エンドポイントに書き込まれます。

  • このプロセスを使用して動的変数とオブジェクト変数を格納することはできません。 複雑なオブジェクトデータや動的変数を保存するには、代わりにデータアクションを使用してください。

入力プロパティ

の 入力 propertyは、この変数の値をArchitectコールフローなどの外部ソースによって設定できるかどうかを示します。 入力データを受信する変数の入力を「はい」に設定します。 InputがNoに設定されていると、外部ソースが値を送信しても、変数は外部値を受け入れません。 変数を使用するには、 入力変数 、有効 入力

顧客が保護するデータ

安全なデータを取得して安全なデータを設定するための会話設定を出力する

いつ 出力 変数のオプションが有効になっている場合、このスクリプト変数の値は会話オブジェクトに書き込まれます。 顧客はプログラムで変数の値を取得して、顧客とのやり取り中に機密データを出力できるようにすることができます。 必ず無効にしてください 出力 この変数に入力されたデータが顧客とのやり取り中に安全でない方法で使用されないようにするための変数のオプション。 詳細については、を参照してください。 利用可能なスクリプトアクション。 The 安全なデータを取得する安全なデータを設定する 顧客が保護するデータ 機能は、顧客の機密データを照会および更新する正しい方法です。 詳細については、を参照してください。 保護されたデータの取得アクション保護されたデータの設定アクション。