スクリプト入力変数と出力変数

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

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

変数は入力変数 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 安全なデータを取得する と 安全なデータを設定する の 顧客が保護するデータ 機能は、顧客の機密データを照会および更新する正しい方法です。詳細については、を参照してください。保護されたデータの取得アクションと保護されたデータの設定アクション。