--- title: "Event Listeners de Zoho" url: https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/zoho-event-listeners/ description: "Catalyst proporciona event listeners de componentes y personalizados que escuchan ocurrencias de eventos específicos en los componentes o en una fuente personalizada, respectivamente, y te permiten ejecutar tu propia lógica cuando ocurre el evento." last_updated: 2026-08-17T12:16:04Z service: Cloud Scale type: general --- # Event Listeners de Zoho ### Introducción > **Nota:** Catalyst ahora te ofrece un servicio de bus de eventos completamente nuevo llamado **Signals**. Este servicio es una mejora significativa del componente actual *Cloud Scale Event Listeners*. Puedes obtener más información sobre el servicio Catalyst Signals [aquí](https://docs.catalyst.zoho.com/es/signals/). Los event listeners de Zoho escuchan eventos que ocurren fuera de Catalyst, en otros productos y servicios de Zoho. Estos event listeners escuchan una acción específica configurada en un servicio de Zoho y activan las funciones objetivo o circuits asociados cuando ocurre el evento, de manera similar a los event listeners de componentes y personalizados. Catalyst actualmente admite la asociación con los siguientes servicios de Zoho: * **[Zoho CRM](https://www.zoho.com/en-in/crm/)** > **Nota:** Puedes crear hasta 4 event listeners de Zoho y personalizados en un proyecto. Catalyst te permite crear hasta 50 reglas en cada event listener de Zoho. Puedes solicitar a Catalyst un aumento de este límite contactando a nuestro soporte en support@zohocatalyst.com. Atenderemos cada solicitud de forma individual. La siguiente tabla describe la lista de ocurrencias de eventos en los servicios de Zoho compatibles que se pueden asociar con un event listener de Zoho:
Servicio de Zoho Eventos
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
> **Nota:** Además de los eventos que ocurren en los módulos estándar de Zoho CRM mencionados anteriormente, también puedes configurar eventos que ocurren en **cualquiera de los módulos personalizados** que crees en tu CRM. Puedes aprender a crear y trabajar con módulos personalizados de Zoho CRM en [esta página de ayuda](https://help.zoho.com/portal/es/kb/crm/customize-crm-account/customizing-modules/articles/customize-modules). **Puntos importantes a recordar:** * Debes tener una cuenta en Zoho CRM para poder asociar ocurrencias de eventos de esos servicios. * Puedes tener cualquier nivel o edición de cuenta en estos servicios, como Standard, Professional o incluso los niveles gratuitos. * Puedes gestionar todas las integraciones con otros servicios de Zoho desde la configuración de [Integrations](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/integrations-settings/#introduction). Cuando agregas una cuenta de un servicio de Zoho compatible para asociarla con un event listener de Zoho desde el componente Event Listeners, se creará una integración con esa cuenta específica y se mostrará en la configuración de *Integrations*. * Un solo bus de event listener de Zoho no necesita estar asociado con un servicio específico. Puedes crear un event listener de Zoho y configurar múltiples reglas en él, y cada una puede estar asociada con diferentes eventos que ocurren en cualquier servicio de Zoho compatible. * Una sola regla en un event listener de Zoho solo puede asociarse con una ocurrencia de evento particular en un servicio de Zoho. Por ejemplo, puedes asociar una regla con un evento Purchase Order Updated y otra regla con un evento Leads Created de Zoho CRM en el mismo event listener. * No podrás crear una regla para el mismo servicio, cuenta, evento y filtros avanzados para los cuales ya se haya creado otra regla previamente. Es decir, Catalyst no permite crear reglas duplicadas para la misma configuración. Sin embargo, puedes crear una regla para un evento que ya esté configurado agregando diferentes [filtros avanzados](https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/zoho-event-listeners/#create-a-rule-in-a-zoho-event-listener). Entendamos mejor el funcionamiento de un event listener de Zoho con un ejemplo: Supongamos que asocias una regla de event listener de Zoho para un evento Invoices Created en una organización particular de tu cuenta de Zoho CRM. Configuras *Function1* y *Function2* como las funciones objetivo para esta regla. Ahora, cada vez que se cree una factura en la organización de tu CRM que fue asociada, Catalyst capturará el evento y activará la regla asociada configurada en el event listener de Zoho. La regla a su vez invocará la ejecución de las funciones objetivo *Function1* y *Function2*. > **Nota:** También podrás agregar filtros avanzados para cada evento para definir condiciones específicas en cuya ocurrencia la regla debe ejecutarse si el evento ocurre. Los filtros varían para cada evento en cada servicio de Zoho. De manera similar a los otros tipos de event listeners, los datos del evento ocurrido se pasan a las funciones objetivo o circuits en un formato JSON predefinido. Estos datos se procesan luego en la función objetivo o el circuit para llevar a cabo la acción requerida. Los datos varían según el servicio de Zoho y el evento que ocurre en él. Por ejemplo, si una regla está asociada con un evento Vendors Approved de Zoho CRM, estos serían los datos de evento de ejemplo: ```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 } ``` Los datos del evento que se pasan incluyen datos sobre la organización de CRM, el proveedor aprobado, metadatos sobre el usuario de CRM que aprobó al proveedor, detalles del módulo Vendor, detalles del proyecto y más. Ahora trabajemos con los event listeners de Zoho desde la consola de Catalyst. ### Crear un event listener de Zoho Puedes crear un event listener de Zoho de la siguiente manera: 1. Haz clic en **Create Event Listener** desde la sección Event Listeners en _Amplify_, en la consola de Catalyst. ![catalyst_el_page](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_page.webp) 2. Ingresa un nombre y una descripción para el event listener. Selecciona **Zoho Events** como el tipo. ![catalyst_el_zoho_create](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_create.webp) 3. Haz clic en **Create**. El event listener de Zoho se creará y se mostrará en la página de Event Listeners con su ID y las mismas [estadísticas de rendimiento](https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/component-event-listeners/) que el event listener de componentes. ![catalyst_el_zoho_created](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_created.webp) Puedes ver los detalles de un event listener y crear reglas en él haciendo clic en **View** en su mosaico. ### Crear una regla en un event listener de Zoho Puedes crear una regla en un event listener de Zoho de la siguiente manera: 1. Haz clic en **Create Rule** desde la página del event listener de Zoho. ![catalyst_el_zoho_rule_create_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_1.webp) 2. Selecciona un servicio de Zoho compatible para crear el event listener, desde la ventana emergente. Haz clic en **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. Debes seleccionar una cuenta en el servicio para asociar la regla. Las cuentas que ya hayas integrado previamente en Event Listeners o a través de la configuración de [Integrations](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/integrations-settings/) se listarán aquí. Puedes seleccionar una cuenta que ya esté listada para el servicio. ![catalyst_el_zoho_rule_create_3](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_3.webp) También puedes integrar una nueva cuenta en el servicio haciendo clic en **Add new account** en la parte inferior. Esto te redirigirá a una página de permisos donde puedes agregar una cuenta ya creada en el servicio. Haz clic en **Accept** para otorgar los permisos solicitados a Catalyst. ![catalyst_el_zoho_rule_create_5](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_5.webp) Puedes cambiar a la ventana emergente de creación de reglas en la consola de Catalyst y elegir la cuenta recién integrada. Haz clic en **Next**. ![catalyst_el_zoho_rule_create_5](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_4.webp) > **Nota:** Si agregas una integración con una nueva cuenta en un servicio, Catalyst tardará de 2 a 4 minutos en sincronizarse con el servicio para la cuenta. Puedes minimizar esta sincronización y se mostrará en la parte inferior de la consola. Después de que se complete la sincronización, la herramienta minimizada te pedirá que continúes con la configuración de la regla. Puedes reanudar la configuración desde donde la dejaste. 4. Ahora puedes configurar los detalles de la regla. Ingresa un nombre y una descripción para la regla. ![catalyst_el_zoho_rule_create_6](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_6.webp) 5. Selecciona un evento en el servicio asociado para configurar la regla. Solo puedes seleccionar un evento por regla. Consulta la [sección anterior](https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/zoho-event-listeners/#introduction) para ver una lista de eventos disponibles en cada servicio. ![catalyst_el_zoho_rule_create_7](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_7.webp) 6. También puedes agregar opcionalmente filtros avanzados para que la regla se ejecute haciendo clic en el icono **\\+** en _Advanced Filters_. Estos filtros variarán según el servicio y el evento que hayas seleccionado. Por ejemplo, para un evento _Purchase Orders Created_, puedes especificar ciertos parámetros como el _Shipping Country_ que sea India o el _Shipping Code_ que no esté vacío, como se muestra en la imagen a continuación. La regla solo se ejecutará para ese evento si el _Shipping Country_ de la orden de compra es India y si el _Shipping Code_ no está vacío. > **Nota:** Puedes agregar un máximo de 25 filtros avanzados en una regla. Si configuras múltiples filtros, todos se procesarán mediante lógica AND de forma predeterminada. ![catalyst_el_zoho_rule_create_8](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_create_8.webp) Selecciona una o más funciones objetivo o circuits para ejecutar cuando se ejecute la regla. > **Nota:** * Si eliges una event function como tu objetivo, la lista desplegable solo mostrará [event functions](https://docs.catalyst.zoho.com/es/serverless/help/functions/event-functions/). * Si eliges un circuit como tu objetivo, la lista desplegable mostrará todos los circuits que hayas creado previamente. * Si no has creado una event function o un circuit antes de configurar tu event listener, haz clic en **Create New** en la lista desplegable y serás dirigido a la sección del componente correspondiente para crear tu [event function](https://docs.catalyst.zoho.com/es/serverless/help/functions/event-functions/#introduction) o [circuit](https://docs.catalyst.zoho.com/es/serverless/help/circuits/implementation/#create-a-circuit). 7. Haz clic en **Create**. La regla se creará en el event listener de Zoho. Aparecerá en la página del event listener con sus detalles. La fuente de la regla mostrará el servicio con el que está asociada. ![catalyst_el_zoho_rule_created](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_created.webp) Puedes hacer clic en el nombre de una regla para ver sus detalles y patrón de datos. ![catalyst_el_zoho_rule_details](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_details.webp) > **Nota:** Puedes configurar [Application Alerts](https://docs.catalyst.zoho.com/es/devops/help/application-alerts/introduction/) para tus reglas de evento de Zoho, de la misma manera que configuraste alertas en la sección [Catalyst Component Events](https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/component-event-listeners/#configure-alerts-for-catalyst-component-listeners). ![catalyst_el_zoho_rule_details_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_rule_details_2.webp) ### Configurar cuentas para el entorno de producción Catalyst requiere que configures cuentas para el [entorno de producción](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/introduction/) en los servicios de Zoho compatibles para todas las reglas existentes de event listeners de Zoho antes o cuando despliegues tu proyecto a producción. No podrás configurar ni editar reglas directamente en el entorno de producción desde el componente _Event Listeners_ para asociarlas con cuentas de producción. Sin embargo, esto se puede lograr a través de la ventana emergente que se muestra en cualquiera de estos casos: * Si estás [desplegando tu proyecto a producción por primera vez](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/initial-deployment/), Catalyst mostrará automáticamente la ventana emergente cuando hagas clic en el desplegable de entorno en la esquina superior derecha de la consola para cambiar al entorno de producción. * Si estás [desplegando tu proyecto a producción posteriormente](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/subsequent-deployment/) después de la primera vez, esta ventana emergente se mostrará después del paso _Diff Generation_ para cualquier regla que aún no se haya asociado con una cuenta de producción. Estas también incluirán reglas que se crearon después del despliegue anterior a producción. La ventana emergente te requerirá realizar los siguientes pasos: 1. Elige una cuenta en el servicio asociado para cada regla existente en un event listener de Zoho haciendo clic en el campo de texto. ![catalyst_el_prod_migration_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_prod_migration_1.webp) 2. Elige una cuenta sincronizada de la lista o agrega una nueva cuenta. Las cuentas que se listan incluirán las cuentas que se agregaron en la sección [_Production_ de la configuración de _Integration_](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/integrations-settings/#add-an-integration-in-the-production-environment) para ese servicio. ![catalyst_el_prod_migration_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_prod_migration_2.webp) También puedes agregar una nueva cuenta haciendo clic en **Add new account** en la parte inferior. El proceso es el mismo que se explicó en la [sección anterior](https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/zoho-event-listeners/#create-a-rule-in-a-zoho-event-listener). > **Nota:** Después de agregar una nueva cuenta desde aquí y completar la sincronización de la organización, puedes hacer clic en **Refresh** en esta ventana emergente para que la sincronización se refleje. La cuenta recién sincronizada estará entonces presente en la lista. 3. Después de configurar las cuentas para todas las reglas existentes del event listener de Zoho en esta ventana emergente, haz clic en **Confirm**. ![catalyst_el_prod_migration_3](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_prod_migration_3.webp) Dependiendo de si estabas desplegando tu proyecto por primera vez o en una ocasión posterior, los siguientes pasos del proceso continuarán en consecuencia. > **Nota:** Esta ventana emergente también se mostrará al desplegar tu proyecto desde el entorno de producción al entorno de desarrollo, en caso de que haya reglas no configuradas en el entorno de destino. ### Editar una regla en un event listener de Zoho Puedes editar una regla en un event listener de Zoho y modificar su nombre, descripción, filtros avanzados o target point y sus event functions o circuits asociados. > **Nota:** No podrás cambiar el servicio de Zoho, la cuenta ni el evento con el que la regla está asociada. Para editar una regla en un event listener de Zoho: 1. Haz clic en el icono de puntos suspensivos de la regla desde la página del event listener, luego haz clic en **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. Realiza los cambios necesarios, luego haz clic en **Update**. ![catalyst_el_rule_zoho_edit_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_edit_2.webp) ### Deshabilitar una regla en un event listener de Zoho Puedes deshabilitar una regla en un event listener de Zoho si necesitas desactivarla temporalmente. Esto hará que el event listener deje de escuchar el evento con el que la regla está asociada, y las funciones o circuits asociados no se invocarán cuando ocurra el evento. Para deshabilitar una regla en un event listener de Zoho: 1. Haz clic en el icono de puntos suspensivos de la regla desde la página del event listener, luego haz clic en **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. Haz clic en **Yes, Proceed** en la ventana emergente de confirmación. ![catalyst_el_rule_zoho_disable_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_disable_2.webp) La regla se deshabilitará. Puedes habilitarla nuevamente haciendo clic en el icono de puntos suspensivos y haciendo clic en **Enable**. ### Eliminar una regla en un event listener de Zoho Para eliminar una regla en un event listener de Zoho: 1. Haz clic en el icono de puntos suspensivos de la regla desde la página del event listener, luego haz clic en **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. Haz clic en **Yes, Proceed** en la ventana emergente de confirmación. ![catalyst_el_rule_zoho_delete_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_rule_zoho_delete_2.webp) ### Editar un event listener de Zoho Puedes renombrar un event listener de Zoho o editar su descripción de la siguiente manera: 1. Haz clic en el menú de puntos suspensivos en la parte superior de la página del event listener de Zoho, luego haz clic en **Edit**. ![catalyst_el_zoho_edit_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_edit_1.webp) 2. Actualiza los detalles del event listener, luego haz clic en **Save**. ![catalyst_el_zoho_edit_2](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_edit_2.webp) ### Eliminar un event listener de Zoho Para eliminar un event listener de Zoho de forma permanente: 1. Haz clic en el menú de puntos suspensivos en la parte superior de la página del event listener de Zoho, luego haz clic en **Delete**. ![catalyst_el_zoho_delete_1](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_delete_1.webp) 2. Haz clic en **Yes, Proceed** en la ventana emergente de confirmación. ![](https://catalyst-docs-development.zohostratus.in/images/help/event-listeners/catalyst_el_zoho_delete_2.webp)