--- title: "イベント" url: https://docs.catalyst.zoho.com/ja/signals/help/events/ description: "Catalyst Signalsのイベントは、アプリケーション内の重要な変更や発生をキャプチャし記述するためのコア要素です。" last_updated: 2026-03-30T08:10:30Z service: Signals type: general --- # イベント イベントは、Catalyst Signalsの基本的な構成要素であり、環境またはアプリケーション内の重要な変更や発生を記述します。ユーザーインタラクションから外部刺激まで、幅広いアクションとトリガーを網羅します。これらのイベントは、さまざまな環境やアプリケーション間の無数のアクションやワークフローのトリガーとして機能します。 Catalyst Signalsでは、これらのイベントがリアルタイム処理、自動化、異種システムやアプリケーションのシームレスな統合を推進する上で重要な役割を果たします。このツールを使用して、イベントをキャプチャ、処理し、[ターゲット](https://docs.catalyst.zoho.com/ja/signals/help/targets/key-aspects/)と呼ばれるさまざまなエンドポイントにルーティングできます。 イベントの例を以下に示します: - **Eコマースマーケティングサイト**では、顧客が注文すると、在庫管理アプリケーションが自動的に更新されます。このシナリオでは、注文確定がイベントとなります。 - **CRMアプリケーション**では、リードが作成されると、組織のWebサイトがリードの詳細に基づいて製品のレコメンデーションを表示します。このシナリオでは、リード作成がイベントとなります。 ### イベントステータス Signals環境内のイベントを追跡するために、処理ステータスごとに分類されます。これは、イベントが関連付けられているルールの数やターゲットへの配信数に関係なく、イベントの全体的なパフォーマンスを表します。各ルールとターゲットの実行ステータスは、[ログヘルプページ](https://docs.catalyst.zoho.com/ja/signals/help/logs/)で確認できます。 Signalsにおけるイベントの全体的なパフォーマンスステータスは以下のとおりです: - **Received** - すべてのタイプのパブリッシャーからSignalsに受信されたイベント。 - **In Queue** - 受信済みだがまだ処理されていないイベント。 - **In Progress** - 現在処理中のイベント。 - **Success** - イベントがSuccessとマークされるためには、関連付けられたすべてのルールのすべてのターゲットに配信される必要があります。 - **Failed** - 関連付けられたいずれかのルールの少なくとも1つのターゲットへの配信に失敗したイベントは、全体ステータスがFailedとなります。 - **Unmatched** - ルールフィルターで設定された条件を満たさなかった、またはアクティブなルールやターゲットがないため処理されなかったイベント。 - **Unprocessed** - 非アクティブなパブリッシャー、ルール、またはターゲットに関連付けられたイベント。 - **Dropped** - 削除または無効化されたターゲットやルールに関連付けられたイベント。 > **Note** 全体的なイベントステータスは、各ルールとターゲットにおけるイベントのパフォーマンスを追跡する[イベント実行ステータス](https://docs.catalyst.zoho.com/ja/signals/help/logs/#comprehensive-event-capture)によって決定されます。 - 全体的なイベントステータスは、次の優先順位に従います: **Failed > Dropped > Success**。 - いずれかの実行が**Failed**または**Dropped**とマークされた場合、イベントステータスも**Failed**または**Dropped**とマークされます。 - **Failed**と**Dropped**の両方の実行ステータスがイベントに存在する場合、Failedの優先度が高いため、全体的なイベントステータスは**Failed**とマークされます。 ### Zohoイベント [Zohoパブリッシャー](https://docs.catalyst.zoho.com/ja/signals/help/publishers/create-publisher/zoho-publishers/)向けの事前設定されたサービスには、それぞれ独自のスキーマを持つデフォルトのイベントが用意されています。この自動セットアップにより、手動でスキーマを作成する必要がなくなり、イベント管理が合理化されます。ZohoサービスからのイベントはCatalystと他のサービス間の内部認可プロセスを通じてSignalsに受信されます。そのため、Zohoパブリッシャーに対して認可設定を行う必要はありません。 [Zoho CRM](https://www.zoho.com/en-in/crm/)内で作成された**カスタムモジュール**のイベントはデフォルトで定義されます。**カスタムフィールド**も定期的に同期され、Signalsでのイベント変換やWebhook作成時のイベントスキーマとのシームレスな統合が確保されます。カスタムフィールド同期がサポートされているサービスは以下のとおりです: - [Zoho Bigin](https://www.bigin.com/) - [Zoho Billing](https://www.zoho.com/in/billing/) - [Zoho Books](https://www.zoho.com/in/books/) - [Zoho CRM](https://www.zoho.com/en-in/crm/) - [Zoho Expense](https://www.zoho.com/in/expense/) - [Zoho Inventory](https://www.zoho.com/in/inventory/) - [Zoho Invoice](https://www.zoho.com/us/invoice/) [サポートされているZohoパブリッシャーの完全なリストはこちら](https://docs.catalyst.zoho.com/ja/signals/help/publishers/create-publisher/zoho-publishers/) ### Catalystイベント いくつかのCatalystサービスもSignalsのデフォルト[Catalystパブリッシャー](https://docs.catalyst.zoho.com/ja/signals/help/publishers/create-publisher/catalyst-publishers/)としてサポートされています。各Catalystサービスには、定義済みのイベントと対応するスキーマのセットが用意されています。これらのイベントは、サービスがパブリッシャーとして追加されると自動的にリストされ、手動設定の必要がありません。 これにより、データ更新、キャッシュ変更、ファイルアクション、認証アクティビティなどのインフラストラクチャレベルの変更をシームレスにキャプチャし、モニタリング、分析、またはダウンストリームプロセスとの統合のためにSignalsを通じてルーティングできます。 > **Notes:** * [カスタムイベントのサンプルペイロードを生成](https://docs.catalyst.zoho.com/ja/cli/v1/event-generate/sample-payload-catalyst-pub/)。 * Zohoパブリッシャーのデフォルトイベントは、**Create**、**Delete**、**Update**、**Approve**、**Reject**の5つの主要なスコープに分類されます。各スコープは、[ターゲット](https://docs.catalyst.zoho.com/ja/signals/help/targets/key-aspects/)へのイベントの生成と送信をもたらす異なるタイプのアクションを表します。 ### カスタムイベント Signalsでカスタムイベントを受信するには、カスタムパブリッシャーアプリケーション内にこれらのイベントのREST APIキーを設定する必要があります。さらに、スキーマを生成するために特定のイベントのサンプルペイロードが必要です。 Catalyst Signalsは、スキーマを生成するためのイベントペイロードの追加方法を2つ提供しています: - **ライブイベントペイロード**: この方法で提供されるURLを使用して、API呼び出しのペイロードをキャプチャし、イベントスキーマとして使用するために必要なキーを入力できます。 > **Note:** イベントペイロードをキャプチャするために提供されるURLは、**15分間**のみ有効です。 - **手動イベントペイロード**: この方法では、イベントスキーマを生成するためにペイロードを手動で提供する必要があります。 [カスタムパブリッシャーのカスタムイベントとスキーマの作成手順](https://docs.catalyst.zoho.com/ja/signals/help/publishers/create-publisher/custom-publishers/) > **Note:** * すべてのパブリッシャーにわたって最大**200件のイベント**を作成および設定できます。このしきい値は、ベースラインおよび標準シナリオ用に設定されています。このソフトしきい値を増加させるには、要件を記載の上[support@zohocatalyst.com](mailto:support@zohocatalyst.com)までメールをお送りください。 * [カスタムイベントのサンプルペイロードの生成](https://docs.catalyst.zoho.com/ja/cli/v1/event-generate/sample-payload-catalyst-pub/#sample-payload-for-custom-events)について詳しく学びましょう。 ### イベントスキーマ イベントスキーマには、イベントに関する追加のコンテキストと情報を提供するメタデータが含まれています。イベントスキーマを編集して、要件に合わせてカスタマイズし、ターゲット環境でワークフローをさらにトリガーすることもできます。[イベントスキーマの抽出または変換方法を学ぶ](https://docs.catalyst.zoho.com/ja/signals/help/targets/event-body-setup/event-transformation/) これはCatalyst Signalsによって自動生成されますが、イベント処理を理解するためにイベントスキーマのデフォルトキーを分析してみましょう。 **Event Schema** ```json { "$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" } } } } } } } } ``` 以下は、参考としてスキーマに基づいて生成されたサンプルイベントペイロードです。 **Sample Event Payload** ```json { "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 イベントが生成された[ルール](https://docs.catalyst.zoho.com/ja/signals/help/rules/key-aspects/)の一意のIDです。
2 `target_id` long string イベントとその詳細が配信される[ターゲット](https://docs.catalyst.zoho.com/ja/signals/help/targets/key-aspects/)の一意のIDを指します。
3 `version` integer Catalyst Signalsにおけるイベントスキーマのバージョンを表すキーです。
4 `attempt` integer イベントがターゲットに到達するための現在の試行回数を示します。 1より大きい試行回数は、ルールで設定された[リトライ回数](https://docs.catalyst.zoho.com/ja/signals/help/targets/key-aspects/#retry-policy)に対応します。
5 `account` object 以下のCatalystアカウントの詳細が含まれます:
  • **org_id (string)** - イベントが設定された[Catalyst組織](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-organizations/)IDを指します。
  • **project (object)** - Signalsサービスへのアクセスに使用される[Catalystプロジェクト](https://docs.catalyst.zoho.com/ja/getting-started/catalyst-projects/)の名前**(string)**、**environment (string)**、**id (string)**が含まれます。
6 `events` array オブジェクトの配列です。配列内の各オブジェクトは、[パブリッシャー](https://docs.catalyst.zoho.com/ja/signals/help/publishers/key-aspects/)の設定済みイベントの1つを指します。 この配列のオブジェクトに含まれるデフォルトキーは以下のとおりです:
  • **data (object)** - イベントの詳細を含むオブジェクトです。
  • **id (long string)** - この特定の発生に対するイベントの一意のIDを表します。
  • **time_in_ms (integer)** - イベント生成時刻をミリ秒単位で示すキーです。
  • **source (string)** - パブリッシャーID、サービス名、アカウントIDがスラッシュ（/）で区切られて含まれます。
  • **event_config (object)** - イベントの**id (long string)**と**api_name (string)**が含まれます。
> **Note:** * **data**オブジェクト内のキーは、イベントを表し記述するため、イベントごとに異なります。要件に応じて、dataオブジェクト内のキーを**追加/削除**できます。 * スキーマからデフォルトキーを削除することもできます。[イベントスキーマのカスタマイズ方法を学ぶ](https://docs.catalyst.zoho.com/ja/signals/help/targets/event-body-setup/event-transformation/)