Event Listeners de Zoho

Introducción

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

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:

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.

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.

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.

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.
   
   

2. Ingresa un nombre y una descripción para el event listener. Selecciona Zoho Events como el tipo.
   
   

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.

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.
   
   

2. Selecciona un servicio de Zoho compatible para crear el event listener, desde la ventana emergente. Haz clic en Next.
   
   

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.
   
   

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.

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.

4. Ahora puedes configurar los detalles de la regla. Ingresa un nombre y una descripción para la regla.
   
   

5. Selecciona un evento en el servicio asociado para configurar la regla. Solo puedes seleccionar un evento por regla. Consulta la sección anterior para ver una lista de eventos disponibles en cada servicio.
   
   

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.

Selecciona una o más funciones objetivo o circuits para ejecutar cuando se ejecute la regla.

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.

Puedes hacer clic en el nombre de una regla para ver sus detalles y patrón de datos.

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.
   
   

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.
   
   

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.

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.
   
   

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.

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.

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.
   
   

2. Realiza los cambios necesarios, luego haz clic en Update.
   
   

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.
   
   

2. Haz clic en Yes, Proceed en la ventana emergente de confirmación.
   
   

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.
   
   

2. Haz clic en Yes, Proceed en la ventana emergente de confirmación.
   
   

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.
   
   

2. Actualiza los detalles del event listener, luego haz clic en Save.
   
   

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.
   
   

2. Haz clic en Yes, Proceed en la ventana emergente de confirmación.