Kaizen #127 - Circuits in Zoho CRM - Part 2

Hello everyone!

We're back with part 2 of Circuits in Zoho CRM!

We are as excited as you are with this topic! Let's dive right in!

As promised, in today's post, we will discuss a use case, see how execution happens, and associate that circuit with a workflow.

In our next post(Yes! There's going to be another one!), we will associate the circuit with a button and a blueprint, view logs, and debug issues.

Sample use case - Loan Verification Process

Consider that we have a module in CRM called Customers, where we have personal information of customers, tax-related details, tax and personal ID verification details and status. Our aim is to check the requested loan amount, check eligibility, and then grant or reject it.

Here is a screenshot of a record in the Customers module.

Our condition is that whenever the loan amount is less than Rs. 500,000, the circuit should directly proceed to document verification. When the requested loan amount is greater than Rs. 500,000, we must check a few eligibility criteria before proceeding to document verification.

We can automate this entire process using Circuits, and execute it through a button, associate it with a workflow or a blueprint.

Let's take a look at the Circuit's flow.

Here are the different states of the Circuit that explain the logic.

1. Get the loan record.
2. Check the loan amount.
   
3. If the loan amount is less than Rs. 500,000, proceed to document verification.
   
4. If the loan amount is greater than Rs. 500,000, check the tax filing status.
   
5. If tax is not filed, update the record's Loan Eligibility field with the value "Tax not filed. Hence, not eligible for loan".
   
6. If tax is filed, fetch the applicant's credit score and check the eligibility.
   
7. If the credit score falls short, update the record's Loan Eligibility field with the value "Issue with credit score".
   
8. If the credit score is up to the mark, proceed to document verification—Personal ID and Tax ID verification.
   
9. Update the details of the record to sanction the requested loan.
   

Let's discuss each of these states in detail.

1. Get the loan record

Builder View

Type: Get Record from Zoho CRM's states.

Action: Gets the details of the loan record from the Customers module. The output is in the following format.

{     "ZohoCRM": {         "record_id": "5575270000005762031",         "user_id": "5575270000005379053",         "module": {             "api_name": "Customers",             "tab_label": "Customers",             "id": "5575270000001975002"         }     },     "record": {         "data": [             {                 "Owner": {                     "name": "Patricia Boyle",                     "id": "5575270000001947001",                     "email": "p.boyle@zylker.com"                 },                 "$currency_symbol": "$",                 "Tax_ID_Verification_Message": "Tax ID Verified Successfully",                 "$review_process": {                     "approve": false,                     "reject": false,                     "resubmit": false                 },                 "$sharing_permission": "full_access",                 "Personal_ID_Number": "464694660655",                 "Personal_ID_Verification_Message": "Personal ID Verified Successfully",                 "Name": "Stephen Adams",                 "Manual_Approval": "Depends on score",                 "$state": "save",                 "$process_flow": false,                 "Tax_Score_Status": "Score is eligible for Loan",                 "$locked_for_me": false,                 "Tax_ID_Number": "GBHPS3618H",                 "id": "5575270000005762031",                 "Tax_ID_Verified_Date": "2024-02-26",                 "Loan_Eligibility": "Eligible for Loan",                 "$approval": {                     "delegate": false,                     "approve": false,                     "reject": false,                     "resubmit": false                 },                 "Modified_Time": "2024-02-29T12:26:11+05:30",                 "Tax_ID_Verification_Status": "Verified",                 "Tax_Return_Availability": "Yes",                 "Tax_ID_Verified_Time": "2024-02-26 23:28:39.0",                 "Personal_ID_Verified_Time": "2024-02-26 23:28:39.0",                 "Created_Time": "2024-02-29T12:26:11+05:30",                 "Amount": 600000,                 "$editable": true,                 "Personal_ID_Reference": "6cefa3d4-b87b-46a6-8814-b21fb422a28d",                 "$orchestration": false,                 "Tax_ID_Reference": "f6697aa8-8efc-4ee9-8dcc-0bc838755cb4",                 "Tax_Score": 450,                 "Personal_ID_Verification_Status": "Verified",                 "Personal_ID_Verified_Date": "2024-02-26",                 "$in_merge": false,                 "Locked__s": false,                 "Tag": [],                 "$zia_owner_assignment": "owner_recommendation_unavailable",                 "$approval_state": "approved",                 "$pathfinder": false             }         ]     } }

You can use any part of this output as input to other states. You can achieve this by using the JSON Path expression in the “result path” to traverse the result JSON of the state.

Result path allows you to combine state result with state input to pass as output. You can add the result path in the "Input/Output" section in the Builder view as well as the JSON in Code view.

In our case, we want to use the data inside the “record” JSON object. So, the result path will be $.record.

Result path is mandatory when you use the Get Record Zoho CRM state.

Next state: Check Loan Amount

Code View

2. Check Loan Amount

Builder View

Type: Branch

Action: Checks for the condition specified in the branch—check if the loan amount < 500,000. If yes, and Go to Documents verification state, else go to Check tax filing status state.

Next state: Check Tax filing status(if loan amount > 500,000)

Code View

3. Check Tax Filing Status

Builder View

Type: Branch

Action: Checks for the condition specified in the branch—if the tax filing status is Yes, fetch the credit score. Else, update the record with "Tax not filed; not eligible for loan".

Next state: Fetch Applicant Credit Score

4. Fetch Applicant Credit Score

Builder View

Type: Function

Action: Executes the CRM function "Tax Score Check" that holds the logic to get the basic eligibility stored in the Org variable "eligibility", compare it with the tax score of the applicant, and update the record, accordingly. Here is the snippet of this function.

Next state: Check eligibility of Credit Score

Code View

5. Check eligibility of Credit Score

Builder View

Type: Branch

Action: Checks for multiple conditions—if Tax Score Status = Eligible, go to Document Verification.

If Tax Score Status = Not eligible & the value of the field "Manual Approval" = "Not approved", update the record with "Issue in Tax Score".

If Tax Score Status = Not Eligible & "Manual Approval" = "Approved", proceed to document verification.

Next state: Depends on the condition that is met in the "Check Tax Score Eligibility" state.

Code View

6. Documents Verification Process

Builder View

Type: Parallel

Action: Verifies the Tax ID and Personal ID of the applicant.

Next state: Verification Details - Update Record

Code View

7. Tax ID Verification

Builder View

Type: Function

Action: Executes the function "Tax ID Verification" that has the logic to verify the tax details of the applicant.

Here is the snippet of this function.

Next state: Verification Details - Update Record

Code View

8. Personal ID Verification

Builder View

Type: Function

Action: Executes the function "Personal ID Verification" that has the logic to check for the applicant's personal details.

Here is how the function looks.

Next state: Verification Details - Update Record

Code View

9. Verification Details - Update Record

Builder View

Type: Function

Action: Executes the function "Update Customer Record status" that uses the Deluge Update Record integration task to update the "Loan eligibility" field.

Here is how the function looks.

Next state: End

Code View

10. Update Record - Tax Not Filed, Not Eligible

Builder View

Input/Output

Type: Function

Action: When the requested loan is greater than Rs.500,000 and the Tax Filing Status in "Not Filed", this state executes the function "Update Customer Record status". This function uses the Deluge Update Record integration task to update the "Loan eligibility" field, and takes the parameters "rec_id" and "loan_eligibility" with the values "$.ZohoCRM.record_id" and "Tax Filing is missing, Hence not eligible for the loan.", respectively.

Next state: End

Code View

11. Update Record - Issue with Credit Score

Builder View

Type: Pass

Action: When the tax score eligibility does not meet the requirement, this state ends the circuit's execution.

Next state: End

Code View

Testing and Execution

Let us see the execution of this circuit with a sample record ID.

When you click each state, you can see the input and output of that state.

When you click "View Logs", you can see how execution has happened, the payload for each state, the response, etc.

Associating this Circuit with a Workflow

Follow the steps mentioned in this article to create a workflow.

The condition for this workflow to execute the circuit is when the requested loan is greater than Rs. 500,000.

The Action is to execute the circuit. Choose the option "Execute Circuit" from the Instant Actions and select the Verification Process Circuit.

Save the workflow.

Let's test this workflow by creating a record in the Customers module with the loan amount less than Rs. 500,000.

As you can see, the workflow is triggered and executes the circuit when the loan amount is less than Rs. 500,000.

You can view the circuit's execution and other details as a related list.

Summary

Circuits allow you to automate entire business processes by allowing you to orchestrate functions along with your business logic as you see fit.

As you witnessed in this example, we used multiple independent functions written in CRM to achieve our business case through utilizing them in a circuit. This gives you the benefit of writing functions that can be reused in multiple places while saving you from the grief of dealing with huge volumes of code that are hard to maintain and harder to debug when written as a single function.

We hope you liked this post. We'll see you next week with another post on Circuits.

Let us know if you have any questions or feedback. We are listening!

Cheers!

Shylaja S

Additional Reading:

Kaizen #126 - Circuits in Zoho CRM - Part 1

Kaizen series

Circuits Help Documentation

• Topic Participants

• Shylaja S

  

• Sticky Posts

• Kaizen #197: Frequently Asked Questions on GraphQL APIs

  🎊 Nearing 200th Kaizen Post – We want to hear from you! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.

• Kaizen #198: Using Client Script for Custom Validation in Blueprint

  Nearing 200th Kaizen Post – 1 More to the Big Two-Oh-Oh! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.

• Celebrating 200 posts of Kaizen! Share your ideas for the milestone post

  Hello Developers, We launched the Kaizen series in 2019 to share helpful content to support your Zoho CRM development journey. Staying true to its spirit—Kaizen Series: Continuous Improvement for Developer Experience—we've shared everything from FAQs

• Kaizen #193: Creating different fields in Zoho CRM through API

  🎊 Nearing 200th Kaizen Post – We want to hear from you! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.

• Client Script | Update - Introducing Commands in Client Script!

  Have you ever wished you could trigger Client Script from contexts other than just the supported pages and events? Have you ever wanted to leverage the advantage of Client Script at your finger tip? Discover the power of Client Script - Commands! Commands

• Recent Topics

• Create static subforms in Zoho CRM: streamline data entry with pre-defined values

  Last modified on (9 July, 2025): This feature was available in early access and is currently being rolled out to customers in phases. Currently available for users in the the AU, CA, and SA DCs. It will be enabled for the remaining DCs in the next couple

• SalesIQとPageSenseの利用について

  初めての投稿で場違いだったらすいません。 弊社ではSalesIQを運用しているのですが、追加でPageSenseの導入もしたいと現場からの声があります。 両サービスともクッキー同意バナーが必要なサービスなのですが 弊社では同意無しに情報はとりませんという方針なので 2つ入れると2つバナーを出す必要がでてきます・・・ 両サービスを運用されてる方があれば運用状況とか教えてほしいです。 PageSenseについては詳細まで機能を理解してないなかでの質問です。

• How to integrate Zoho Forms with Zoho CRM on Standard Plan

  Hello Zoho Support Team, I am using the Standard Zoho Forms plan (USD 30/user) and I would like to integrate Zoho Forms with Zoho CRM so that certain fields in my forms can be automatically prefilled using data from Deals in CRM. Specifically, I want

• CRM : Function to add user name to text field

  I have a lookup field in a module that is linked to the CRM users so we can assign a Project Lead to the customer. Sadly Zoho Marketing Automation doesn't sync Lookup fields so I need to extract information from the lookup to text fields: Lookup field

• Export PDF File Name

  Is it possible to change the default Zoho .pdf naming scheme for inventory items like quotations? Would like to use the the Subject as the default quote name. Is this possible?

• How to change the from address from 'no reply' for an email template in CRM

  Hi, We have our CRM set up with the from field as sales@XXX. I have just created a series of email templates and sent a test and they are sending from noreply@zoho I have tried searching for how to change the email template but don't have the options

• Zoho CRM Client Script - SetCriteria in lookup Field

  Hello All One More Zoho CRM Client Script Tips & Trick. Now you can Set the Criteria on Your lookup in zoho CRM, It Comes With a Create Page, Edit Page, and Details Page (Standard). Example:- We have a Room Module that includes Room Name, Status, Campus,

• Kaizen #71 - Client Script ZDKs for Detail (Canvas) Page

  Hello everyone! Welcome back to another interesting Kaizen post. In this post, we can discuss Client Script ZDKs support for Detail (Canvas) Page. What is Detail (Canvas) Page? A Detail(Canvas) Page allows you to customize the record detail page to your

• how to use validation rules in subform

  Is it possible to use validation rules for subforms? I tried the following code: entityMap = crmAPIRequest.toMap().get("record"); sum = 0; direct_billing = entityMap.get("direct_billing_details"); response = Map(); for each i in direct_billing { if(i.get("type")

• Add Custom Reports To Dashboard or Home Tab

  Hi there, I think it would be great to be able to add our custom reports to the Home Tab or Dashboards. Thanks! Chad

• Rich-text fields in Zoho CRM

  Hello everyone, We're thrilled to announce an important enhancement that will significantly enhance the readability and formatting capabilities of your information: rich text options for multi-line fields. With this update, you can now enjoy a more versatile

• Create Lead Button in Zoho CRM Dashboard

  Right now to create Leads in the CRM our team is going into the Lead module, selecting the "Create Lead" button, then building out the lead. Is there anyway to add the "Create Lead" button or some sort of short cut to the Zoho CRM Dashboard to cut out

• Zoho Reports Duplicating Entries

  I have a custom costing tab with a table where we entre invoices. These are under a Heading (PO Subject) and notes added in the form with different line items. In the reports, I have organised the report to group per PO Subject, with the total of the

• Validation Rule Not Working for Mandatory Field in Zoho Blueprint

  As a Zoho user, we created a validation rule for a specific field. However, we noticed that when we made the same field mandatory within a Blueprint, the validation rule we defined did not work. When we reported this issue to Zoho Support, they stated

• Notes Issues

  Been having issues with Notes in the CRM. Yesterday it wasn't showing the notes, but it got resolved after a few minutes., Now I have been having a hard time saving notes the whole day. Notes can't be saved by the save button. it's grayed out or not grayed

• Export from Contacts module to Products module in Zoho CRM

  Good afternoon, I would like to send a number of contact info from the Contacts module into the customized module (tickets to an event) in one operation. I have selected several contacts in the Contact module (people who I have labelled as people I want

• Zoho Commerce

  Hi, I have zoho one and use Zoho Books. I am very interested in Zoho Commerce , especially with how all is integrated but have a question. I do not want my store to show prices for customers that are not log in. Is there a way to hide the prices if not

• Can’t receive emailI c

  I have generated a basic for but when I submit it I don’t get a email, I’ve been in the settings and tested me email, all appears correct, can you please help me

• Data Capture for Historical Activity (Especially One Lead Downloading Variois reports without Overwriting the info)

  Is there a better way in Zoho CRM to capture and archive a lead’s historical activity—specifically whenever they download reports—so that the data is stored without being overwritten?”

• Client Script - Updating Field Value in Detail Page of a Lead

  Hello, I'm trying to use Client Script To enrich some data of the Lead when one of my User fill the "City" field in the detail page of the Lead. This is my Script: log (value); var response = ZDK.Apps.CRM.Functions.execute("getInfoCitta", { "nomeCitta":

• Auto shapes in Zoho sheet.

  Does Zoho sheet supports inserting auto shapes (rectangle, circle...). I did not see any option to do so.  If its not supported currently, is there any plans on bring in this features. Any timelines ?

• I Can't Clone Webinar that I Co-Organize

  How do i get our account admin to give me permission to clone our webinars? I am a co-organizer

• I want to Make the due date of the project appears automatically

  hello everyone I want to know if the zoho projects app can add automatically the END DATE of the project I added the duration, start after dates of each tasks in the project template & the starting date of the project itself and the end date of it doesn't

• Introducing Profile Summary: Faster Candidate Insights with Zia

  We’re excited to launch Profile Summary, a powerful new feature in Zoho Recruit that transforms how you review candidate profiles. What used to take minutes of resume scanning can now be assessed in seconds—thanks to Zia. A Quick Example Say you’re hiring

• How to get the call recording external ID via desk API

  I have enabled phonbridge integration with Zoom Call. I am trying to access the call recording in Zoom by calling Zoom API. I have built a Desk workflow to trigger on a new call, to call a custom function. when calling the API, the response doesn't contain

• Can't View Project Names in Mobile App

  I can't view project names on PO's in the app, nor can I add that as a viewable PDF field in inventory on the computer. I've attached screenshots showing that in the mobile version whether you are on the PO, editing the PO, or viewing the PO line items,

• How do you print a refund check to customer?

  Maybe this is a dumb question, but how does anyone print a refund check to a customer? We cant find anywhere to either just print a check and pick a customer, or where to do so from a credit note.

• Notebook

  I have purchased the monthly pro subscription of Notebook. But it does not support my XP-Pen to write something in it. So it is not useful to me. Hence I am requesting you to help me to discontinue this subscription.

• Domain Mapping & Image Publishing Issues on Zoho Sites

  Hello, I am facing two issues with my Zoho Sites account: 1. Images not visible after publishing. 2. Domain mapping error: "Domain already exists". I am a paid customer. Please connect me with Live Chat Support or Zoho Assist so I can show my issue

• Prevent duplicate with custom fields?

  I was wondering something about custom field/custom modules in Zoho Desk. For some reason you can make a custom field mandatory but not unique? For example, if I create a custom module to manage equipment and renewal and make a field serial number no

• Round robin

  Hi, I'm trying to set up a round robin to automatically distribute tickets between agents in my team but only those tickets that are not otherwise distributed by other workflows or direct assignments. Is that possible and if so which criteria should I

• "Is Zoho CRM customer" vs "Is linked with Zoho CRM"

  Recently while building a Flow, I was setting up a Decision action following a Zoho Invoice Fetch record action. There were 2 choices that I had not seen as something I could manually action in Zoho Invoice: "Is Zoho CRM customer" and "Is linked with

• Two currencies

  More and more I am finding that internattional payments' fees are unpredictable. I would like, on my invoices that are in a foreign currency (eg. USD$ or EUR€) for there to be a GBP£ TOTAL display alongside the invoice's currency total. This would make

• Automatic Matching from Bank Statements / Feeds

  Is it possible to have transactions from a feed or bank statement automatically match when certain criteria are met? My use case, which is pretty broadly applicable, is e-commerce transactions for merchant services accounts (clearing accounts). In these

• Generate leads from instagram

  hello i have question. If connect instagram using zoho social, it is possible to get lead from instagram? example if someone send me direct message or comment on my post and then they generate to lead

• Zoho PDF editor has a lot of issues.

  Zoho PDF editor needs a lot of work. It hangs and glitches a lot. Deletes annotations and clearings randomly.

• Where is the desktop app for Zoho Projects???

  As a project manager, I need a desktop app for the projects I manage. Yes, there's the web app, which is AWESOME for cross browser and platform compatibility... but I need a real desktop app for Projects that allow me to enter offline information where

• How to Automate Monthly PDF Reports with Filters in Zoho Creator

  Hi everyone, I’m trying to build an automated monthly reporting process in Zoho Creator and would appreciate suggestions or best practices from anyone who has done something similar. What I’m trying to do: I have a form called New_Customer with fields

• Feedback: Streamlining Note Management in Zoho Notebook

  Dear Team/Support, I would like to share some feedback regarding the note management system that could help improve usability and accessibility for users like myself. Notebook 1 (screenshot attached): Currently, the system does not allow selecting and

• showing Limit exceeded

  Good afternoon...trust you're good. I've been having issues working with but it's not responding. it's showing Limit exceeded, sorry it seems like too many people are working on the sheet right now please try again later. meanwhile no one is working on

• Next Page