参加者データの設定アクション

このアクションはデータカテゴリで利用できますのタスク エディターのツールボックス。アーキテクトは、属性または参加者データをvに割り当てることができます。オフィスまたはデジタル参加者。属性とは、対話中に一緒に移動する参加者に関する情報のことです。Architect では、参加者は着信音声またはデジタル フローの発信者、または発信フローの受信者です。

属性について

フロー変数とは対照的に、参加者データ属性は、あるフローから別のフローへの転送間で保持されます。たとえば、インタラクションが別のフローに転送されると、参加者の電話番号 (Call.Ani) は保持されません。ただし、情報を参加者データに保存すると、他のフローがそのデータにアクセスできるようになります。

各参加者属性は、フロー作成者が構成する名前と値の文字列です。属性を設定するには、属性に割り当てる名前と文字列値を指定します。参加者データ属性は、現在のフローを超えて保持する情報を保存するのに最も役立ちます。たとえば、別のフローからアクセスする情報や、現在のフローから完全に離れる情報などです。参加者データを使用すると、Genesys Cloud for Salesforce などのサードパーティ統合は、参加者データを介して設定したスクリーン ポップ URL 情報を受信できます。

メモ: 
  • 属性では大文字と小文字が区別されます。 フローの別の部分で既存の属性を使用する場合は、必ず元の属性の大文字と小文字を区別してください。
  • For bot flows, these limitations apply. If you reach the limit, the session closes and the flow follows the configured error handling path.
    • ボット セッションあたりの参加者データの設定アクション実行回数は 50 です。
    • ボット セッション中にフローが設定する属性の数は 50 です。
    • 属性値の最大長は 256 文字です。
  • 参加者データの設定には会話IDを持つ実際の会話が必要なので、このアクションはArchitectでは機能しません。テストオプション。
  • Genesys Cloud は、会話が完了した後、属性分析を保存しません。会話とセグメントが完了している場合、アナリティクスは会話を再度開いて変更を保存することはできません。例えば： 
    1. 着信インタラクションと着信フローがアクティブで、一部の参加者データがフロー内に書き込まれ、会話サービスと分析サービスで同期されます。
    2. システムはインタラクションをキューに転送し、待機します。キュー内のフローがアクティブで、一部の参加者データがフロー内に書き込まれ、会話サービスと分析サービスで同期されます。
    3. インタラクションはキューにルーティングされ、エージェントがそれを受け入れます。エージェント スクリプトには、会話サービスと分析サービスで同期された参加者データが含まれています。
    4. 顧客が切断し、エージェントはラップアップ状態になります。スクリプト内の出力変数によってトリガーされるエージェント スクリプトには、会話サービスでは同期されるが分析サービスでは同期されない、より多くの参加者データが含まれます。
    5. エージェントがラップアップを完了すると、そのエージェントのインタラクション ビューが閉じます。API 経由で、そのインタラクションとそのエージェント参加者の別の参加者データが会話サービスで設定および同期されますが、分析サービスでは設定および同期されません。

    タスクの参加者データの設定アクションは、インタラクション参加者に属性値を割り当てます。たとえば、参加者の情報を検索する「通話データ」アクションがある場合は、「参加者データの設定」アクションを使用して、「通話データ」アクションで見つかった結果を保存します。Architect がインタラクションを別のフローに転送する場合、2 番目のフローは「参加者データの取得」アクションを通じて情報を呼び出すことができるため、データ アクションを繰り返す必要がなくなります。

    注記:「参加者データの取得」アクションで属性を呼び出す場合は、属性名が前のフローの「参加者データの設定」名と完全に一致していることを確認します。Architect は、フロー全体にわたって参加者データ名を自動的に補完しません。正確に一致させるには、大文字と小文字を区別した名前をコピーして貼り付けます。

    音声フローでは、参加者データの設定アクションが対話中に参加者属性値を設定すると、フローの終了までクラウドで設定値が更新されなくても、後続の参加者データの取得アクションの対話で設定値が読み取られます。例えば：

    1. フローが属性名として「Foo」を使用して参加者データの取得アクションを発行すると、クラウドは「Hello」を返すため、参加者データの取得アクションで「Foo」にバインドされた変数は「Hello」に設定されます。
    2. フローは、その後に「フー」と設定参加者データアクション発行属性名と値として「さようなら」。
    3. 次にフローが繰り返され、属性名として「Foo」を使用して「参加者データの取得」アクションが発行されます。Set Participant Data を介して行われた更新はキューに入れられ、終了直前にのみクラウドに送信されるため、クラウドは以前と同じように「Hello」を返します。ただし、この場合、「Foo」にバインドされた変数は「Goodbye」に設定されます。これは、Get Participant Data が、クラウドから返される値を使用する前に、更新キューに入れられた値を使用するためです。
    注記:音声フローとは異なり、ボットフローは更新リストのキューを維持しません。代わりに、Architect は参加者データをクラウドに直接更新します。

    アクション 説明と使用

    名前

    		 アクションの識別名を入力してください。 ここで入力するラベルは、タスクシーケンスに表示されるアクションの名前になります。

    設定する属性を選択

    		 クリックの隣に属性属性の名前/値のペア構成を追加します。1 回の「参加者データの設定」アクションで、複数の属性 (「参加者データ」) を作成して保存できます。

    属性名

    属性に名前を割り当てます。属性名は文字列リテラルであり、空白にすることはできません。値を取得するには、参加者データの取得アクションでこの名前が完全に一致している必要があります。

    割り当てる値

    		 属性 (参加者データ) の値は、組み込み変数、フロー変数、作成したタスク変数などの文字列リテラルまたは式です。リテラル エディターまたは式エディターを使用して、属性に文字列、変数、または式の値を割り当てます。 

    ノート: 
    • 音声フローでは、参加者が属性値を変更するフローを進んでいる間に、参加者の属性値が変更されることがあります。参加者データの設定アクションを介して行われた更新は、フローが終了する直前までメモリのキューに入れられます。ただし、ボット フローは属性をすぐに送信します。
    • 更新は一括してクラウドに送信されます。フローによって同じ属性に対して複数の参加者データの設定アクションのインタラクションが発生した場合、最後のインタラクションで設定された値が優先されます。