Kaizen 231 - Embedding Zoho Desk Tickets in Zoho CRM
Hello, CRM Wizards!
We will use the Zoho Request Client inside a Related List widget to display open Zoho Desk tickets directly within the Contact record in Zoho CRM. This integration allows Sales and Support teams to access active support issues without switching applications.
Business Problem
At Zylker, a manufacturing company that manages high-value distributors and enterprise buyers, sales operations run in Zoho CRM while customer support manages warranty claims and service issues in Zoho Desk.
This separation creates operational friction during critical customer interactions.
1. Lack of visibility into open support tickets
Sales representatives cannot see ongoing support tickets when interacting with customers in CRM. This results in:
- Sales conversations happening without awareness of active complaints.
- Poor customer experience when unresolved issues surface unexpectedly.
- Reduced productivity due to frequent system switching between CRM and Desk.
2. No Controlled Escalation Mechanism
There is no structured way to initiate ticket escalations from within Zoho CRM.
Solution
This week we will focus on solving the visibility gap.
We will embed a related list widget within Contact detail page and provide real-time visibility of open tickets.
Prerequisites
2. A two-way sync between Zoho CRM and Zoho Desk is required to keep Contacts and Accounts consistent across both applications.
With this support, any change made to a Contact or Account in either application is automatically reflected in the other.
Additionally, each record in Zoho Desk stores the corresponding Zoho CRM record ID. This allows you to reference the CRM record directly and perform further customizations or integrations using that unique ID.
Follow the steps to create the two-way sync:
- Log into Zoho Desk.
- Go to Settings > Integration > Zoho.
- Choose Zoho CRM and click Integrate.
- On the Authentication page:
- Enter your email address.
- Choose the CRM organization you want to integrate with.
- Click Authorize.
- Once authenticated, the sync configuration page opens.
- Select the sync type as Two-way Sync.
- Map the fields of Accounts and Contacts modules between Zoho Desk and Zoho CRM.
- Click Start Sync to initiate the integration.
Refer to the Integrating Zoho Desk with Zoho CRM help page for more details.
3. Create a Zoho Desk connection in Zoho CRM with Desk.tickets.READ and Desk.contacts.READ scopes.
Refer to the Connections help doc for more information. Store the Connection Link Name to use while making API calls.
4. Create a local project folder for widget using Zoho CLI as mentioned in Creating your First Widget help guide.
Step-by-Step Implementation
In the widget project directory, code the following logic in the widget.html file.
Step - 1: Get the Current CRM Contact ID
On page load, you can capture the entity ID with the help of PageLoad event listener.
Also create a reusable ZRC instance configured with the Zoho Desk base URL and OAuth connection name.
// Initialize the embedded app ZOHO.embeddedApp.on("PageLoad", async function(data) { console.log("PageLoad data:", data); // Step 1: Get the entity (module) and entity ID (Contact record ID) if (data && data.Entity && data.EntityId) { entityModule = data.Entity; entityId = data.EntityId; console.log("Entity:", entityModule); console.log("Entity ID (CRM Contact ID):", entityId); // Create reusable ZRC instance for Zoho Desk API deskZrc = zrc.createInstance({ baseUrl: 'https://desk.zoho.com/api/v1', connection: 'desk_oauth_connection' }); await loadTickets(); } else { showError("No contact context found"); } }); ZOHO.embeddedApp.init(); |
Step - 2: Fetch Desk Contacts and Match the CRM Contact ID
Make a GET Contacts API call to the Zoho Desk API using the ZRC instance. Loop through the returned contacts and find the one whose zohoCRMContact.id matches the current CRM Contact ID.
// Step 2: Make GET contacts API call to Desk using ZRC const contactsResponse = await deskZrc.get('/contacts', { params: { limit: 100 } }); console.log("Desk Contacts Response:", contactsResponse); if (contactsResponse && contactsResponse.data) { // Parse the response data const contactsData = typeof contactsResponse.data === 'string' ? JSON.parse(contactsResponse.data) : contactsResponse.data; // Find the object where zohoCRMContact.id matches Contact record ID if (contactsData && contactsData.data && Array.isArray(contactsData.data)) { const matchingContact = contactsData.data.find(function(contact) { return contact.zohoCRMContact && contact.zohoCRMContact.id && contact.zohoCRMContact.id === entityId; }); if (matchingContact) { // Pick the id (Desk contact record ID) const deskContactId = matchingContact.id; console.log("Desk Contact ID:", deskContactId); // Proceed to fetch tickets await fetchTickets(deskContactId); } else { showEmptyState("No Desk contact found linked to this CRM contact"); } } } |
Step - 3: Fetch Open Tickets and Filter by Desk Contact ID
Make a GET Tickets API call to Zoho Desk with the following parameters:
- Specify status with Open value to retrieve only open tickets.
- Specify include with value set to contacts fetch each ticket details with its associated contact details.
Filter the API response with the matched Desk Contact ID and render the results.
async function fetchTickets(deskContactId) { try { // Step 3: Make GET Tickets API call using ZRC const ticketsResponse = await deskZrc.get('/tickets', { params: { include: 'contacts', status: 'Open', limit: 100 } }); console.log("Tickets Response:", ticketsResponse); if (ticketsResponse && ticketsResponse.data) { const ticketsData = typeof ticketsResponse.data === 'string' ? JSON.parse(ticketsResponse.data) : ticketsResponse.data; // Filter tickets where contact matches deskContactId if (ticketsData && ticketsData.data && ticketsData.data.length > 0) { const matchingTickets = ticketsData.data.filter(function(ticket) { return ticket.contact && ticket.contact.id === deskContactId; }); if (matchingTickets.length > 0) { renderTickets(matchingTickets); } else { showEmptyState("No open tickets found for this contact"); } } else { showEmptyState("No open tickets found"); } } } catch (error) { console.error("Error fetching tickets:", error); showError("Failed to fetch tickets: " + (error.message || error.toString())); } } |
Step - 4: Validate and Pack the Widget
Follow the steps given in the Widget help page to validate and package the widget. A complete working code sample is provided as attachment at the end of this post.
Creating a Related List Widget
1. Go to Zoho CRM > Setup > Developer Hub > Widgets and click Create New Widget.
2. Fill in the required details such as:
- Name: Zoho WorkDrive
- Type: Related List
- Hosting: Zoho
- File Upload: Upload the ZIP created in the dist folder within the widget project directory after packaging in the Step 4.
- Index page: /widget.html
3. Go to Customization > Modules and Fields > Contacts > Standard > Detail View. Then, create and associate the related list widget.
Refer to the Customize Related Lists help page for more information on creating a related list.
Try it Out!
Let us look at the output from the Contacts detail page in Zoho CRM.
Key Points to Remember
- Two-way sync is mandatory to link Desk contacts with CRM contacts.
- Connection setup in Zoho CRM for Desk is mandatory with Desk.tickets.READ and Desk.contacts.READ scopes. Ensure to replace the connection name in line 21.
- If the account has a large number of contacts or tickets, implement pagination using from and limit parameters to ensure all records are evaluated.
- Ensure to replace the Desk URL to ticket in line 181 with your portal name and company name.
We hope this Kaizen helps your sales team to see active issues instantly. Next week, we will look at how to establish a ticket escalation mechanism from Zoho CRM.
Have questions or suggestions? Drop them in the comments or write to us at support@zohocrm.com.
On to Better Building!
-----------------------------------------------------------------------------------------------------------
Related Reading
1. Widgets - An Overview, CLI Installation, Working with Widgets, ZRC Methods, Mobile Compatibility of Widgets and Kaizens
2. Connections - An Overview
3. CRM Customizations - Related Lists
4. Desk APIs - GET Tickets API and GET Contacts API
5. Desk Customizations - Integrate Zoho Desk with Zoho CRM
5. Desk Customizations - Integrate Zoho Desk with Zoho CRM
-----------------------------------------------------------------------------------------------------------
Previous Kaizen: Smart Discount-Based Quote Approvals Using CRM Functions and Approval Process | Kaizen Collection: Directory
Access your files securely from anywhere
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
New to Zoho Recruit?
Zoho Developer Community
New to Zoho LandingPage?
Zoho LandingPage Resources
New to Zoho Survey?
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Bigin?
Topic Participants
Kiruthiga G
Sticky Posts
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.Kaizen #226: Using ZRC in Client Script
Hello everyone! Welcome to another week of Kaizen. In today's post, lets see what is ZRC (Zoho Request Client) and how we can use ZRC methods in Client Script to get inputs from a Salesperson and update the Lead status with a single button click. In thisKaizen #222 - Client Script Support for Notes Related List
Hello everyone! Welcome to another week of Kaizen. The final Kaizen post of the year 2025 is here! With the new Client Script support for the Notes Related List, you can validate, enrich, and manage notes across modules. In this post, we’ll explore howKaizen #217 - Actions APIs : Tasks
Welcome to another week of Kaizen! In last week's post we discussed Email Notifications APIs which act as the link between your Workflow automations and you. We have discussed how Zylker Cloud Services uses Email Notifications API in their custom dashboard.Kaizen #216 - Actions APIs : Email Notifications
Welcome to another week of Kaizen! For the last three weeks, we have been discussing Zylker's workflows. We successfully updated a dormant workflow, built a new one from the ground up and more. But our work is not finished—these automated processes are
New to Zoho TeamInbox?
Zoho TeamInbox Resources
Zoho CRM Plus Resources
Zoho Books Resources
Zoho Subscriptions Resources
Zoho Projects Resources
Zoho Sprints Resources
Qntrl Resources
Zoho Creator Resources
Zoho CRM Resources
Design. Discuss. Deliver.
Zoho Show Resources
Get Started. Write Away!
Writer is a powerful online word processor, designed for collaborative work.
Zoho CRM コンテンツ
-
オンラインヘルプ
-
Webセミナー
-
機能活用動画
-
よくある質問
-
Ebook
-
-
Zoho Campaigns
- Zoho サービスのWebセミナー
その他のサービス コンテンツ
Nederlandse Hulpbronnen
ご検討中の方
Recent Topics
How do I edit the Calendar Invite notifications for Interviews in Recruit?
I'm setting up the Zoho Recruit Interview Calendar system but there's some notifications I don't have any control over. I've turned off all Workflows and Automations related to the Calendar Scheduling and it seems that it's the notification that is sentBookings duration - days
Hi team, Is there any way to setup services/bookings that span multiple days? I am using Zoho Bookings for meeting room bookings. Clients may wish to book a room for more than one day, for up to a month. If not, is there a plan to allow services to be setup with durations of Days as well as hours and minutes? Many thanks, Anna.big 5 accounts
how do you find what accounts are listed as Big 5 ?Zoho recruit's blueprint configuration is not functioning as mapped
Current Status: Zoho Blueprint is not functioning as configured. Issue: We are moving a Candidate status in Zoho Recruit "for active file" but we encountered: "Status cannot be changed for records involved in Blueprint." This happens to various clientActual vs Minimum
Hi all, I am sure I am not the only one having this need. We are implementing billing on a 30-minute increment, with a minimum of 30 minutes per ticket. My question is, is there a way to create a formula or function to track both the minimum bill vs theDelay in rendering Zoho Recruit - Careers in the ZappyWorks
I click on the Careers link (https://zappyworks.zohorecruit.com/jobs/Careers) on the ZappyWorks website expecting to see the job openings. The site redirects me to Zoho Recruit, but after the redirect, the page just stays blank for several seconds. I'mHow to add interviews through API
I'm trying to add an interview without much luck. The documentation gives examples of adding just about everything except an interview. However, the issue might be the way I'm formatting it, because the documentation is unclear to me. It seems as if the xml should be passed in the url, which seems unusual. I've tried the data as both plain and character escaped, but nothing seems to work, nor do I even get an error response. https://recruit.zoho.com/recruit/private/xml/Interviews/addRecords?authtoken=***&scope=recruitapi&version=2&xmlData=<Interviews> <rowOffer already made- but I withdrew it
I made an offer letter, but made a mistake on it. I withdrew the offer but now I can't recreate the correct offer. Zoho keeps saying that "A same offer has already been made". I look in the "offers" and there are NO offers (this is the first time I'veControl the precision of answer bot responses
Hello everyone, Admins can control the precision with which the Answer bot analyzes and generates a response by adjusting the threshold levels. Based on predefined threshold values, Zia analyzes how closely the query matches with the available KB articles.Rebrand your CRM with the all-new custom domain mapping setup
UPDATES TO THIS FEATURE! 19th Jan, 2024 — Custom domain mapping has been made available for portal users in Zoho One and CRM Plus. 23rd June, 2023 — Custom domain mapping has been made available for all users, in all DCs. Hello everyone! We are elatedAdd Israel & Jewish Holidays to Zoho People Holidays Gallery
Greetings, We hope you are doing well. We are writing to request an enhancement to the Holidays Gallery in Zoho People. Currently, there are several holidays available, but none for Israel and none for Jewish holidays (which are not necessarily the sameSender Email ID is duplicate
My sender id "automate@erplaunchpad.com" is coming as duplicate but I have not used it anywhere else please helpCRM x WorkDrive: File storage for new CRM signups is now powered by WorkDrive
Availability Editions: All DCs: All Release plan: Released for new signups in all DCs. It will be enabled for existing users in a phased manner in the upcoming months. Help documentation: Documents in Zoho CRM Manage folders in Documents tab Manage filesBuilding Toppings #6 - Install and uninstall actions
Hello Biginners! In our previous forum post, we explored creating connections - specifically, custom service connections in the Bigin Developer Console. In this post, we'll focus on another feature that can be used in every topping: install actions. We'llNew UI in Zoho One CRM
Hello, Just switched to the new UI for Zoho One CRM, do not like it, especially the search functions. What are the steps to backstep to the previous UI? UPDATE: I found it.App like Miro
Hi all, is there a way to have a interactive whiteboard like in Miro? We want to visualize our processes and workflows in an easy way.Important updates to your connectors
Hello everyone, Greeting from Zoho Creator! We're excited to announce that we'll be rolling out significant backend updates to Zoho Creator's built-in connectors to enhance security by following the latest frameworks. The existing version of some of theProduct Request: Send email to Secondary email
Guys, we should be able to send the campaign to the secondary email too. Is this on the plans for Zoho Campaign? It looks like I can map the secondary email from the CRM to the Campaigs, but can not send the message.Logic for sending to a non-primary email address
Hi, I have a scenario where contacts are able to sign up for emails with 2 different email addresses (example: work, personal). I've mapped both to Campaigns from Zoho CRM, but when I go to target an email only the primary email addresses are pulling in. How can I update this to look at both of the email addresses - or specifically the secondary email address in Campaigns? Thanks, JennyHow Do Mutliple Sales People Prospect in the "LEADS" module without calling the same leads?
We have 4 sales reps and the Leads module does not have real time intuitive knowlodge to make the sales rteps dont call the same people at the same time. How can we crate a fluent prospecting sytem where the salres reps can go out bound without callingKeeping track of project expenses
I have talked to a few support techs and it is very hard for me to believe that Zoho's project accounting software can't keep accounts for my projects. I must not understand what they're saying. We get a contract to build something. So the project revenueMailbox delegation - A secure way to enable collaboration
Admins often encounter scenarios where a user needs another team member to access and manage their mailbox during extended leave, role transitions, or while handling high email volumes. In such situations, ensuring business continuity without sharingCanvas View bug
I would like to report a bug. When clone a canvas view from an existing canvas view, if the original canvas view have canvas button with client script. Then the new create canvas view will have canvas button, it is make sense. But when I try to deleteExport blueprint as a high-resolution PDF or image file
This would be a good feature for organizations that want to share the blueprint process with their employees but don't want them to have access to the blueprint in the system settings. At the moment all that users can do is screenshot the blueprint orZoho Recruit Community Meetup - London 🇬🇧 (Venue Finalised)
Hello Recruiters! We’re excited to announce that the Zoho Recruit team is coming to the UK for an in-person Zoho User Group (ZUG) Meetup in London! This is your chance to connect with fellow Zoho users, learn from experts, and walk away with actionableUsers may not pick the fields to be shown as columns in the Choose Account window when creating a new Deal record
Hi there, by talking with other users I found out that I, as an Admin, am the only one who can pick fields to be shown as columns in the Choose Account window when creating a new Deal record. In fact, if other users click on the "Add Column" symbol on【参加無料】東京 Zoho ユーザ交流会 NEXUS ー AI エージェント (Zia Agents)の活用事例 / CRMで実現するマーケティング業務効率化
ユーザーの皆さま、こんにちは。コミュニティチームの藤澤です。 3月27日(金)に東京、新橋で「東京 Zoho ユーザー交流会 NEXUS」を開催します！ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ✒️申し込みはこちらから：https://www.zohomeetups.com/tokyo2026vol1#/?affl=communityforumpost2 ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーー ★参加のおすすめポイント ✅ AIエージェント（Zia）のリアルに使える実例を知るError AS101 when adding new email alias
Hi, I am trying to add apple@(mydomain).com The error AS101 is shown while I try to add the alias.ZOHO.CRM.UI.Record.open not working properly
I have a Zoho CRM Widget and in it I have a block where it will open the blocks Meeting like below block.addEventListener("click", () => { ZOHO.CRM.UI.Record.open({ Entity: "Events", RecordID: meeting.id }).catch(err => { console.error("Open record failed:",Python - code studio
Hi, I see the code studio is "coming soon". We have some files that will require some more complex transformation, is this feature far off? It appears to have been released in Zoho Analytics already🚀 WorkDrive 6.0 (Phase 1): Empowering Teams with Content Intelligence, Automation, Accessibility, and Control
Hello, everyone! WorkDrive continues to evolve from a robust file management solution into an intelligent, secure, and connected content collaboration platform for modern businesses. Our goal remains unchanged: to simplify teamwork, strengthen data security,Introducing Workqueue: your all-in-one view to manage daily work
Hello all, We’re excited to introduce a major productivity boost to your CRM experience: Workqueue, a dynamic, all-in-one workspace that brings every important sales activity, approval, and follow-up right to your fingertips. What is Workqueue? SalesSupport Custom Background in Zoho Cliq Video Calls and Meetings
Hello Zoho Cliq Team, We hope you are doing well. We would like to request an enhancement to the video background capabilities in Zoho Cliq, specifically the ability to upload and use custom backgrounds. Current Limitation At present, Zoho Cliq allowsUpload own Background Image and set Camera to 16:9
Hi, in all known online meeting tools, I can set up a background image reflecting our corporate design. This doesn't work in Cliq. Additionally, Cliq detects our cameras as 4:3, showing black bars on the right and left sides during the meeting. WhereISO 27001 Compliance
What are people doing to ensure ISO 27001 compliance for their Zoho environments? It would make sense for Log360 Cloud to integrate natively with the Zoho suite, but that is not the case. It requires a gateway cluster, which is not an option for a fullyZoho People - Retrieve the Leave Details - get("LeaveCount")
Hi, Zoho People I need to collect all of an employee's leave requests for the calendar year and check how many half-days they have taken. If I run the script on the query he just modified, I can retrieve the information related to that query and use theWhat's new in Zoho Sheet: Simplify data entry and collaboration
Hello, Zoho Sheet community! Last year, our team was focused on research and development so we could deliver updates that enhance your spreadsheet experience. This year, we’re excited to deliver those enhancements—but we'll be rolling them out incrementallyMarketer's Space: New to Campaigns? Some common early mistakes that might occur
Hello Marketers, Welcome back to another post in Marketer's Space. If you're just getting started with Zoho Campaigns, things can feel exciting and slightly confusing at the same time. You're not alone. Most early frustrations come from setup gaps ratherThis user is not allowed to add in Zoho. Please contact support-as@zohocorp.com for further details
Hello, Just signed up to ZOHO on a friend's recommendation. Got the TXT part (verified my domain), but whenever I try to add ANY user, I get the error: This user is not allowed to add in Zoho. Please contact support-as@zohocorp.com for further details I have emailed as well and writing here as well because when I searched, I saw many people faced the same issue and instead of email, they got a faster response here. My domain is: raisingreaderspk . com Hope this can be resolved. Thank youWorkflow Rule - Field Updates: Ability to use Placeholders
It will be great if you can use placeholder tags to update fields. For example if we want to update a custom field with the client name we can use ${CONTACT.CONTACT_FIRSTNAME}${CONTACT.CONTACT_LASTNAME}, etcNext Page