トリガーの概要

トリガーは、Genesys Cloud 内で発生した特定のイベントに対する反応を設定できる Genesys Cloud 内のリソースです。アクションは、アーキテクトで作成できるワークフローです。ワークフローの作成方法の詳細については、Genesys Cloud Resource Centerの「アーキテクトについて」を参照してください。

トリガーには3つの主要コンポーネントが含まれる：

トピック名 ：アクションを呼び出したいトピックまたはイベント。
ワークフロー・ターゲット ：マッチしたイベントに対して取るべきアクション。
条件: イベントが処理されるために満たされなければならない基準。

トピック名

次のリストは、Genesys Cloud でトリガーを作成するときに使用できる通知トピックの一部の例です。新しいトピックは定期的に更新されますが、トピックは組織によって異なる場合があります。

v2.users.{id}.activity
v2.detail.events.conversation.{id}.acd.end
v2.detail.events.conversation.{id}.acd.start
v2.detail.events.conversation.{id}.acw
v2.detail.events.conversation.{id}.wrapup
v2.detail.events.conversation.{id}.attributes
v2.detail.events.conversation.{id}.customer.end
v2.detail.events.conversation.{id}.customer.start
v2.detail.events.conversation.{id}.outbound
v2.detail.events.conversation.{id}.user.end
v2.detail.events.conversation.{id}.user.start
v2.detail.events.conversation.{id}.voicemail.end
v2.detail.events.conversation.{id}.voicemail.start
v2.outbound.email.campaigns.contact.preContact
v2.outbound.email.campaigns.contact.postContact
v2.outbound.messaging.campaigns.contact.preContact
v2.outbound.messaging.campaigns.contact.postContact
v2.quality.evaluations
v2.operations.events.{id}
v2.detail.events.collaboratechat.adhoc.{id}.messages
v2.detail.events.collaboratechat.group.{id}.messages
v2.workforcemanagement.managementunits.{id}.adherence
v2.workforcemanagement.teams.{id}.adherence
v2.users.{id}.workforcemanagement.adherence
v2.users.{id}.workforcemanagement.schedules
v2.users.{id}.workforcemanagement.notifications
v2.users.{id}.workforcemanagement.timeoffrequests
v2.users.{id}.integrationpresence

トリガービューでトピックを選択すると、トピックのイベントスキーマが参照用に表示されます。GETリクエストで取得すると、組織で利用可能なトピックのリストを取得できます。詳細については、プロセス自動化APIそして利用可能なトピック。

ワークフロー対象

トリガーは、Architect ワークフローフロータイプをサポートします。管理者はアーキテクトでワークフローを作成します。トリガービューでは、ワークフローターゲットとしてアクティブなワークフローと発行済みワークフローのみを選択することができます。入力パラメータがワークフローに送信されるデータ形式は、トップレベルのプリミティブフィールドまたは JSON にすることができます。

文字列、列挙型、数値、ブール型などのトップレベルのプリミティブがワークフローに送信されます。
For JSON data format, the entire event is sent to the workflow as a JSON object. The workflow must be configured to have an input variable named jsonData of type JSON.

注記:Architect のワークフロー属性では大文字と小文字が区別されます。ワークフローで属性を参照する場合は、イベントスキーマに表示されるとおりに大文字と小文字を正確に区別するようにしてください。

ワークフローの詳細については、Work with workflows を参照してください。

条件

条件とは、トリガーがワークフローターゲットを呼び出す基準のリストである。条件表現には3つの部分がある：

JSONパス: 比較するイベントの部分を定義する。 JSONPathは、JSONドキュメントをトラバースして解析し、特定の要素を見つけるために使用される言語です。 Jayway JsonPath Evaluator または JSONPath テストユーティリティツールを使用して、JSON ペイロードと JSONPath ステートメントの応答を確認することもできます。
オペレーター: JSON パス出力と値を比較するために使用される比較タイプを定義します。文字列の比較では大文字と小文字が区別されます。トリガービューで、オペレーターリストの説明を表示するには、フィルター演算子のヘルプを表示する。

価値:単一の値または値のリストを取る操作のための、ユーザー定義の値または値。入力値には文字列、数値、ブール値を指定できる。演算子の選択に応じて、値の入力タイプが変わります。値の入力タイプによって比較の精度が保証されます。

演算子	入力タイプ
大なり小なり	数字
LessThanOrEqual	数字
等しい	オブジェクト
ノットイコール	オブジェクト
LessThan	数字
グレーターザン	数字
次にある	オブジェクトの配列
ノットイン	オブジェクトの配列
次の値を含む	オブジェクト
すべて	オブジェクトの配列
存在する	ブール型
サイズ	数字

注記:トリガーには最大 10 個の条件を設定できます。ワークフローを開始するには、すべての条件を満たす必要があります。複数の条件のいずれかが true の場合 (OR ロジック) にワークフローを呼び出すには、それぞれ独自の条件セットを持つ複数のトリガーを作成する必要があります。

タイミング設定

トリガーがワークフローを呼び出すと、ワークフローは即座に、または設定された遅延時間に従って開始されます。トリガーの有効期限 (TTL) を構成して、構成された時間が経過するとワークフローが実行されないようにすることもできます。たとえば、ステータス変更ワークフローのトリガー処理に遅延がある場合、設定時間後にワークフローを実行することは意味がありません。

次に、トリガーを作成する。