Lead Manager App

Introducción

Este tutorial te ayudará a construir una aplicación web que pueda conectarse con tu cuenta de Zoho CRM y te permita gestionar leads en tu organización. Podrás acceder, agregar, editar o eliminar leads en el módulo Leads de tu cuenta de CRM, directamente desde esta aplicación.

La conexión con Zoho CRM se establece mediante el protocolo de autenticación OAuth 2.0. Generaremos un Access Token de OAuth para la aplicación Lead Manager y lo usaremos para autorizar la conexión y acceder a los datos de CRM.

También implementaremos un conector de Catalyst para gestionar este acceso a la cuenta de CRM. El conector actualizará el Access Token automáticamente cada vez que expire usando un Refresh Token, y mantendrá una conexión constante entre el cliente y la cuenta de CRM.

Estos tokens se pueden generar después de registrar la aplicación cliente en la consola de la API de Zoho y obtener las credenciales necesarias.

La aplicación cliente se verá así:

La aplicación Lead Manager contiene los siguientes componentes fundamentales de Catalyst:

1. Catalyst Serverless:
   • Advanced I/O Function: La Advanced I/O Function está codificada en el entorno de programación Java. La función define las APIs que manejan las acciones CRUD del módulo Leads de CRM, como agregar o eliminar un lead, desde la aplicación cliente. También define rutas que manejan la conexión con CRM, autentican al usuario y generan los tokens de OAuth.
2. Catalyst Cloud Scale:
   • Data Store: Para almacenar el Refresh Token y el UserID del usuario de Catalyst obtenidos por la Advanced I/O function. El Refresh Token se obtiene de esta tabla por la función, cada vez que se necesita generar un nuevo Access Token.
   • ZCQL: Para obtener datos del Data Store mediante consultas.
   • Client: Este es el front end de la aplicación que se aloja en Catalyst a través de web client hosting.
   • Authentication: Para implementar una opción de inicio de sesión con Zoho en la página de login de la aplicación cliente, además de la opción de inicio de sesión estándar, implementaremos el tipo de Embedded authentication en este tutorial.

Usaremos la consola web de Catalyst y la Interfaz de Línea de Comandos (CLI) de Catalyst para construir esta aplicación.

Se te proporcionará el código de los archivos que se deben incluir en los componentes de función y cliente en este tutorial. Solo necesitarás copiar el código proporcionado y pegarlo en los archivos apropiados según las indicaciones.

Arquitectura de la aplicación

La arquitectura de la aplicación Lead Manager se muestra a continuación:

Explicaremos la arquitectura en detalle en la sección Configurar el Client, después de que configures los componentes de función y cliente.