Extension Pointers for Integrating Zoho CRM with Zoho services #2: Handle and manage your Zoho CRM cases efficiently by integrating Zoho Projects and associating cases with tasks
Integrating customer relationship management and project management contributes to the development of an overall effective business management strategy.
You can integrate Zoho CRM and Zoho Projects through extensions to achieve your desired functionalities and manage your business from a single location. The previous post in the 'Integrating Zoho CRM with Zoho services' series described how to register your Zoho application and retrieve the client credential in order to connect Zoho CRM to the Zoho service of your choice through an extension. In this post, we'll look at how to integrate Zoho CRM with Zoho Projects, along with an example.
Let's consider a scenario in which support representatives handling cases in Zoho CRM need to forward cases that are registered as feature requests to the development team for further consideration and analysis. The representatives can create a task in Zoho projects with the necessary details from the Zoho CRM Cases module by clicking a button from within Zoho CRM. This will make the transition process easier and help to handle cases more efficiently. Now, let's see how this can be achieved using extension.
Creating a connector for Zoho Projects and adding connector APIs
- Create a new connector in your extension for Zoho Projects using the Connectors feature under Utilities in the left panel of the Zoho Developer console.
Note: Zoho Projects follows OAuth2.0 protocol for authentication mechanism. You can refer to this post to understand the steps to register Zoho Projects and retrieve your client credentials.
The connector details for our example are:
Request Token URL | https://accounts.zoho.com/oauth/v2/auth?scope=ZohoProjects.portals.READ,ZohoProjects.users.READ,ZohoProjects.tasks.CREATE,ZohoProjects.projects.READ,ZohoProjects.tasks.READ&access_type=offline |
Access Token URL | https://accounts.zoho.com/oauth/v2/token? |
Refresh Token URL | https://accounts.zoho.com/oauth/v2/token? |
Scopes | ZohoProjects.portals.READ,ZohoProjects.users.READ,ZohoProjects.tasks.CREATE,ZohoProjects.projects.READ,ZohoProjects.tasks.READ |
- Add the necessary connector APIs for your functionality. Please refer to the Zoho Projects REST API guide for details.
The Zoho Projects REST APIs added for our example are mentioned below.
Connector API Name | Method type | URL |
Get Portals | GET | https://projectsapi.zoho.com/restapi/portals/ |
Get Project Users | GET | https://projectsapi.zoho.com/restapi/portal/${portalid}/projects/${projectid}/users/ |
Create task | POST | https://projectsapi.zoho.com/restapi/portal/${portalid}/projects/${projectid}/tasks/?name=${name}&description=${description}&priority=${priority}&person_responsible=${person_responsible} |
Add comment for task | POST | https://projectsapi.zoho.com/restapi/portal/${portalid}/projects/${projectid}/tasks/${taskid}/comments/?content=${content} |
Note: You can refer to this post to understand the detailed steps involved in creating a connector, adding the connector APIs, and associating it with the extension.
Creating a button in Cases module and associating the custom function to it
- Create a button called "Create Task for Case" using the Links & Buttons feature available in the Componentssection of the Zoho Developer console, then associate a custom function to perform the desired action.
Create Task for Case - Button function code
//Fetching the current record details and retrieving the necessary field information response = zoho.crm.getRecordById("Cases",case.get("Cases.ID").toLong()); Name = response.get("Subject"); Name = zoho.encryption.urlEncode(Name); Description = response.get("Description"); Description = zoho.encryption.urlEncode(Description); Priority = response.get("Priority"); Comments = response.get("Internal_Comments"); Comments = zoho.encryption.urlEncode(Comments); dynamic_map = Map(); /*Fetching the values for Portal ID and Project ID CRM variables which are obtained as part of the settings widget*/ portalid = zoho.crm.getOrgVariable("xxx__Portal_Id");//The api name of the CRM variable for Portal_Id projectid = zoho.crm.getOrgVariable("xxx__Project_Id");//The api name of the CRM variable for Project_Id dynamic_map.put("portalid",portalid); dynamic_map.put("projectid",projectid); //Invoking the connector API to retrieve the users present in the project resp1 = zoho.crm.invokeConnector("xxx.zohoprojects.getprojectusers",dynamic_map); response1 = resp1.get("response"); users = response1.get("users"); rolelist = List(); /*retrieving the ID of the user with admin role in the project to be assigned as the person responsible for the task*/ for each value in users { if(value.get("role") == "admin") { id = value.get("zpuid"); } } dynamic_map = Map(); portalid = zoho.crm.getOrgVariable("xxx__Portal_Id"); projectid = zoho.crm.getOrgVariable("xxx__Project_Id"); dynamic_map.put("portalid",portalid); dynamic_map.put("projectid",projectid); dynamic_map.put("name",Name); dynamic_map.put("description",Description); dynamic_map.put("priority",Priority); dynamic_map.put("person_responsible",id); /*Invoking the connector API with the necessary parameters passed to create a project task */ resp = zoho.crm.invokeConnector("xxx.zohoprojects.createtask",dynamic_map); response2 = resp.get("response"); tasks = response2.get("tasks"); //Retrieving the task id from the response of create task API for each ids in tasks { id1 = ids.get("id"); } dynamic_map = Map(); portalid = zoho.crm.getOrgVariable("xxx__Portal_Id"); projectid = zoho.crm.getOrgVariable("xxx__Project_Id"); dynamic_map.put("portalid",portalid); dynamic_map.put("projectid",projectid); dynamic_map.put("taskid",id1); dynamic_map.put("content",Comments); //Invoking the connector API to add a comment to the task response3= zoho.crm.invokeConnector("xxx.zohoprojects.addcommentfortask",dynamic_map); caseinfo = {"Solution":url}; response4 = zoho.crm.updateRecord("Cases",case.get("Cases.ID").toLong(),caseinfo); return resp; |
Note: In our example, the project's administrator is assigned as the person responsible for the task that is to be created in Zoho Projects. We have considered that there is only one admin for a project, who can then assign the task to the appropriate developer.
Obtaining Portal ID and Project ID
According to our example, cases from Zoho CRM need to be associated as a task to a particular project in Zoho Projects. You can find in the above code that the variables Portal ID and Project ID (dynamic variables used in connector APIs) are used while invoking APIs. The values of these variables are specific to a user and thus these values can be obtained from the user during extension installation and stored in CRM variables to be easily retrieved when required.
The variables Portal ID and Project ID are created as CRM variables with the Variable Status as Hidden in the extension.Their values are obtained as follows:
➤ Creating a Settings Widget: We have created a settings widget in our extension in order to retrieve the user-specific portal ID and project ID, and to set the values to the CRM variables.
Settings Widget js code snippet
Util={}; var portalidvalue; var projectidvalue; //Subscribe to the EmbeddedApp onPageLoad event before initializing the widget ZOHO.embeddedApp.on("PageLoad",function(data) { var data = { } //Invoking the connector API to get portals of the user and populate them in a select list ZOHO.CRM.CONNECTOR.invokeAPI("testextensioncrm.zohoprojects.getportals",data) .then(function(dataa){ response = dataa.response; responsejson=JSON.parse(response); portal=responsejson.portals; for (i = 0; i < portal.length; i++) { portalid=portal[i].id_string; portalname=portal[i].name; var portallist = document.getElementById("portallist"); var option = document.createElement("OPTION"); option.innerHTML = portalname; option.value = portalid; portallist.appendChild(option); } }) /*Fetching the projects associated to the portal selected on click of the "Get Projects" button*/ Util.getproject=function() { portalidvalue=document.getElementById("portallist").value; var data = { "portalid" : portalidvalue } /*Invoking the connector API to get projects of the user with respect to the portal chosen and populate them in a select list*/ ZOHO.CRM.CONNECTOR.invokeAPI("testextensioncrm.zohoprojects.getprojects",data) .then(function(dataa){ response = dataa.response; responsejson=JSON.parse(response); project=responsejson.projects; $('#projectlist').empty(); for (j = 0; j < project.length; j++) { projectid=project[j].id_string; projectname=project[j].name; var projectlist = document.getElementById("projectlist"); var option = document.createElement("OPTION"); option.innerHTML = projectname; option.value = projectid; projectlist.appendChild(option); } }) } /*Updating the values of the portal ID and project ID selected in the select list to the CRM variables*/ Util.getvalues=function() { portalidvalue=document.getElementById("portallist").value; projectidvalue=document.getElementById("projectlist").value; var variableMap = { "apiname": "testextensioncrm__Portal_Id", "value": portalidvalue}; ZOHO.CRM.CONNECTOR.invokeAPI("crm.set", variableMap); var variableMap = { "apiname": "testextensioncrm__Project_Id", "value": projectidvalue}; ZOHO.CRM.CONNECTOR.invokeAPI("crm.set", variableMap); }); }); } }) |
Now that the functionality is defined, the extension is published and installed in Zoho CRM account using the private installation URL.
Sample output:
Upon installation of the extension, click the Settings button to go the Settings Widget page, then choose your portal and project where you want the task to be created.
Choose the portal of your choice, then click the Get Projects button to fetch the projects associated with that portal.
Next, click Update Values to set the chosen portal and project ID values to the CRM variables Portal_ID and Project_ID,respectively.
Go to the Cases module. A case of type feature request is present in Cases module.
Click the Create Task for Case button available in the view page of the case detail page.
The necessary details as per the code logic are fetched and created as a task in projects.
The detailed task details page with all the information fetched from the case in Zoho CRM Cases module.
Using this method, you can integrate Zoho CRM and Zoho Projects via an extension and perform functionalities as per your business requirements. We hope you find this information useful. Keep following this space for more inputs!
SEE ALSO
Access your files securely from anywhere
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
Nanditha Somasundaram Somasundaram
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 FAQsKaizen #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
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
Connecting Portals from different Zoho apps
Hi, I note that Zoho has functionality for customer portals for several of the Zoho apps, like CRM, Projects, Desk etc. Is there any way to connect these portals? It would be great if we could give our customers access to a portal in which they couldNot able to item an item to non taxable via api, despite sending is_taxable as false
Hi everyone, I'm trying to update an item via books api and even when sending is_taxable as false, the item still shows Taxable in zoho, I get no errors as well when I update, any help appreciated in this!Collection & Payment Mapping Automation
We book Sales Invoices and Purchase Invoices against Same Projects. Both Sales Invoices & Purchase Invoices can have one or multiple Projects mentioning the Project ID. We prefer to Make vendor Payments Once we have received The Collections from ClientsNested Sub-forms (Subform within subform)
Hi Team, Whether there is any possibilities to add sub-form with in another sub-form like Main Form -> Sub form A ->Sub form B If we tried this, only one level of sub form only working. Any one having any idea about this? Thanks Selvamuthukumar RRestore Trashed Records Anytime Within 30 Days
Access the recycle bin from the Data Administration tab under the settings page in Zoho Projects, which gives better control over the trashed data. When records like projects, phases, task lists, tasks, issues, or project templates are trashed, they areAvoiding Inventory Duplication When Creating Bills for Previously Added Stock
I had created several items in Zoho Books and manually added their initial stock at the time of item creation. However, I did not record the purchase cost against those items during that process. Now, I would like to create Purchase Orders and convertApplying EUR Payments to USD Invoices in Zoho Books
Hello, I have a customer to whom I issue invoices in USD. However, this customer makes payments in both EUR and USD. I have already enabled the multi-currency feature in Zoho Books Elite, but I am facing an issue: When the customer makes a payment inHow to prevent users from editing mail merge templates from Zoho crm
We want users to use public mail merge templates. They should not be able to edit templates but only preview data merge and send emails. We did prohibit "manage mail merge template" in the user profile. But they can still edit the template in the zohoCustomer Addresses cannot be edited/deleted in invoices
In the invoices we have an option to change the customer address and add a new address Now I dont know why for some reason if we add an address through this field, the address doesn't appear in the customer module We cannot delete the addresses addedCustom Fields connected to Invoices, Customers, Quotes, CRM
I created the exact same custom fields in Books: Invoices, Customer, Quotes, and in CRM but they don't seem to have a relationship to one another. How do I connect these fields so that the data is mapped across transactions?Accelerate Github code reviews with Zoho Cliq Platform's link handlers
Code reviews are critical, and they can get buried in conversations or lost when using multiple tools. With the Cliq Platform's link handlers, let's transform shared Github pull request links into interactive, real-time code reviews on channels. ShareHeads up: We're going to update the VAT Summary table's visibility (UK and Germany Editions)
Hello users, Note: This change only applies to organisations using the UK and Germany editions of Zoho Books. Currently, if you've enabled the VAT Summary table in a template, it will be displayed only in PDFs sent to your customers whose default currencyPartial payment invoicing
Greetings I have questions related to payments and retainer invoices: 1. When I want to issue a partial payment invoice, I can't specify the portion to be paid or already paid, then balance to be shown as Due. 2. Retainer invoice is only available asInputting VAT Pre-Registration expenses for first VAT Return
Hi Zoho, I've just registered for VAT and am setting up Zoho to handle calculations and VAT return submissions. I'm struggling to figure out how to input the last 4 years worth of expenses into Zoho so that they're calculated in the VAT module. When IAnyone else experiencing very slow loading of pages in Zoho Projects?
I reported this yesterday only to be told there are no issues but is anyone else experiencing stupidly slow loading of pages. On our loading screen, it is taking often as long as 60 seconds to load a page and just stays on this screen for ages! OtherZoho Desk Lookup Field Reporting
Thank you for adding the ability to add additional lookup fields for desk tickets. My question is how do you report against these fields? For example: Associating related accounts to the primary desk ticket account, I am not able to add the lookup fieldsIntegrating asana will cause notification messages to pop up continuously
When I create or edit a task in Asana, the Asana bot keeps updating messages to group chat, which causes the cliq to keep popping up notifications.Is there an API to "File a Ticket" in Desk
Hi, Is there an API to "File a Ticket" in Desk to zoho projects?Entire notebook that had notes has disappeared
I don't know how tf this happened. All I did was uninstall and reinstall the mobile app after fixing a bug I had. After I reinstalled the app, everything was synced back except for one folder which had a bunch of notes in it. None of those notes are inMy site has disappeared from web builder
www.mproperties.uk My site above is still working. However it has completely disappeared from my Zoho sites' web builder. I am therefore unable to edit my site whatsoever. Please help.Kaizen #147 - Frequently Asked Questions on Zoho CRM Widgets
Heya! It's Kaizen time again, folks! This week, we aim to address common queries about Zoho CRM Widgets through frequently asked questions from our developer forum. Take a quick glance at these FAQs and learn from your peers' inquiries. 1. Where can ITrying to trigger email notification based on rollup summary field
Hi there, I'm trying to trigger an email notification via Workflow Rules wherever the rollup summary field "Total Shipments" goes from empty to not empty. However this field is not available from the picklist of options in the Workflow rule. Can anyonezia data enrichment - switch to webamigo Extension
Hello, I have so far used data enrichment via Zia. Now I have installed the Webamigo extension to expand personal data. Unfortunately, nothing has changed after the installation; are there any additional steps needed to switch from the previous methodRich-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 versatileExport Timeline
With the new Timeline features, it would be really helpful to have the option to export a timeline. When handling customer complaints, having the full breakdown of everything that happens on a module is great but we usually have to send this to anotherInteractions Tab in Zoho CRM: A 360° Omnichannel View of Every Customer Touchpoint
Hello Everyone, Hope you are well! We are here today with yet another announcement in our series for the revamped Zoho CRM. Today, we introduce Interactions Tab a new way to view all customer interactions from one place inside your CRM account. CustomersHow to resubscribe a contact marked as "Unsubscribed (Marked by Recipient)" without using a form?
Hello, I have a question regarding Zoho Marketing Automation functionality. Is there a way for an administrator to change the subscription status of a contact marked as "Unsubscribed (Marked by Recipient)" back to "Subscribed" without using a form? Ideally,Linkedin: when Zoho Social is going serious with it?
Hi, it's been said in the past that Linkedin related features in Zoho Social were well behind those of other social networks because of limitations imposed by the platform. Now that we see around my tools (take taplio.com) frankly outpacing ZSocial on5名限定 課題解決型ワークショップイベント Zoho ワークアウト開催のお知らせ(7/24)
ユーザーの皆さま、こんにちは。Zoho ユーザーコミュニティチームの藤澤です。 7月開催のZoho ワークアウトについてお知らせします。 2ヶ月ぶりに、渋谷にて「リアル開催」します！ ▷▷詳細はこちら：https://www.zohomeetups.com/20250724Zoho ━━━━━━━━━━━━━━━━━━━━━━━━ Zoho ワークアウトとは？ Zoho ユーザー同士で交流しながら、サービスに関する疑問や不明点の解消を目的とした「Zoho ワークアウト」を開催します。 Zoho サービスで完了させたい設定やカスタマイズ、環境の整備など……各自で決めた目標達成に向け、How to get fields centered in a form?
Is it possible to center fields in a form? Some of my forms do some don't and it is really not aestheticly pleasing? Any help would be greatly appricated. Thanks, Michael McNeillMake Packages from multiple sales order of a single customer
Our customers sends orders to us very frequently, some times what customer wants is to ship items from 5 to 6 sales orders in a single shipment. it will be very nice if, zoho can implement this function, in which we can select items from other sales orders of the customer.Webhooks and Integration
Hey, I was looking to create automation using webhooks or something equivalent of a trigger based mechanism, to connect it as an integration. But I don't find any relevant APIs to setup these webhooks/notifcations for the "Zoho Books". Can anyone pleaseZoho Books X Zoho Expense
Hello there, Please can you tell me if it is possible to sync from Books to Expense? I much prefer the Expense reports to that of Books and the Credit Card feeds work via expense and not Books for me. However I find books is much better to deal with theABILITY TO LOG INTO CUSTOMER PORTAL
I think it would be very helpful to have a button in Zoho Books to be able to see the customer portal so we can see what they see to help them navigate through the portal. Many times, the customer will call about the portal, but without visibility intoSort, filter & save views for BOOKS PROJECTS
Thanks for all the updates. Our firm uses the module for simple internal project accountancy. This means we do everything from the Projects Section but this isn't user friendly at all. You can't do anything with customized your own fields which basicallyedit input format in custom field - sales order
hi, I want to integrate a custom field (multi line text box) in our sales order. It needs to show upper case and lower case letters, numbers, spaces, hyphens and "/". What do I need to put in the custom format to configure these signs? Thanks, TinaThis transaction type cannot be matched with a line on the statement.
When using the books API https://www.zohoapis.com/books/v3/banktransactions/uncategorized/${transaction.transaction_id}/match I get this error "This transaction type cannot be matched with a line on the statement." What I'm doing is for the uncategorizedFull Text Customization & Translation in SalesIQ Chat Widget Settings
Dear Zoho SalesIQ Team, Greetings, We would like to request an important enhancement to the chat widget customization options in Zoho SalesIQ. Current Limitation: At the moment, only some of the text shown in the chat widget is editable or translatablePower of Automation :: Quick way to associate your Projects with Zoho CRM
A custom function is a software code that can be used to automate a process and this allows you to automate a notification, call a webhook, or perform logic immediately after a workflow rule is triggered. This feature helps to automate complex tasks andTimesheets
I wanted to create the timesheets remainder for our team mates who miss out the weekly timesheet entries. While creating the email templates, I couldn't see anything related to timesheets. Since it shows projects Can you help me find and build a oneNext Page