トリガーの概要
トリガーは、Genesys Cloud 内のリソースであり、Genesys Cloud 内で発生する特定のイベントに対する反応を顧客が設定できるようにします。アクションは、アーキテクトで作成できるワークフローです。ワークフローの作成方法の詳細については、以下を参照してください。建築家について。
トリガーには3つの主要コンポーネントが含まれる：
- トピック名 ： アクションを呼び出したいトピックまたはイベント。
- ワークフロー・ターゲット ： マッチしたイベントに対して取るべきアクション。
- 条件:イベントが実行されるには、イベントが満たす必要がある基準。
トピック名
次のリストは、Genesys Cloud でトリガーを作成するときに使用できる通知トピックの一部の例です。 新しいトピックは定期的に更新されますが、トピックは組織によって異なる場合があります。
v2.users.{id}.activityv2.detail.events.conversation.{id}.acd.endv2.detail.events.conversation.{id}.acd.startv2.detail.events.conversation.{id}.acwv2.detail.events.conversation.{id}.wrapupv2.detail.events.conversation.{id}.attributesv2.detail.events.conversation.{id}.customer.endv2.detail.events.conversation.{id}.customer.startv2.detail.events.conversation.{id}.outboundv2.detail.events.conversation.{id}.user.endv2.detail.events.conversation.{id}.user.startv2.detail.events.conversation.{id}.voicemail.endv2.detail.events.conversation.{id}.voicemail.startv2.outbound.email.campaigns.contact.preContactv2.outbound.email.campaigns.contact.postContactv2.outbound.messaging.campaigns.contact.preContactv2.outbound.messaging.campaigns.contact.postContactv2.quality.evaluationsv2.operations.events.{id}v2.detail.events.collaboratechat.adhoc.{id}.messagesv2.detail.events.collaboratechat.group.{id}.messagesv2.workforcemanagement.managementunits.{id}.adherencev2.workforcemanagement.teams.{id}.adherencev2.users.{id}.wem.coaching.notificationv2.users.{id}.wem.learning.assignmentv2.users.{id}.workforcemanagement.adherencev2.users.{id}.workforcemanagement.schedulesv2.users.{id}.workforcemanagement.notificationsv2.users.{id}.workforcemanagement.timeoffrequestsv2.users.{id}.integrationpresence
トリガー ビューでトピックを選択すると、トピックのイベント スキーマが参照用に表示されます。GETリクエストで取得すると、組織で利用可能なトピックのリストを取得できます。詳細については、プロセス自動化APIそして利用可能なトピック。
ワークフロー対象
トリガーは、Architect ワークフロー フロー タイプをサポートします。 管理者はアーキテクトでワークフローを作成します。 トリガービューでは、ワークフローターゲットとしてアクティブなワークフローと発行済みワークフローのみを選択することができます。 入力パラメータがワークフローに送信されるデータ形式は、トップレベルのプリミティブ フィールドまたは JSON にすることができます。
- 文字列、列挙型、数値、ブール値などの最上位レベルのプリミティブがワークフローに送信されます。
- JSONデータ形式の場合、イベント全体が JSON オブジェクトとしてワークフローに送信されます。設定するワークフロー入力変数
jsonDataJSON 型です。
ワークフローの詳細については、Work with workflows を参照してください。
条件
条件とは、トリガーがワークフローターゲットを呼び出す基準のリストである。 条件表現には3つの部分がある：
- JSONパス: 比較するイベントの部分を定義する。 JSONPathは、JSONドキュメントをトラバースして解析し、特定の要素を見つけるために使用される言語です。 Jayway JsonPath Evaluator または JSONPath テスト ユーティリティ ツールを使用して、JSON ペイロードと JSONPath ステートメントの応答を確認することもできます。
- オペレーター: JSON パス出力と値を比較するために使用される比較タイプを定義します。 文字列の比較では大文字と小文字が区別されます。トリガー ビューで、オペレーター リストの説明を表示するには、フィルター演算子のヘルプを表示する。
- 価値:単一の値または値のリストを取る操作のための、ユーザー定義の値または値。入力値には文字列、数値、ブール値を指定できる。演算子の選択に応じて、値の入力タイプが変わります。 値の入力タイプによって比較の精度が保証されます。
演算子 入力タイプ 大なり小なり 数字 LessThanOrEqual 数字 等しい オブジェクト
ノットイコール オブジェクト
LessThan 数字
グレーターザン 数字
次にある オブジェクトの配列
ノットイン オブジェクトの配列
次の値を含む オブジェクト
すべて オブジェクトの配列
存在する ブール型
サイズ 数字
注記:トリガーには最大 10 個の条件を設定できます。ワークフローを開始するには、すべての条件を満たす必要があります。複数の条件のいずれかが true の場合 (OR ロジック) にワークフローを呼び出すには、それぞれ独自の条件セットを持つ複数のトリガーを作成する必要があります。
タイミング設定
トリガーがワークフローを呼び出すと、ワークフローは即座に、または設定された遅延時間に従って開始されます。 トリガーの有効期限 (TTL) を構成して、構成された時間が経過するとワークフローが実行されないようにすることもできます。 たとえば、ステータス変更ワークフローのトリガー処理に遅延がある場合、設定時間後にワークフローを実行することは意味がありません。
次に、トリガーを作成する。
