--- title: "Zoho イベントリスナー" url: https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/zoho-event-listeners/ description: "Catalystは、コンポーネント、カスタム、およびZoho Event Listenersを提供し、コンポーネントやカスタムソースで発生する特定のイベントをリッスンし、イベント発生時に独自のロジックを実行できます。" last_updated: 2026-08-17T12:16:04Z service: Cloud Scale type: general --- # Zoho Event Listeners ### はじめに > **注意:** Catalystは、**Signals**と呼ばれる新しいイベントバスサービスを提供しています。このサービスは、現在の*Cloud Scale Event Listeners*コンポーネントの大幅なアップグレードです。Catalyst Signalsサービスの詳細については、[こちら](https://docs.catalyst.zoho.com/ja/signals/)をご覧ください。 Zoho Event Listenersは、Catalystの外部、つまり他のZoho製品やサービスで発生するイベントをリッスンします。これらのEvent Listenersは、Zohoサービス内の特定の設定されたアクションをリッスンし、コンポーネントおよびカスタムEvent Listenersと同様に、イベント発生時に関連するターゲットFunctionsまたはCircuitsをトリガーします。 Catalystは現在、以下のZohoサービスとの連携をサポートしています: * **[Zoho CRM](https://www.zoho.com/en-in/crm/)** > **注意:** プロジェクト内にZohoおよびカスタムEvent Listenersを最大4つ作成できます。Catalystでは、各Zoho Event Listener内に最大50のルールを作成できます。この制限の引き上げをリクエストするには、support@zohocatalyst.comまでサポートにご連絡ください。各リクエストはケースバイケースで対応いたします。 以下の表は、Zoho Event Listenerに関連付けることができる、サポートされているZohoサービスでのイベント発生の一覧を示しています:
Zohoサービス イベント
Zoho CRM Emails Resubscribe, Partner Leads Rejected, Partner Leads Approved, Partners Rejected, Partners Approved, People Rejected, People Approved, Email Unsubscribe, Scheduled Call Not Attended, Calls Missed, Calls Incoming, Calls Updated, Calls Created, Partner Leads Updated, Partner Leads Created, Partners Updated, Partners Created, People Updated, People Created, Email Sent, Campaign Member Status, Webforms Submit, Emails Insights Bounce, Email Insights Click, Email Insights Open, Email Incoming, Sales Orders Converted, Quotes Converted, Leads Converted, Purchase Orders Rejected, Invoices Rejected, Sales Orders Rejected, Quotes Rejected, Price Books Rejected, Vendors Rejected, Solutions Rejected, Cases Rejected, Campaigns Rejected, Products Rejected, Deals Rejected, Accounts Rejected, Contacts Rejected, Leads Rejected, Purchase Orders Approved, Invoices Approved, Sales Orders Approved, Quotes Approved, Price Books Approved, Vendors Approved, Solutions Approved, Cases Approved, Campaigns Approved, Products Approved, Deals Approved, Accounts Approved, Contacts Approved, Leads Approved, Purchase Order Updated, Purchase Order Created, Invoices Updated, Invoices Created, Notes Updated, Notes Created, Sales Order Updated, Sales Order Created, Quotes Updated, Quotes Created, Price Books Updated, Price Books Created, Vendors Updated, Vendors Created, Solutions Updated, Solutions Created, Cases Updated, Cases Created, Campaigns Updated, Campaigns Created, Products Updated, Products Created, Deals Updated, Deals Created, Accounts Created, Contacts Updated, Contacts Created, Accounts Updated, Leads Updated, Leads Created
> **注意:** 上記のZoho CRMの標準モジュールで発生するイベントに加えて、CRMで作成する**任意のカスタムモジュール**で発生するイベントも設定できます。カスタムZoho CRMモジュールの作成と操作については、[こちらのヘルプページ](https://help.zoho.com/portal/ja/kb/crm/customize-crm-account/customizing-modules/articles/customize-modules)をご覧ください。 **覚えておくべき重要なポイント:** * Zoho CRMにアカウントを持っている必要があります。 * これらのサービスでは、Standard、Professional、または無料プランなど、任意のティアまたはエディションのアカウントを使用できます。 * すべてのZohoサービスとの連携は、[連携設定](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/integrations-settings/#introduction)から管理できます。Event Listenersコンポーネントから、サポートされているZohoサービスのアカウントをZoho Event Listenerに関連付けるために追加すると、その特定のアカウントとの連携が作成され、*Integrations*設定に表示されます。 * 1つのZoho Event Listenerバスは特定のサービスに関連付ける必要はありません。Zoho Event Listenerを作成し、その中に複数のルールを設定でき、それぞれをサポートされている任意のZohoサービスで発生するさまざまなイベントに関連付けることができます。 * Zoho Event Listener内の1つのルールは、Zohoサービス内の特定のイベント発生にのみ関連付けることができます。たとえば、同じEvent Listener内で、あるルールをPurchase Order Updatedイベントに、別のルールをZoho CRMのLeads Createdイベントに関連付けることができます。 * 以前に別のルールが既に作成されている同じサービス、アカウント、イベント、および詳細フィルターに対してルールを作成することはできません。つまり、Catalystでは同じ設定に対する重複ルールの作成は許可されていません。ただし、異なる[詳細フィルター](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/zoho-event-listeners/#create-a-rule-in-a-zoho-event-listener)を追加することで、既に設定されているイベントに対してルールを作成できます。 Zoho Event Listenerの動作を例で理解しましょう: Zoho CRMアカウントの特定のorgでInvoices Createdイベントに対するZoho Event Listenerルールを関連付けたとします。このルールのターゲットFunctionsとして*Function1*と*Function2*を設定します。関連付けられたCRM orgで請求書が作成されるたびに、Catalystはイベントをキャプチャし、Zoho Event Listenerに設定されたルールをトリガーします。そのルールはターゲットFunctionsである*Function1*と*Function2*の実行を呼び出します。 > **注意:** 各イベントに対して詳細フィルターを追加し、イベントが発生した場合にルールが実行される特定の条件を定義することもできます。フィルターは各Zohoサービスの各イベントによって異なります。 他のEvent Listenerタイプと同様に、発生したイベントのイベントデータは、事前定義されたJSON形式でターゲットFunctionsまたはCircuitsに渡されます。このデータは、ターゲットFunctionまたはCircuitで処理され、必要なアクションが実行されます。データはZohoサービスとそこで発生するイベントに基づいて異なります。 たとえば、ルールがZoho CRMのVendors Approvedイベントに関連付けられている場合、そのサンプルイベントデータは以下のようになります: ```json { "project_details": { "id": 57*************, "project_name": "Eventbus" }, "event_bus_details": { "name": "ThirdPartyBus", "id": 57************* }, "data": { "subscriber": { "org_id": "15709179", "name": "ZohoCRM", "id": "111118000000000995" }, "data": [ { "Created_Time": "2022-09-22T07:25:15+00:00", "Last_Activity_Time": null, "Secondary_Email": null, "Owner": { "name": "Owner Name", "id": "25490*****" }, "Modified_Time": "2022-09-22T07:25:15+00:00", "Designation": null, "Company": "leadcompany", "Name": "leadLastname", "City": null, "Modified_By": { "name": "UserName", "id": "25490*****" }, "Last_Enriched_Time": null, "Description": null, "id": "2549000000109002", "Modified_Time": "2022-09-22T07:25:16+00:00", "Fax": null, "Created_Time": "2022-09-22T07:25:16+00:00", "Full_Name": "MyLead", "Created_By": { "name": "UserName", "id": "25490****" }, "id": "1728819000000440052", "Last_Name": "leadLastname", "Email": null } ], "publisher": { "org_id": "15709004", "name": "ZohoCRM", "id": "111118000000002003" }, "signal_info": { "subscription_id": "111118000000047572", "publisher_module_api_name": "Contacts", "generic_api_name": "Crm_New_Contacts", "api_name": "Crm_New_Contacts", "org_id": "15709005", "id": "111118000000003114", "module_name": "ZSignalsCustom3", "additional_params": null } }, "current_project": { "id": 57*************, "project_name": "Eventbus" }, "action": "ZohoEvents Produce", "source_entity_id": 570000000003015, "source": "ZohoEvents", "event_time": 1568192053790 } ``` 渡されるイベントデータには、CRM org、承認されたベンダー、ベンダーを承認したCRMユーザーのメタデータ、Vendorモジュールの詳細、プロジェクトの詳細などに関するデータが含まれます。 それでは、CatalystコンソールからZoho Event Listenersを操作してみましょう。 ### Zoho Event Listenerの作成 以下の方法でZoho Event Listenerを作成できます: 1. Catalystコンソールの_Amplify_内のEvent Listenersセクションから**Create Event Listener**をクリックします。 ![catalyst_el_page](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_page.webp) 2. Event Listenerの名前と説明を入力します。タイプとして**Zoho Events**を選択します。 ![catalyst_el_zoho_create](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_create.webp) 3. **Create**をクリックします。 Zoho Event Listenerが作成され、Event ListenersページにIDと、コンポーネントEvent Listenerと同じ[パフォーマンス統計](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/component-event-listeners/)とともに表示されます。 ![catalyst_el_zoho_created](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_created.webp) Event Listenerの詳細を表示し、ルールを作成するには、タイルの**View**をクリックします。 ### Zoho Event Listenerでのルールの作成 以下の方法でZoho Event Listenerにルールを作成できます: 1. Zoho Event Listenerのページから**Create Rule**をクリックします。 ![catalyst_el_zoho_rule_create_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_1.webp) 2. ポップアップウィンドウから、Event Listenerを作成するサポートされているZohoサービスを選択します。**Next**をクリックします。 ![catalyst_el_zoho_rule_create_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_2.webp) 3. ルールに関連付けるサービス内のアカウントを選択する必要があります。Event Listenersまたは[連携設定](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/integrations-settings/)を通じて以前に連携済みのアカウントがここに一覧表示されます。サービスに対して既に一覧表示されているアカウントを選択できます。 ![catalyst_el_zoho_rule_create_3](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_3.webp) 下部の**Add new account**をクリックして、サービス内の新しいアカウントを連携することもできます。これにより、サービスで既に作成されているアカウントを追加できる権限ページにリダイレクトされます。**Accept**をクリックして、Catalystにリクエストされた権限を付与します。 ![catalyst_el_zoho_rule_create_5](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_5.webp) Catalystコンソールのルール作成ポップアップに切り替えて、新しく連携したアカウントを選択できます。**Next**をクリックします。 ![catalyst_el_zoho_rule_create_5](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_4.webp) > **注意:** サービスの新しいアカウントとの連携を追加した場合、Catalystがそのアカウントのサービスと同期するのに2〜4分かかります。この同期を最小化でき、コンソールの下部に表示されます。同期が完了すると、最小化されたツールがルール設定の続行を求めます。中断したところから設定を再開できます。 4. ルールの詳細を設定できます。ルールの名前と説明を入力します。 ![catalyst_el_zoho_rule_create_6](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_6.webp) 5. 関連するサービスのイベントを選択してルールを設定します。ルールに対して選択できるイベントは1つのみです。各サービスで利用可能なイベントの一覧については、[前のセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/zoho-event-listeners/#introduction)を参照してください。 ![catalyst_el_zoho_rule_create_7](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_7.webp) 6. _Advanced Filters_の**\\+**アイコンをクリックして、ルール実行時の詳細フィルターをオプションで追加することもできます。これらのフィルターは、選択したサービスとイベントに基づいて異なります。 たとえば、_Purchase Orders Created_イベントの場合、以下の画像のように、_Shipping Country_をIndiaにする、または_Shipping Code_を空にしないなどの特定のパラメータを指定できます。その後、ルールは購入注文の_Shipping Country_がIndiaで、_Shipping Code_が空でない場合にのみ、そのイベントに対して実行されます。 > **注意:** ルールには最大25の詳細フィルターを追加できます。複数のフィルターを設定した場合、デフォルトですべてANDロジックで処理されます。 ![catalyst_el_zoho_rule_create_8](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_8.webp) ルール実行時に実行する1つ以上のターゲットFunctionsまたはCircuitsを選択します。 > **注意:** * ターゲットとしてイベントFunctionを選択した場合、ドロップダウンには[イベントFunctions](https://docs.catalyst.zoho.com/ja/serverless/help/functions/event-functions/)のみが一覧表示されます。 * ターゲットとしてCircuitを選択した場合、ドロップダウンには以前に作成したすべてのCircuitsが一覧表示されます。 * Event Listenerの設定前にイベントFunctionまたはCircuitを作成していない場合、ドロップダウンの**Create New**をクリックすると、[イベントFunction](https://docs.catalyst.zoho.com/ja/serverless/help/functions/event-functions/#introduction)または[Circuit](https://docs.catalyst.zoho.com/ja/serverless/help/circuits/implementation/#create-a-circuit)を作成するための各コンポーネントセクションに移動します。 7. **Create**をクリックします。 Zoho Event Listenerにルールが作成されます。Event Listenerのページにその詳細とともに一覧表示されます。ルールのソースには、関連付けられているサービスが表示されます。 ![catalyst_el_zoho_rule_created](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_created.webp) ルールの名前をクリックすると、その詳細とデータパターンを表示できます。 ![catalyst_el_zoho_rule_details](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_details.webp) > **注意:** Zohoイベントルールに対して、[Catalystコンポーネントイベントセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/component-event-listeners/#configure-alerts-for-catalyst-component-listeners)でアラートを設定したのと同じ方法で、[Application Alerts](https://docs.catalyst.zoho.com/ja/devops/help/application-alerts/introduction/)を設定できます。 ![catalyst_el_zoho_rule_details_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_details_2.webp) ### 本番環境のアカウント設定 Catalystでは、プロジェクトを本番環境にデプロイする前またはデプロイ時に、すべての既存のZoho Event Listenerルールについて、サポートされているZohoサービスの[本番環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/introduction/)用アカウントを設定する必要があります。 本番環境から直接_Event Listeners_コンポーネントでルールを設定または編集して本番アカウントに関連付けることはできません。ただし、以下のいずれかの場合に表示されるポップアップを通じてこれを実現できます: * [プロジェクトを初めて本番環境にデプロイ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/initial-deployment/)する場合、コンソールの右上隅にある環境ドロップダウンをクリックして本番環境に切り替えると、Catalystは自動的にポップアップを表示します。 * 初回以降に[プロジェクトを本番環境にデプロイ](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/subsequent-deployment/)する場合、このポップアップは、本番アカウントにまだ関連付けられていないルールの_Diff Generation_ステップの後に表示されます。これには、前回の本番デプロイ後に作成されたルールも含まれます。 ポップアップでは、以下の手順を実行する必要があります: 1. テキストボックスをクリックして、Zoho Event Listenerの各既存ルールに対して関連するサービスのアカウントを選択します。 ![catalyst_el_prod_migration_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_prod_migration_1.webp) 2. 一覧から同期済みアカウントを選択するか、新しいアカウントを追加します。一覧表示されるアカウントには、そのサービスの[_Integration_設定の_Production_セクション](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/integrations-settings/#add-an-integration-in-the-production-environment)で追加されたアカウントが含まれます。 ![catalyst_el_prod_migration_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_prod_migration_2.webp) 下部の**Add new account**をクリックして新しいアカウントを追加することもできます。手順は[前のセクション](https://docs.catalyst.zoho.com/ja/cloud-scale/help/event-listeners/zoho-event-listeners/#create-a-rule-in-a-zoho-event-listener)で説明したものと同じです。 > **注意:** ここから新しいアカウントを追加し、org同期が完了した後、このポップアップで**Refresh**をクリックすると同期が反映されます。新しく同期されたアカウントが一覧に表示されます。 3. このポップアップですべての既存のZoho Event Listenerルールのアカウントを設定した後、**Confirm**をクリックします。 ![catalyst_el_prod_migration_3](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_prod_migration_3.webp) プロジェクトを初めてデプロイしていたか、または後続のデプロイであったかに応じて、プロセスの次のステップがそれに応じて続行されます。 > **注意:** このポップアップは、ターゲット環境に未設定のルールがある場合、本番環境から開発環境にプロジェクトをデプロイする際にも表示されます。 ### Zoho Event Listenerのルールの編集 Zoho Event Listenerのルールを編集し、名前、説明、詳細フィルター、またはターゲットポイントおよび関連するイベントFunctionsやCircuitsを変更できます。 > **注意:** ルールに関連付けられているZohoサービス、アカウント、またはイベントを変更することはできません。 Zoho Event Listenerのルールを編集するには: 1. Event Listenerのページからルールの省略記号アイコンをクリックし、**Edit**をクリックします。 ![catalyst_el_rule_zoho_edit_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_edit_1.webp) 2. 必要な変更を行い、**Update**をクリックします。 ![catalyst_el_rule_zoho_edit_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_edit_2.webp) ### Zoho Event Listenerのルールの無効化 Zoho Event Listenerのルールを一時的に無効化する必要がある場合、ルールを無効化できます。これにより、Event Listenerはそのルールに関連付けられたイベントのリッスンを停止し、イベント発生時に関連するFunctionsやCircuitsは呼び出されません。 Zoho Event Listenerのルールを無効化するには: 1. Event Listenerのページからルールの省略記号アイコンをクリックし、**Disable**をクリックします。 ![catalyst_el_rule_zoho_disable_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_disable_1.webp) 2. 確認ポップアップで**Yes, Proceed**をクリックします。 ![catalyst_el_rule_zoho_disable_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_disable_2.webp) ルールが無効化されます。省略記号アイコンをクリックし、**Enable**をクリックすることで再度有効化できます。 ### Zoho Event Listenerのルールの削除 Zoho Event Listenerのルールを削除するには: 1. Event Listenerのページからルールの省略記号アイコンをクリックし、**Delete**をクリックします。 ![catalyst_el_rule_zoho_delete_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_delete_1.webp) 2. 確認ポップアップウィンドウで**Yes, Proceed**をクリックします。 ![catalyst_el_rule_zoho_delete_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_delete_2.webp) ### Zoho Event Listenerの編集 以下の方法でZoho Event Listenerの名前を変更したり、説明を編集したりできます: 1. Zoho Event Listenerのページ上部の省略記号メニューをクリックし、**Edit**をクリックします。 ![catalyst_el_zoho_edit_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_edit_1.webp) 2. Event Listenerの詳細を更新し、**Save**をクリックします。 ![catalyst_el_zoho_edit_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_edit_2.webp) ### Zoho Event Listenerの削除 Zoho Event Listenerを完全に削除するには: 1. Zoho Event Listenerのページ上部の省略記号メニューをクリックし、**Delete**をクリックします。 ![catalyst_el_zoho_delete_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_delete_1.webp) 2. 確認ポップアップで**Yes, Proceed**をクリックします。 ![](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_delete_2.webp)