# Oyentes de eventos -------------------------------------------------------------------------------- title: "Introducción" description: "Catalyst proporciona event listeners de componentes, personalizados y de Zoho que escuchan ocurrencias de eventos específicos en los componentes de Catalyst, en una fuente personalizada o en un servicio de Zoho asociado, respectivamente, y te permiten ejecutar tu propia lógica cuando ocurre el evento." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/introduction/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Event Listeners ### Introducción Event Listeners es un componente de Catalyst Cloud Scale que funciona como un servicio de bus de eventos, escuchando eventos predefinidos y activando automáticamente las Event functions correspondientes o los Circuits objetivo. Es particularmente útil para automatizar tareas o flujos de trabajo recurrentes que están vinculados a eventos específicos dentro de tu aplicación. Con la arquitectura basada en eventos impulsada por Catalyst, este componente ayuda a garantizar la ejecución confiable y en tiempo real de acciones cada vez que ocurren esos eventos. 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í.<br /> Catalyst Event Listeners también te permite transportar un flujo de datos en tiempo real desde varios componentes de Catalyst en la aplicación, o desde fuentes personalizadas, hacia las funciones que se invocan como resultado. Puedes asociar reglas con un event listener y definir la fuente exacta que debe escuchar los eventos, así como las acciones que se deben tomar cuando ocurran. Existen tres tipos de Catalyst Event Listeners: 1. Catalyst Component Event Listener: El event listener de componentes de Catalyst puede vincular un evento que ocurrió en uno de tus componentes de Catalyst con la ejecución de una event function o un circuit objetivo. Se crea de forma predeterminada. 2. Custom Event Listeners: Puedes crear event listeners personalizados que funcionan de manera diferente al event listener de componentes de Catalyst. Cuando creas un event listener personalizado en Catalyst, se genera automáticamente una URL para él. Cada vez que el usuario final invoca esta URL, el event listener activa la ejecución de la event function o el circuit objetivo. 3. Zoho Events: También puedes crear event listeners de Zoho que escuchan y capturan eventos que ocurren en otros servicios de Zoho que hayas configurado, como Zoho CRM. Estos event listeners se invocan cada vez que ocurre un evento específico asociado en el servicio externo, y Catalyst ejecuta la event function o el circuit objetivo como resultado. Puedes acceder y configurar los event listeners de tu proyecto desde la consola de Catalyst. La consola también proporciona estadísticas sobre el rendimiento de cada uno de tus event listeners, detalles de los eventos en cola y el historial de ejecución detallado de cada regla de un event listener. También puedes ver un patrón de ejemplo de los datos que se enviarán a la función o circuit objetivo para cada regla. Catalyst también te ofrece la flexibilidad de crear alertas de aplicación para los event listeners directamente desde la sección de reglas de Event Listeners en la consola, en lugar de tener que navegar al componente Application Alerts. Nota: No podrás configurar ni trabajar con event listeners desde el CLI ni mediante los SDK. Sin embargo, puedes generar payloads de ejemplo tanto para fuentes de eventos de componentes como personalizadas en el CLI, y probar event functions en el entorno local. Consulta la página de ayuda de Event Generate para obtener más información. <br /> -------------------------------------------------------------------------------- title: "Beneficios" description: "Catalyst proporciona event listeners de componentes, personalizados y de Zoho que escuchan ocurrencias de eventos específicos en los componentes de Catalyst, en una fuente personalizada o en un servicio de Zoho asociado, respectivamente, y te permiten ejecutar tu propia lógica cuando ocurre el evento." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/benefits/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Beneficios 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í.<br /> 1. Habilitación de automatización y flujo de datos en la aplicación:<br /> Los event listeners de Catalyst reducen los esfuerzos manuales involucrados en la construcción de código complejo al facilitar fácilmente el flujo automatizado de datos y lógica entre varios componentes distribuidos y débilmente acoplados de tu aplicación. Cuando configuras un event listener y lo asocias con la ejecución de un comportamiento reutilizable, el flujo de trabajo se optimiza y automatiza en función de las ocurrencias de eventos. Esto permite un proceso de construcción de aplicaciones más rápido y efectivo. 2. Entrega de datos en tiempo real:<br /> Los event listeners de Catalyst entregan un flujo de datos en tiempo real desde los diversos componentes de tu aplicación o desde una fuente personalizada que definas. También te proporcionan control completo sobre estos datos en tiempo real, al permitirte enrutarlos y procesarlos según tus necesidades. Puedes habilitar a los componentes de tu aplicación para que reaccionen a los datos en tiempo real y construyan arquitecturas basadas en eventos de manera sencilla. 3. Procesamiento rápido y escalado automático:<br /> Catalyst admite la invocación de múltiples event listeners y reglas de varios tipos. Puedes configurar múltiples reglas en un event listener de componentes o de Zoho, y crear múltiples event listeners personalizados según tus necesidades. Estos pueden asociarse también con múltiples endpoints. Las funciones objetivo de las reglas invocadas se procesan sin ninguna reducción en el rendimiento de datos ni aumento en la latencia. Los servidores de Catalyst escalan automáticamente para proporcionar los recursos necesarios y mantener la consistencia del rendimiento de tu aplicación. 4. Automatización de flujos de trabajo a partir de una ocurrencia de evento:<br /> Puedes invocar un Circuit para la ejecución de una regla de event listener y orquestar un flujo de trabajo. Si bien puedes configurar múltiples event functions para que se activen con una regla de event listener, activar un Circuit te permite ejecutar múltiples funciones Basic I/O de manera secuencial o en paralelo, según cómo configures el circuit.<br /> Elegir un Circuit como objetivo de tu event listener también te permite manejar errores, realizar ejecuciones condicionales que son recursivas, secuenciales o paralelas, pasar datos procesados entre cada estado e incluso realizar manejo de respaldo en casos de fallo. 5. Estadísticas, eventos en cola y eventos procesados:<br /> Las estadísticas de un event listener que se muestran en la consola te permiten monitorear y analizar su rendimiento fácilmente. También puedes ver los eventos en cola que muestran los eventos capturados en tiempo real por los event listeners y que se están procesando actualmente. Además, también puedes pausar, eliminar, eliminar en masa y reanudar la cola de eventos. Después de ser procesados, puedes ver los detalles de los eventos procesados de cada regla en cada event listener. Los detalles de los eventos procesados contienen información sobre el tráfico de eventos y proporcionan información crucial sobre el historial de ejecución de cada regla en un event listener. 6. Compatible con restricciones presupuestarias:<br /> La forma innovadora de precios de Catalyst se calcula en función del número de llamadas API realizadas. Si detectas un error en tu aplicación, al pausar la cola pausas el procesamiento de los eventos y la ejecución de sus funciones asociadas. Puedes depurar mientras la cola está pausada o incluso eliminar toda la cola de eventos para asegurar que no se realicen llamadas API innecesarias durante la etapa de depuración, lo que te permite tener más control de tus recursos monetarios. <br /> -------------------------------------------------------------------------------- title: "Casos de uso" description: "Catalyst proporciona event listeners de componentes, personalizados y de Zoho que escuchan ocurrencias de eventos específicos en los componentes de Catalyst, en una fuente personalizada o en un servicio de Zoho asociado, respectivamente, y te permiten ejecutar tu propia lógica cuando ocurre el evento." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/use-cases/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Casos de uso 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í.<br /> Los Catalyst Event Listeners se pueden utilizar en los siguientes escenarios: * Una aplicación de eventos presenta los próximos eventos en una localidad. Cuando un usuario está interesado en un evento, hace clic en un botón CTA para ese evento y navega a la página del evento para ver más detalles al respecto. El clic en el botón invoca la URL de un event listener personalizado de Catalyst en segundo plano y pasa ciertos datos sobre el interés del usuario. Esta invocación de URL está asociada con una función objetivo que procesa los datos y envía un correo electrónico promocional automatizado y personalizado al usuario sobre próximos eventos similares al que le interesó. <br /> -------------------------------------------------------------------------------- title: "Terminología" 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-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/terminology/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Terminología 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í.<br /> Antes de continuar leyendo sobre los Catalyst Event Listeners, asegúrate de comprender los siguientes términos en el contexto de Catalyst: * Event Listener: Un event listener, ya sea de componentes, personalizado o de Zoho, puede activar la ejecución de event functions o circuits. No puede activar la ejecución de ningún otro tipo de función, y una event function no puede invocarse de ninguna otra manera. Puedes asociar múltiples reglas con un event listener, y cada regla puede activar múltiples event functions o cualquier circuit objetivo. Cuando se crea un event listener en Catalyst, se crea automáticamente un **Event Listener ID** único para él. Este ID y el nombre del event listener se pasan como parte de los detalles del bus de eventos a la función o circuit objetivo. Cada proyecto puede contener un máximo de cinco event listeners: cuatro personalizados y un event listener de componentes. * Reglas: Una regla define la acción específica que activará el event listener de componentes o personalizado. * Event listener de componentes: Una regla se asocia con las instancias de un componente particular y un conjunto de acciones que ocurren en ellas. * Event listener personalizado: Cada regla actúa como una instancia individual del event listener y se identifica mediante un identificador de regla único. * Event listener de Zoho: Una regla se asocia con un evento específico que ocurre en un servicio de Zoho asociado. <br><br> Aprenderás sobre esto en detalle en la siguiente sección.<br /><br /> Una regla vincula el evento entrante con la ejecución de la event function asociada o el circuit objetivo y enruta los datos para su procesamiento. Se crea automáticamente un Rule ID único cuando creas una regla para un event listener. * Eventos: * Event listener de componentes: Se considera evento a una acción específica que ocurre en un componente. Por ejemplo, una tabla en el Data Store que se actualiza o un usuario que se registra en tu aplicación. La lista completa de eventos de componentes se proporciona en la siguiente sección. * Event listener personalizado: Se dice que un evento ha ocurrido cuando la URL del event listener es invocada por el usuario final de tu aplicación. * Event listener de Zoho: Una acción específica que ocurre en un servicio externo de Zoho, como Zoho CRM. Por ejemplo, Leads Created, Sales Order Updated, Campaigns Approved o Email Sent en la cuenta de CRM asociada con la regla particular. * Eventos en cola: Cuando ha ocurrido un evento para el cual se ha configurado una regla de event listener, la regla asociada se activará. El evento será puesto en cola para su procesamiento. Cada event listener que crees tendrá su propia cola individual. Catalyst invocará las funciones objetivo o circuits asociados para su ejecución durante el procesamiento y les pasará los datos del evento. Después de que la función o el circuit complete su ejecución, o si falla en ejecutarse, el evento será eliminado de la cola.<br /><br /> Por ejemplo, si hubieras configurado una regla con un evento de inserción en una tabla del Data Store, el event listener de componentes estará escuchando una acción de inserción en esa tabla. Cuando ocurra esa acción, la regla asociada se activará y el evento será puesto en cola para su procesamiento. En el caso de un event listener personalizado, cuando se invoca la URL del event listener, el evento se pone en cola hasta que la regla haya activado las funciones asociadas y estas completen su ejecución. Puedes ver información detallada de los eventos cuando entran en una cola y están siendo procesados desde la sección Queued Events en la consola. * Eventos procesados: Después de que la función objetivo o un circuit asociado de una regla de event listener de componentes o personalizado se ejecuta con éxito, se considerará un evento procesado. La sección Processed Events en la consola contendrá información detallada sobre el tráfico de eventos y el historial de ejecución de cada regla que se ejecutó. * Eventos fallidos: Si la ejecución de las funciones objetivo o circuits asociados de una regla de event listener de componentes o personalizado falla, o si la regla no logra invocar las funciones objetivo o circuits por cualquier motivo, se considerará un evento fallido. <br /> -------------------------------------------------------------------------------- title: "Event Listener de componentes" description: "Catalyst proporciona event listeners de componentes, personalizados y de Zoho que escuchan ocurrencias de eventos específicos en los componentes de Catalyst, en una fuente personalizada o en un servicio de Zoho asociado, respectivamente, y te permiten ejecutar tu propia lógica cuando ocurre el evento." last_updated: "2026-07-02T09:34:15.857Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/component-event-listeners/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Catalyst Component Event Listener ### 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í.<br /> Cada proyecto de Catalyst contiene un event listener de componentes que se crea cuando se crea el proyecto. Como se mencionó en las secciones anteriores, los comportamientos y funcionalidades de los event listeners de componentes y personalizados varían. El event listener de componentes de Catalyst se utiliza para vincular un componente de Catalyst con una función o circuit objetivo, y pasar los datos del componente a la función o circuit cuando se invoca. La siguiente tabla describe la lista de componentes de Catalyst y las ocurrencias de eventos en ellos que se pueden asociar con el event listener de componentes: <table class="content-table"> <thead> <tr> <th class="w20p">Componente</th> <th class="w30p">Evento</th> <th class="w50p">Descripción</th> </tr> </thead> <tbody> <tr> <td>Data Store</td> <td>Insert <br> Update <br> Delete</td> <td>Se insertan datos en las tablas asociadas <br> Se actualizan datos en las tablas asociadas <br> Se eliminan datos de las tablas asociadas</td> </tr> <tr> <td>Cache</td> <td>Put</td> <td>Se escriben datos en los segmentos de Cache asociados</td> </tr> <tr> <td>Authentication</td> <td>Sign Up <br> Delete</td> <td>Un usuario se registra en la aplicación <br> Un usuario se elimina de la aplicación</td> </tr> <tr> <td>File Store</td> <td>Upload</td> <td>Se sube un archivo en las carpetas asociadas</td> </tr> <tr> <td>GitHub</td> <td>Success <br> Failure</td> <td>El despliegue de GitHub fue exitoso <br> El despliegue de GitHub falló</td> </tr> <tr> <td>Web Client</td> <td>Hosted</td> <td>Se aloja el web client en el proyecto</td> </tr> </tbody> </table> Nota: * Puedes asociar las acciones de un solo componente con una regla particular. * Puedes asociar múltiples eventos de un componente con una sola regla. * También puedes ejecutar múltiples funciones objetivo para una regla. * No podrás renombrar ni eliminar el event listener de componentes. Sin embargo, puedes eliminar las reglas que crees en él. Por ejemplo, supongamos que la regla de un event listener de componentes está asociada con el evento Upload de archivo en tres carpetas: _Folder1_, _Folder2_ y _Folder3_ en el File Store. Sus funciones objetivo son _Function1_ y _Function2_. Esto significa que cada vez que se sube un archivo a una de estas tres carpetas, tanto _Function1_ como _Function2_ se ejecutan. Los datos del evento, como el ID de la carpeta, el nombre del archivo y la hora del evento para las tres carpetas, se pasan tanto a _Function1_ como a _Function2_ en un patrón predefinido. Los datos siempre se pasan a la función o circuit objetivo desde el event listener en formato JSON, y estos datos se pueden procesar dentro de tu circuit o función para llevar a cabo la acción requerida. Se muestra un patrón de datos de ejemplo en la consola cuando creas una regla. Este muestra una estructura de ejemplo de los datos que se pasarán a la función cuando ocurra el evento. El patrón de datos varía según el componente y las acciones con las que la regla está asociada, porque diferentes eventos contendrán diferentes datos. Por ejemplo, si una regla está asociada con un evento de registro de Authentication, los datos del evento tendrían el siguiente patrón: { "project_details": { "id": 57*************, "project_name": "Eventbus" }, "event_bus_details": { "name": "Default", "id": 57************* }, "data": { "platform_type": null, "user_details": { "email_id": "emma@zylker.com", "role_details": { "role_name": "App User", "role_id": 57************* }, "zaaid": 1002347509, "created_time": "Sep 10, 2019 11:47 PM", "invited_time": "Sep 10, 2019 11:47 PM", "modified_time": "Sep 10, 2019 11:47 PM", "user_id": 57*************, "is_confirmed": true, "last_name": "", "first_name": "Amelia Burrows", "zuid": 1002342431, "status": "ACTIVE" }, "org_id": 1002347509, "zaid": 1002345135, "redirect_url": null }, "current_project": { "id": 57*************, "project_name": "Eventbus" }, "action": "SignUp", "source": "UserManagement", "event_time": 1568139437092 } <br /> La regla pasa los datos del usuario y del registro, junto con los detalles del proyecto y otros metadatos sobre el evento. Puedes programar tu función objetivo o configurar tu circuit para procesar los datos del evento como lo necesites. Ahora trabajemos con event listeners en la consola de Catalyst. ### Crear una regla en el event listener de componentes Puedes acceder al componente _Event Listeners_ desde la sección _Triggers_ en la sección *Cloud Scale* de la consola. El event listener de componentes de Catalyst ya estará presente de forma predeterminada. Nota: Puedes crear hasta 50 reglas en el event listener de componentes en el entorno de desarrollo. Puedes solicitar a Catalyst un aumento de este límite contactando a nuestro soporte en support@zohocatalyst.com. Atenderemos cada solicitud de forma individual. No hay límites superiores para la creación de reglas en el entorno de producción. Para crear una regla en el event listener de componentes: 1. Navega a Event Listeners en _Triggers_ en la sección *Cloud Scale* de la consola de Catalyst.<br /> <br /> La página de Event Listeners mostrará el mosaico de Catalyst Component Events con las estadísticas del día de eventos procesados, fallidos y en cola 2. Haz clic en View en el mosaico del event listener para abrirlo.<br /> <br /> 3. Haz clic en Create Rule.<br /> <br /> 4. Ingresa un nombre y una descripción para la regla.<br /> <br /> 5. Selecciona un componente de la lista desplegable para asociar la regla. Cuando seleccionas un componente, la ventana emergente mostrará una estructura de ejemplo de los datos que se pasarán a la función o circuit objetivo. Este patrón de datos varía para cada componente que selecciones, como se mencionó anteriormente.<br /><br />Según el componente que hayas seleccionado, es posible que debas proporcionar información adicional. Por ejemplo, si eliges "Data Store", puedes seleccionar una o más tablas para asociar la regla. 6. Selecciona las acciones que ocurren en el componente para asociar la regla. Estas acciones también varían según el componente, como se discutió anteriormente.<br /> <br /> Nota: Si seleccionas "Web Client" como componente, el campo Action no aparecerá. Seleccionar Web Client indica que la regla se activará cuando se aloje un web client en el proyecto. 7. Elige **Function** o **Circuit** como tu *Target Point*: - Si eliges activar **Functions**:<br /> Selecciona las funciones objetivo a invocar cuando ocurra el evento. Puedes seleccionar una o más funciones.<br /> <br /> - Si eliges activar Circuits:<br /> Selecciona los circuits objetivo de la lista desplegable. Puedes seleccionar uno o más circuits.<br /> <br /> Nota: * Si eliges Functions como tu objetivo, la lista desplegable solo mostrará event functions. * Si eliges Circuits 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 o circuit. 8. Haz clic en Create. La regla ya está creada. Puedes ver una lista de todas las reglas y sus detalles del event listener de componentes desde su sección. <br /> Cuando haces clic en el nombre de una regla de la lista, verás los detalles de la regla y su patrón de datos de ejemplo. <br /> Puedes consultar las páginas de Processed Events y Queued Events para obtener detalles sobre esas secciones. <br> ### Configurar alertas para Catalyst Component Listeners Como se mencionó anteriormente, puedes configurar alertas automáticas por correo electrónico que se te envíen si el event listener encuentra un fallo, una excepción de código o un tiempo de espera del proceso. Puedes configurar estas alertas directamente en la sección de Event Listeners sin tener que navegar al componente *Application Alerts*. 1. Haz clic en el botón **+ Configure** en la sección de detalles del event listener para configurar una alerta. <br /> 2. Haz clic en **Confirm** después de configurar la alerta para habilitarla. <br /> 3. También puedes eliminar la alerta haciendo clic en el icono de puntos suspensivos junto al estado de la alerta y haciendo clic en **Remove**. <br /> <br /> -------------------------------------------------------------------------------- title: "Event Listeners personalizados" 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-07-02T09:34:15.858Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/custom-event-listeners/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Event Listeners personalizados ### 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í.<br /> Un event listener personalizado se utiliza para pasar datos a una función o circuit objetivo cada vez que su URL es invocada por el usuario final. No puedes asociar una ocurrencia de evento en un componente con un event listener personalizado. Cualquier event listener que crees en Catalyst será un event listener personalizado, ya que el event listener de componentes está presente de forma predeterminada. Nota: Puedes crear hasta 4 event listeners personalizados y de Zoho en un proyecto. Catalyst te permite crear hasta 50 reglas en cada event listener personalizado. Puedes solicitar a Catalyst un aumento de este límite contactando a nuestro soporte en support@zohocatalyst.com. Atenderemos cada solicitud de forma individual. Entendamos el comportamiento de un event listener personalizado en una secuencia lógica: 1. Cuando creas un event listener personalizado, se generará una URL para él. La misma URL se utilizará para todas las reglas del evento. Puedes incluir esta URL en el código de tu aplicación o usarla como necesites. 2. Puedes asociar cada regla de un event listener personalizado con una función o circuit objetivo diferente. También puedes enviar diferentes datos en el cuerpo de la solicitud de la URL del event listener para cada regla. Es decir, la invocación de la URL de un event listener se puede configurar para activar diferentes funciones o circuits y enviar diferentes datos para cada regla en cada ocasión. 3. También puedes asociar múltiples reglas a la misma función o circuit objetivo, y enviar diferentes datos a la misma función o circuit cada vez. Esto te permite usar la misma función o circuit para diferentes necesidades. 4. Para identificar qué regla necesita activarse cuando se invoca la URL de un event listener personalizado, las reglas contienen una variable llamada rule identifier. Cuando se crea una regla en un event listener personalizado, deberás proporcionar un valor único como su identificador. Este rule identifier se asocia solo con esa regla, que a su vez asocia las funciones o circuits objetivo con la regla. 5. Dado que un event listener personalizado tiene la misma URL para todas sus reglas, puedes indicar qué regla debe invocarse pasando el valor del rule identifier en el cuerpo de la solicitud de la URL. El cuerpo de la solicitud está en formato JSON (_application/JSON_), y por lo tanto debe contener esta información como un par clave-valor con la clave rule\_identifier. También puedes pasar más información en el cuerpo de la solicitud según tus necesidades. 6. La URL solo puede invocarse usando el método HTTP POST, ya que otros métodos no admiten la inclusión de datos de formulario dentro del cuerpo del mensaje de la solicitud. 7. Cuando se invoca la URL del event listener, Catalyst hace coincidir el rule identifier especificado en el cuerpo de la solicitud con una regla de ese event listener configurado en la consola. Cuando la coincidencia es exitosa, Catalyst activa esa regla y pasa los datos del evento a las funciones o circuits asociados con esa regla. Los datos del evento pueden entonces procesarse en el circuit o la event function objetivo para llevar a cabo la tarea requerida. Si no hay una coincidencia exitosa, será un evento fallido. Entendamos mejor el funcionamiento de un event listener personalizado con un ejemplo: Supongamos que creas un event listener personalizado en tu proyecto de Catalyst. La URL del event listener se generará automáticamente. Ahora creas una regla (_rule\_1_) en él y proporcionas el valor del rule identifier como _ID1_. Esta regla ejecuta la función objetivo _Func_ cuando se activa. Ahora creas una segunda regla (_rule\_2_) cuyo rule identifier es _ID2_ y ejecuta la misma función _Func_ cuando se activa. Es decir, tanto _rule\_1_ como _rule\_2_ tienen la misma URL de invocación y ejecutan la misma función. Ahora, usas esta URL en la lógica de la aplicación en dos lugares diferentes. Uso 1: El usuario envía datos a través de un formulario (_Form 1_) en la página de inicio del cliente y se invoca la URL. Especificas el rule identifier como ID1 en los datos del formulario del cuerpo de la URL. Uso 2: El usuario envía datos en un formulario diferente (_Form 2_) y se invoca la misma URL. Especificas el rule identifier como _ID2_ en los datos del formulario del cuerpo de la URL. El event listener de Catalyst estará escuchando la invocación de esta URL. Cuando un usuario envía datos a través de _Form 1_, se invoca la URL. El cuerpo de la solicitud HTTP contendría los datos del formulario que incluyen el rule identifier como se muestra a continuación: { "data": "Sample data from Form 1", "rule_identifier": "ID1" } <br /> Cuando Catalyst captura este evento, hará coincidir el rule identifier _ID1_ con _rule\_1_ configurada en el proyecto. Cuando la coincidencia es exitosa, activa la función _Func_. Luego pasará los datos del evento a la función en el siguiente patrón de datos de ejemplo: { "project_details": { "id": 57*************, "project_name": "Eventbus" }, "event_bus_details": { "name": "ThirdPartyBus", "id": 13************* }, "data": "Sample data 1", "current_project": { "id": 57*************, "project_name": "Eventbus" }, "action": "Produce", "source_entity_id": 570000000003015, "rule_identifier": "com.abc", "source": "Custom", "event_time": 1568192053790 } <br /> Si un usuario envía datos a través de _Form 2_, se invocará la misma URL con el valor de rule\_identifier en el cuerpo de la solicitud como _ID2_. Cuando Catalyst captura este evento y asocia _ID2_ con _rule\_2_, los datos relevantes se pasan a _Func_. El patrón de datos es el mismo para las reglas de todos los event listeners personalizados. Ahora creemos un event listener personalizado y configurémoslo. <br /> ### Crear un event listener personalizado Para crear un event listener personalizado: 1. Haz clic en Create Event Listener desde la sección _Event Listeners_ en _Amplify_, en la consola de Catalyst.<br /> <br /> 2. Ingresa un nombre y una descripción para el event listener personalizado. Selecciona Custom Events como el tipo.<br /> <br /> 3. Haz clic en Create. El event listener personalizado se creará y se mostrará en la página de Event Listeners con su ID y las mismas estadísticas de rendimiento que el event listener de componentes. <br /> Puedes ver los detalles de un event listener haciendo clic en **View** en su mosaico. También puedes acceder a la URL del event listener desde esta página. <br /> La URL de un event listener personalizado tiene el siguiente formato: https://api.catalyst.zoho.com/baas/v1/project/project_id/event-bus/event_listener_id_/produce?ZCFKEY=_zcf_key con los valores de Project ID, Event Listener ID y una ZCF Key única completados. <br /> #### Crear una regla en el event listener personalizado Para crear un event listener personalizado: 1. Haz clic en el event listener personalizado desde la página _Event Listeners_ para abrirlo. 2. Haz clic en Create Rule.<br /> <br /> 3. Ingresa un nombre, una descripción y un rule identifier para la regla.<br /> <br /> La página muestra la estructura de ejemplo de los datos que se pasarán a la función o circuit objetivo. 4. Elige Function o Circuit como tu *Target Point*: * Si eliges activar Functions:<br /> Selecciona la acción y la event function objetivo de la lista desplegable. Actualmente solo puedes seleccionar Produce para habilitar el paso de datos a la función objetivo. Puedes seleccionar múltiples funciones objetivo.<br /> <br /> * Si eliges activar un Circuit:<br /> Selecciona el circuit objetivo de la lista desplegable. Actualmente solo puedes seleccionar Produce para habilitar el paso de datos al circuit objetivo. Puedes seleccionar múltiples circuits objetivo.<br /> <br /> Nota: * Si eliges una event function como tu objetivo, la lista desplegable solo mostrará 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 o circuit. 5. Haz clic en Create. La regla se creará en el event listener personalizado. Aparecerá en la página del event listener con sus detalles. La fuente de un event listener personalizado siempre es "**custom**". <br /> Haz clic en el nombre de una regla en la lista para ver los detalles de la regla y su patrón de datos. <br /> Nota: Puedes configurar Application Alerts para tus Custom Events, de la misma manera que configuraste alertas en la sección Catalyst Component Events. Antes de hablar sobre la gestión de las reglas de tus event listeners o los eventos procesados, repasemos rápidamente cómo editar y eliminar un event listener personalizado. #### Editar un event listener personalizado Puedes renombrar un event listener personalizado o editar su descripción de la siguiente manera: 1. Abre el event listener personalizado desde la página *Event Listeners*. 2. Haz clic en el menú de puntos suspensivos en la parte superior de la página, luego haz clic en **Edit**. <br /> 3. Actualiza los detalles del event listener, luego haz clic en **Save**. <br /> #### Eliminar un event listener personalizado Para eliminar un event listener personalizado: 1. Abre el event listener personalizado desde la página *Event Listeners*. 2. Haz clic en el menú de puntos suspensivos en la parte superior de la página, luego haz clic en **Delete**. <br /> 3. Haz clic en **Yes, Proceed** en la ventana emergente de confirmación. <br /> <br /> -------------------------------------------------------------------------------- title: "Event Listeners de Zoho" 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-07-02T09:34:15.860Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/zoho-event-listeners/" service: "Cloud Scale" -------------------------------------------------------------------------------- # 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í.<br /> 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 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: <table class="content-table"> <thead> <tr> <th class="w20p"><strong>Servicio de Zoho</strong></th> <th class="w80p"><strong>Eventos</strong></th> </tr> </thead> <tbody> <tr> <td>Zoho CRM</td> <td>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</td> </tr> </tbody> </table> 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. <br> **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. 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](#create-a-rule-in-a-zoho-event-listener). <br /> 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: { "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. <br /> ### 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.<br /> <br /> 2. Ingresa un nombre y una descripción para el event listener. Selecciona Zoho Events como el tipo.<br /> <br /> 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 que el event listener de componentes. <br /> Puedes ver los detalles de un event listener y crear reglas en él haciendo clic en **View** en su mosaico. <br> ### 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.<br /> <br /> 2. Selecciona un servicio de Zoho compatible para crear el event listener, desde la ventana emergente. Haz clic en Next.<br /> <br /> 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 se listarán aquí. Puedes seleccionar una cuenta que ya esté listada para el servicio. <br /> <br /> 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.<br /> <br /> 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.<br /> <br /> 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. <br /> <br /> 5. Selecciona un evento en el servicio asociado para configurar la regla. Solo puedes seleccionar un evento por regla. Consulta la [sección anterior](#introduction) para ver una lista de eventos disponibles en cada servicio.<br /> <br /> 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. <br /> <br /> 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. * 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 o 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.<br /> <br /> Puedes hacer clic en el nombre de una regla para ver sus detalles y patrón de datos.<br /> <br /> Nota: Puedes configurar Application Alerts para tus reglas de evento de Zoho, de la misma manera que configuraste alertas en la sección Catalyst Component Events. <br /> <br /> ### Configurar cuentas para el entorno de producción Catalyst requiere que configures cuentas para el entorno de producción 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, 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 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.<br><br /> 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_ para ese servicio.<br><br /> 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](#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.<br><br /> 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. <br /> ### 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.<br /> <br /> 2. Realiza los cambios necesarios, luego haz clic en Update. <br /> <br /> <br /> ### 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.<br /> <br /> 2. Haz clic en Yes, Proceed en la ventana emergente de confirmación. <br /> <br /> La regla se deshabilitará. Puedes habilitarla nuevamente haciendo clic en el icono de puntos suspensivos y haciendo clic en **Enable**. <br /> ### 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. <br /> <br /> 2. Haz clic en Yes, Proceed en la ventana emergente de confirmación. <br /> <br /> <br /> ### 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. <br /> <br /> 2. Actualiza los detalles del event listener, luego haz clic en Save. <br /> <br /> <br /> ### 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.<br /> <br /> 2. Haz clic en Yes, Proceed en la ventana emergente de confirmación. <br /> <br /> -------------------------------------------------------------------------------- title: "Eventos en cola" description: "Catalyst proporciona event listeners de componentes, personalizados y de Zoho 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-07-02T09:34:15.863Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/queued-events/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Eventos en cola 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í.<br /> Como se describió en la sección de Terminología, cuando ha ocurrido un evento para el cual se ha configurado una regla de event listener, el evento se pondrá en cola para su procesamiento. El evento se agregará a una cola particular de ese event listener. Este puede ser un evento en un componente que un event listener ha sido configurado para escuchar, o la invocación de la URL de un event listener personalizado. El proceso se puede describir de la siguiente manera: 1. El event listener escucha un evento de componente o personalizado 2. Ocurre el evento 3. El evento se agrega a la cola de eventos 4. Se activa la regla del event listener 5. La regla invoca las event functions o circuits asociados y pasa los datos del evento para su ejecución 6. La event function o el circuit objetivo se ejecuta 7. La ejecución de la función o circuit es exitosa o fallida 8. El evento se elimina de la cola y se categoriza como evento procesado o fallido ### Eventos en cola en event listeners de componentes Puedes ver los eventos que están actualmente en la cola en cualquier momento, desde la sección **Queued Events** en la página de *Event Listeners*. El mosaico del event listener también mostrará el número de eventos que están actualmente en la cola, en sus estadísticas. <br /> La sección de eventos en cola muestra varios detalles de los eventos, como su hora de inicio, fuente, acción y los datos en formato JSON que se pasarán a las event functions o circuits asociados por las reglas respectivamente. Puedes ver los datos formateados haciendo clic en el botón **Format JSON**. <br /> Puedes filtrar los eventos en cola que se muestran en esta página según componentes específicos usando la primera lista desplegable. También puedes usar la barra de búsqueda para buscar eventos según la hora del evento, el nombre de la regla, la acción o incluso el nombre del componente. Para resultados de búsqueda más precisos, puedes buscar usando palabras clave de los datos del evento. <br /> Puedes reducir aún más la lista de eventos en cola filtrando según las acciones específicas pertenecientes a cada componente. <br /> También puedes filtrar los eventos según su hora de inicio, como los últimos 15 minutos o 30 minutos, desde la lista desplegable basada en tiempo. <br /> ### Eventos en cola en event listeners personalizados De manera similar a los eventos en cola en el event listener de componentes, puedes ver los eventos en cola para procesamiento en un event listener personalizado haciendo clic en **Queued Events** desde la página de un event listener personalizado. La página mostrará detalles como la fecha en que se creó el event listener personalizado, la descripción y quién lo creó. Además, podrás ver y copiar la URL Produce del evento personalizado. <br /> La sección de eventos en cola también muestra otros detalles de los eventos, como su fuente, acción y los datos del evento en formato JSON que se pasarán a las event functions o circuits asociados por las reglas respectivamente. Puedes ver los datos formateados haciendo clic en el botón **Format JSON**. <br /> Al igual que en los *Component Event Listeners*, puedes filtrar y buscar en la cola de eventos. Puedes hacer clic en **Refresh** para ver una lista actualizada, si hay algún retraso en la visualización de los eventos. Después de que estos eventos se procesen, serán eliminados de la cola. ### Pausar eventos en la cola Catalyst te permite pausar cualquier evento en la cola por un período máximo de **cinco minutos** de una sola vez. Pausar una cola te permite detener su procesamiento temporalmente y realizar correcciones de código en caso de que ocurran errores. Luego puedes reanudar manualmente una cola pausada o esperar a que la cola se reanude automáticamente cuando se agote el temporizador de cinco minutos. <br /> 1. Puedes pausar la cola haciendo clic en el botón **Pause Queue** en la esquina derecha. <br /> 2. Haz clic en **Yes, Proceed** <br /> Puedes buscar y filtrar resultados en la cola incluso mientras está pausada. El tiempo restante para que la cola se reanude automáticamente se mostrará en la parte superior de la página de *Queued Events*. <br /> ### Eliminar eventos de la cola Mientras la cola está pausada, puedes eliminar eventos de la cola. Esto los eliminará permanentemente de la cola y terminará su procesamiento. Si ya se ha activado una event function o circuit asociado, también se terminará inmediatamente. Para eliminar uno o más eventos de la cola: 1. Selecciona un evento o múltiples eventos cuando la cola esté pausada usando la casilla de verificación, luego haz clic en **Remove Event**. <br /> También puedes seleccionar todos los eventos y eliminarlos en masa. Haz clic en **Remove All**. <br /> 2. Haz clic en **Yes, Proceed** para confirmar. <br /> ### Reanudar la cola Para reanudar manualmente una cola pausada: 1. Haz clic en **Resume Queue**. <br /> 2. Haz clic en **Yes, Proceed** para confirmar. <br /> Nota: Después de que una cola ha sido reanudada, solo se puede pausar nuevamente después de 15 minutos. ### Terminar eventos en la cola Un evento particular en una cola que se está procesando actualmente se mostrará en la sección **In Progress** de la página de índice del event listener. Esta sección mostrará los detalles del evento, como el nombre de la regla, el Execution ID, la fecha y hora del procesamiento, y los datos del evento en formato JSON. Cuando terminas un evento desde la sección **In Progress**, se terminará abruptamente y se eliminará de la cola. Las ejecuciones de sus funciones o circuits asociados también se terminarán inmediatamente. <br /> Para terminar un evento en progreso: 1. Haz clic en el icono de terminar desde la esquina derecha de la sección **In Progress**. <br /> 2. Haz clic en **Yes, Proceed** para confirmar. <br /> ### Deshabilitar la cola de un event listener Cuando se crea un Event Listener, Catalyst crea y habilita automáticamente una cola para el procesamiento de los eventos asociados con ese event listener. Puedes deshabilitar esta cola cuando no quieras que se procese ningún evento en esa cola. Siempre puedes habilitar la cola nuevamente cuando lo necesites. 1. Haz clic en el icono de puntos suspensivos en la esquina superior derecha de la página del event listener de componentes o personalizado, y haz clic en **Disable Queue**. <br /> 2. Haz clic en **Yes, Proceed** para confirmar. <br /> El estado deshabilitado de la cola se mostrará junto al nombre del event listener. El botón **Queued Events** también se deshabilitará. <br /> El estado deshabilitado de la cola también se mostrará en la página de Event Listeners. <br /> Puedes habilitar una cola deshabilitada haciendo clic en el mismo icono de puntos suspensivos y haciendo clic en **Enable**. <br /> La cola habilitada ahora capturará y procesará eventos. <br /> La cola habilitada ahora capturará y procesará eventos. <br /> -------------------------------------------------------------------------------- title: "Eventos procesados" description: "Catalyst proporciona event listeners de componentes, personalizados y de Zoho 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-07-02T09:34:15.863Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/processed-events/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Eventos procesados 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í.<br /> Después de que la regla de un event listener se ha ejecutado y el evento se ha procesado con éxito, es decir, las funciones objetivo o circuits asociados se han ejecutado con éxito, puedes ver el historial de ejecución detallado desde la sección Processed Events de la regla. Las estadísticas del event listener también mostrarán el conteo de eventos procesados. Nota: Tanto las reglas de event listeners de componentes como las de event listeners personalizados contienen secciones de Processed Events similares. Puedes acceder a los eventos procesados de cualquier regla de event listener de componentes o personalizado de la siguiente manera: 1. Abre el event listener desde la página *Event Listeners*. 2. Abre la regla específica de la lista de reglas del event listener. 3. Haz clic en la pestaña **Processed Events** junto a la pestaña *General Details*. <br /> Esta sección contiene un gráfico de tráfico de eventos del día que muestra el número de solicitudes procesadas con éxito en las últimas 24 horas. También puedes seleccionar un período de tiempo específico desde el filtro desplegable para ver el gráfico de solo ese período. <br /> El historial de ejecución muestra varios detalles de cada ejecución, incluyendo un **Execution ID** único que hace referencia a esa ejecución, la hora de inicio, el tiempo de ejecución y el estado de la ejecución. También puedes usar el filtro de estado para ver ejecuciones de un estado particular, como las ejecuciones exitosas o las que agotaron el tiempo de espera. <br /> El estado *Code Exception* muestra eventos cuyas funciones objetivo o circuits asociados enfrentaron una excepción en su código, y el estado *Unintentional Termination* indica todos los casos en los que la ejecución del target point fue terminada debido a algunos errores. También puedes usar el filtro de tiempo para ver los eventos ejecutados en un período de tiempo particular, como la última hora o las últimas 12 horas. Catalyst conserva el historial de ejecución de las reglas de event listeners durante **3 meses** en el entorno de producción y **1 mes** en el entorno de desarrollo. Consulta la página de ayuda de Environments para obtener más información. Esta sección también contiene un enlace para ver los logs y el APM de las ejecuciones del target point asociadas con cada regla. Haz clic en el icono **View Logs** de cualquier regla. <br /> Serás redirigido al componente Catalyst Logs que muestra información detallada de las ejecuciones de event functions o circuits que fueron procesadas por esa regla. <br /> Si haces clic en View APM, serás redirigido al componente Application Performance Monitoring, que contiene estadísticas detalladas sobre las llamadas al target point, ocurrencias de errores, uso de componentes y más. Nota: Debes haber habilitado APM para tu proyecto para ver el enlace de APM en el historial de ejecución. <br /> -------------------------------------------------------------------------------- title: "Trabajar con reglas" 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-07-02T09:34:15.863Z" source: "https://docs.catalyst.zoho.com/es/cloud-scale/help/event-listeners/working-with-rules/" service: "Cloud Scale" -------------------------------------------------------------------------------- # Trabajar con reglas ### Editar una regla 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í.<br /> Puedes editar una regla en el event listener de componentes, personalizado o de Zoho, y modificar sus detalles, fuente o target points y sus funciones o circuits asociados de la siguiente manera: 1. Abre el event listener de componentes, personalizado o de Zoho desde la página _Event Listeners_. 2. Haz clic en el icono de puntos suspensivos de la regla, luego haz clic en Edit.<br /> <br /> 3. Realiza los cambios necesarios, luego haz clic en Update.<br /> <br /> <br /> ### Deshabilitar una regla Puedes deshabilitar una regla en el event listener de componentes, personalizado o 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 el event listener de componentes o personalizado: 1. Abre el event listener de componentes, personalizado o de Zoho desde la página _Event Listeners_. 2. Haz clic en el icono de puntos suspensivos de la regla, luego haz clic en Disable.<br /> <br /> 3. Haz clic en Yes, Proceed en la ventana emergente de confirmación.<br /> <br /> La regla se deshabilitará. Puedes habilitarla nuevamente haciendo clic en el icono de puntos suspensivos y haciendo clic en Enable. <br /> ### Eliminar una regla Para eliminar una regla en el event listener de componentes, personalizado o de Zoho: 1. Abre el event listener de componentes, personalizado o de Zoho desde la página _Event Listeners_. 2. Haz clic en el icono de puntos suspensivos de la regla, luego haz clic en Delete.<br /> <br /> 3. Haz clic en Yes, Proceed en la ventana emergente de confirmación.<br /> <br />