Lead Manager App Using AppSail

Introduction

This tutorial will help you build a Java Spring Boot application web application called Lead Manager. This web app will allow you to connect with your Zoho CRM account and enable you to manage leads in your organization. You will be able to access, add, edit, or delete leads in the Leads module in your CRM account directly from this application.

The connection to Zoho CRM is established using OAuth 2.0 authentication protocol. We will generate an OAuth Access Token for the Lead Manager application and use it to authorize the connection to access CRM data. The authentication requirement in this tutorial is handled using Embedded Authentication.

We will also implement a Catalyst Connector to manage this access to the CRM account. The connector will refresh the Access Token automatically each time it expires using a Refresh Token, and will maintain a constant connection between the client and the CRM account.

These tokens can be generated after registering the client application in the Zoho API console and obtaining the required credentials.

The client application will look like this:

The Lead Manager application employs components from the following Catalyst services:

• Catalyst Serverless:
  • AppSail: To host the independent Java Spring Boot application. We will be building the front-end of the app as well as the back-end logic, and bundling them together to deploy them on AppSail.
• Catalyst CloudScale:
  • Data Store: To store the Refresh Token and UserID of the Catalyst user fetched by the function resource. The Refresh Token is fetched from this table by the function, whenever a new Access Token needs to be generated.
  • ZCQL: To fetch data from the Data Store through querying.
  • Catalyst Authentication: To implement a Zoho social login in the client application’s login page, in addition to the standard login option, we will be implementing the Embedded Authentication type in this tutorial.

We will use the Catalyst web console and the Catalyst Command Line Interface (CLI) to build this application.

Application Architecture

The Lead Manager application’s architecture is depicted below:

The entire workflow of the application will be explained in more detail when you code your front end logic, which we recommend you check out as you follow along the steps.