トリガーの概要
トリガーは、Genesys Cloud 内で発生した特定のイベントに対する反応を設定できる Genesys Cloud 内のリソースです。 アクションは、アーキテクトで作成できるワークフローです。 ワークフローの作成方法の詳細については、Genesys Cloud Resource Centerの「アーキテクトについて 」を参照してください。
トリガーには3つの主要コンポーネントが含まれる：
- トピック名 ： アクションを呼び出したいトピックまたはイベント。
- ワークフロー・ターゲット ： マッチしたイベントに対して取るべきアクション。
- 条件: イベントが処理されるために満たされなければならない基準。
トピック名
次のリストは、Genesys Cloud でトリガーを作成するときに使用できる通知トピックの一部の例です。 新しいトピックは定期的に更新されますが、トピックは組織によって異なる場合があります。
v2.users。{id}.アクティビティv2.detail.events.conversation。{id}.acd.endv2.detail.events.conversation。{id}.acd.startv2.detail.events.conversation。{id}.acwv2.detail.events.conversation。{id}.ラップアップv2.detail.events.conversation。{id}.属性v2.detail.events.conversation。{id}.customer.endv2.detail.events.conversation。{id}.customer.startv2.detail.events.conversation。{id}.アウトバウンドv2.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.品質評価
トリガー ビューでトピックを選択すると、トピックのイベント スキーマが参照用に表示されます。 GETリクエストで取得すると、組織で利用可能なトピックのリストを取得できます。 詳細については、プロセス自動化API 。
ワークフロー対象
トリガーは、Architect ワークフロー フロー タイプをサポートします。 管理者はアーキテクトでワークフローを作成します。 トリガービューでは、ワークフローターゲットとしてアクティブなワークフローと発行済みワークフローのみを選択することができます。 入力パラメータがワークフローに送信されるデータ形式は、トップレベルのプリミティブ フィールドまたは JSON にすることができます。
- 文字列、列挙型、数値、ブール型などのトップレベルのプリミティブがワークフローに送信されます。
- JSONデータ形式の場合、イベント全体が JSON オブジェクトとしてワークフローに送信されます。 ワークフローを構成する必要がありますという名前の入力変数を持たせるには
jsonデータJSON 型。
ワークフローの詳細については、Work with workflows を参照してください。
条件
条件とは、トリガーがワークフローターゲットを呼び出す基準のリストである。 条件表現には3つの部分がある：
- JSONパス: 比較するイベントの部分を定義する。 JSONPathは、JSONドキュメントをトラバースして解析し、特定の要素を見つけるために使用される言語です。 Jayway JsonPath Evaluator または JSONPath テスト ユーティリティ ツールを使用して、JSON ペイロードと JSONPath ステートメントの応答を確認することもできます。
- オペレーター: JSON パス出力と値を比較するために使用される比較タイプを定義します。 文字列の比較では大文字と小文字が区別されます。トリガー ビューで、オペレーター リストの説明を表示するには、フィルター演算子のヘルプを表示する。
- 値: 単一の値または値のリストを取る操作のための、ユーザー定義の値または値。 入力値には文字列、数値、ブール値を指定できる。 オペレータの選択に応じて、値の入力タイプも変わる。 値の入力タイプは、比較の正確さを保証する。
演算子 入力タイプ 大なり小なり 数字 LessThanOrEqual 数字 等しい オブジェクト
ノットイコール オブジェクト
LessThan 数字
グレーターザン 数字
次にある オブジェクトの配列
ノットイン オブジェクトの配列
次の値を含む オブジェクト
すべて オブジェクトの配列
存在する ブール型
サイズ 数字
タイミング設定
トリガーがワークフローを呼び出すと、ワークフローは即座に、または設定された遅延時間に従って開始されます。 トリガーの有効期限 (TTL) を構成して、構成された時間が経過するとワークフローが実行されないようにすることもできます。 たとえば、ステータス変更ワークフローのトリガー処理に遅延がある場合、設定時間後にワークフローを実行することは意味がありません。
Next, learn how to create a trigger.
