イベント
イベントは、Catalyst Signalsの基本的な構成要素であり、環境またはアプリケーション内の重要な変更や発生を記述します。ユーザーインタラクションから外部刺激まで、幅広いアクションとトリガーを網羅します。これらのイベントは、さまざまな環境やアプリケーション間の無数のアクションやワークフローのトリガーとして機能します。
Catalyst Signalsでは、これらのイベントがリアルタイム処理、自動化、異種システムやアプリケーションのシームレスな統合を推進する上で重要な役割を果たします。このツールを使用して、イベントをキャプチャ、処理し、ターゲットと呼ばれるさまざまなエンドポイントにルーティングできます。
イベントの例を以下に示します:
- Eコマースマーケティングサイトでは、顧客が注文すると、在庫管理アプリケーションが自動的に更新されます。このシナリオでは、注文確定がイベントとなります。
- CRMアプリケーションでは、リードが作成されると、組織のWebサイトがリードの詳細に基づいて製品のレコメンデーションを表示します。このシナリオでは、リード作成がイベントとなります。
イベントステータス
Signals環境内のイベントを追跡するために、処理ステータスごとに分類されます。これは、イベントが関連付けられているルールの数やターゲットへの配信数に関係なく、イベントの全体的なパフォーマンスを表します。各ルールとターゲットの実行ステータスは、ログヘルプページで確認できます。
Signalsにおけるイベントの全体的なパフォーマンスステータスは以下のとおりです:
- Received - すべてのタイプのパブリッシャーからSignalsに受信されたイベント。
- In Queue - 受信済みだがまだ処理されていないイベント。
- In Progress - 現在処理中のイベント。
- Success - イベントがSuccessとマークされるためには、関連付けられたすべてのルールのすべてのターゲットに配信される必要があります。
- Failed - 関連付けられたいずれかのルールの少なくとも1つのターゲットへの配信に失敗したイベントは、全体ステータスがFailedとなります。
- Unmatched - ルールフィルターで設定された条件を満たさなかった、またはアクティブなルールやターゲットがないため処理されなかったイベント。
- Unprocessed - 非アクティブなパブリッシャー、ルール、またはターゲットに関連付けられたイベント。
- Dropped - 削除または無効化されたターゲットやルールに関連付けられたイベント。
全体的なイベントステータスは、各ルールとターゲットにおけるイベントのパフォーマンスを追跡するイベント実行ステータスによって決定されます。
- 全体的なイベントステータスは、次の優先順位に従います: Failed > Dropped > Success。
- いずれかの実行がFailedまたはDroppedとマークされた場合、イベントステータスもFailedまたはDroppedとマークされます。
- FailedとDroppedの両方の実行ステータスがイベントに存在する場合、Failedの優先度が高いため、全体的なイベントステータスはFailedとマークされます。
Zohoイベント
Zohoパブリッシャー向けの事前設定されたサービスには、それぞれ独自のスキーマを持つデフォルトのイベントが用意されています。この自動セットアップにより、手動でスキーマを作成する必要がなくなり、イベント管理が合理化されます。ZohoサービスからのイベントはCatalystと他のサービス間の内部認可プロセスを通じてSignalsに受信されます。そのため、Zohoパブリッシャーに対して認可設定を行う必要はありません。
Zoho CRM内で作成されたカスタムモジュールのイベントはデフォルトで定義されます。カスタムフィールドも定期的に同期され、Signalsでのイベント変換やWebhook作成時のイベントスキーマとのシームレスな統合が確保されます。カスタムフィールド同期がサポートされているサービスは以下のとおりです:
サポートされているZohoパブリッシャーの完全なリストはこちら
Catalystイベント
いくつかのCatalystサービスもSignalsのデフォルトCatalystパブリッシャーとしてサポートされています。各Catalystサービスには、定義済みのイベントと対応するスキーマのセットが用意されています。これらのイベントは、サービスがパブリッシャーとして追加されると自動的にリストされ、手動設定の必要がありません。
これにより、データ更新、キャッシュ変更、ファイルアクション、認証アクティビティなどのインフラストラクチャレベルの変更をシームレスにキャプチャし、モニタリング、分析、またはダウンストリームプロセスとの統合のためにSignalsを通じてルーティングできます。
-
Zohoパブリッシャーのデフォルトイベントは、Create、Delete、Update、Approve、Rejectの5つの主要なスコープに分類されます。各スコープは、ターゲットへのイベントの生成と送信をもたらす異なるタイプのアクションを表します。
カスタムイベント
Signalsでカスタムイベントを受信するには、カスタムパブリッシャーアプリケーション内にこれらのイベントのREST APIキーを設定する必要があります。さらに、スキーマを生成するために特定のイベントのサンプルペイロードが必要です。
Catalyst Signalsは、スキーマを生成するためのイベントペイロードの追加方法を2つ提供しています:
- ライブイベントペイロード: この方法で提供されるURLを使用して、API呼び出しのペイロードをキャプチャし、イベントスキーマとして使用するために必要なキーを入力できます。
- 手動イベントペイロード: この方法では、イベントスキーマを生成するためにペイロードを手動で提供する必要があります。
カスタムパブリッシャーのカスタムイベントとスキーマの作成手順
-
すべてのパブリッシャーにわたって最大200件のイベントを作成および設定できます。このしきい値は、ベースラインおよび標準シナリオ用に設定されています。このソフトしきい値を増加させるには、要件を記載の上support@zohocatalyst.comまでメールをお送りください。
-
カスタムイベントのサンプルペイロードの生成について詳しく学びましょう。
イベントスキーマ
イベントスキーマには、イベントに関する追加のコンテキストと情報を提供するメタデータが含まれています。イベントスキーマを編集して、要件に合わせてカスタマイズし、ターゲット環境でワークフローをさらにトリガーすることもできます。イベントスキーマの抽出または変換方法を学ぶ
これはCatalyst Signalsによって自動生成されますが、イベント処理を理解するためにイベントスキーマのデフォルトキーを分析してみましょう。
{
"$schema": "https://json-schema.org/draft/2020-12/schema#",
"type": "object",
"properties": {
"rule_id": {
"type": "string"
},
"target_id": {
"type": "string"
},
"version": {
"type": "integer"
},
"attempt": {
"type": "integer"
},
"account": {
"type": "object",
"properties": {
"org_id": {
"type": "string"
},
"project": {
"type": "object",
"properties": {
"environment": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"type": "object"
},
"id": {
"type": "string"
},
"time_in_ms": {
"type": "string"
},
"source": {
"type": "string"
},
"event_config": {
"type": "object",
"properties": {
"api_name": {
"type": "string"
},
"id": {
"type": "string"
}
}
}
}
}
}
}
}
以下は、参考としてスキーマに基づいて生成されたサンプルイベントペイロードです。
{
"rule_id": "123456789",
"target_id": "98765432",
"version": 1,
"attempt": 1,
"account": {
"org_id": "87359421",
"project": {
"environment": "DEVELOPMENT",
"name": "Project-Rainfall",
"id": "12950000000020015"
}
},
"events": [
{
"data": {
},
"id": "b05f449e-7eb0-4e7f-a40f-662820729d20",
"time_in_ms": 1721312979144,
"source": "publisher_id:12950000000021006/service:zohocrm/account:87394113",
"event_config": {
"api_name": "Lead Created",
"id": "12950000000021007"
}
}
]
}
スキーマのデフォルトAPIキー
| S.No. | API Name | データ型 | 説明 |
|---|---|---|---|
| 1 | rule_id | long string | イベントが生成されたルールの一意のIDです。 |
| 2 | target_id | long string | イベントとその詳細が配信されるターゲットの一意のIDを指します。 |
| 3 | version | integer | Catalyst Signalsにおけるイベントスキーマのバージョンを表すキーです。 |
| 4 | attempt | integer | イベントがターゲットに到達するための現在の試行回数を示します。 1より大きい試行回数は、ルールで設定されたリトライ回数に対応します。 |
| 5 | account | object | 以下のCatalystアカウントの詳細が含まれます:
|
| 6 | events | array | オブジェクトの配列です。配列内の各オブジェクトは、パブリッシャーの設定済みイベントの1つを指します。 この配列のオブジェクトに含まれるデフォルトキーは以下のとおりです:
|
- dataオブジェクト内のキーは、イベントを表し記述するため、イベントごとに異なります。要件に応じて、dataオブジェクト内のキーを追加/削除できます。
- スキーマからデフォルトキーを削除することもできます。イベントスキーマのカスタマイズ方法を学ぶ
最終更新日 2026-03-30 13:40:30 +0530 IST
Yes
No
Thank you for your feedback!
Send your feedback to us