Automation#32:Auto Add New Portal Users to the Help Center User Groups

Automation#32:Auto Add New Portal Users to the Help Center User Groups

Hello Everyone,
Introducing a custom function that automates the process of adding new portal users to Help Center user groups, making user management effortless!
By default, Zoho Desk allows you to assign new portal users to groups manually. But with this custom function, the process is completely automated, ensuring seamless categorization.


Why User Groups?

Zylker Techfix was dedicated to helping customers through their Help Center. While they actively supported users, there was one challenge: everyone received the announcements, irrespective of their requirements.
Zylker Techfix wanted a smarter way to engage their users by sending targeted announcements based on individual interests, such as gadgets, office equipment, and operations.
To make this happen, they created user groups and assigned new users accordingly. But manually adding users to the right groups was time-consuming.
So, they automated the process! With a custom function, they streamlined operations, ensuring every new portal user was automatically assigned to the right Help Center user group. More relevance, better engagement, zero manual effort.
Let’s walk through the steps to incorporate this custom function into your workflow.

Prerequisites

1. Create a connection
  1.1 Go to Setup(S) and choose Connections under Developer Space.
  1.2 Click Create Connection.
  1.3 Select Zoho Desk under Default Services.
  1.4 Set the connection name as zohodesk.
  1.5 Disable the toggle for User Credentials of Login User. 
  1.6 Under Scope, choose the below scope values:
Desk.contacts.READ
Desk.contacts.UPDATE
  1.7 Click Create and Connect.
  1.8 Click Connect and click Accept.
Connection is created successfully.

Create a Workflow Rule

1. Go to Setup, choose Workflows under Automation. 
2. Under Workflows, click Create Rule.

In the Basic Information section,
3. Select Contacts from the drop-down menu under Module.
4. Enter a Rule Name and Description for the rule.
5. If you want to activate the rule right away, select the Active checkbox. Else, create the rule and activate it later.
6. Click Next

In the Execute on section, follow these steps:
7. Select Field Update. Select field isPortalUser. 
8. Click Next.
9. In the Criteria section, add isPortalUser is and select the checkbox. click Next. 
10. In the Actions section, click the + icon and select New next to Custom Functions.
11. Enter a Name and Description for the custom function. Choose Contacts under Module.
12. Under Argument Mapping, give a desired Method Name. Map the arguments as below:
      12.1 In the Argument Name field, type contactId and select Contact ID under the Contacts Section.
13. In the script window, insert the Custom Function given below:
  1. // ---------------User inputs------------------------------------------
  2. deskUrl = "https://desk.zoho.com/api/v1/"; // replace based on user dc
  3. groupId = "<<GROUP ID>>"; // replace the group id in your desk portal
  4. //---------------------------------
  5. logs = Map();
  6. try 
  7. {
  8. getContactStatus = invokeurl
  9. [
  10. url :deskUrl + "contacts/" + contactId + "/helpCenters"
  11. type :GET
  12. connection:"zohodesk"
  13. ];
  14. contactUserId = getContactStatus.get("data").get(0).get("userId");
  15. if(contactUserId != null)
  16. {
  17. addUserToGroup = invokeurl
  18. [
  19. url : deskUrl + "groups/" + groupId + "/users/add"
  20. type :POST
  21. parameters:"" + {"users":{{"id":contactUserId}}}
  22. headers:{"Content-Type":"application/json"}
  23. detailed:true
  24. connection:"zohodesk"
  25. ];
  26. info "addUserToGroup" + addUserToGroup;
  27. }
  28. }
  29. catch (errorInfo)
  30. {
  31. logs.insert("errorInfo":errorInfo);
  32. }
  33. info "logs: \n" + logs;
  34. if(logs.containKey("errorInfo"))
  35. {
  36. throws "Error happen in the CF execution";
  37. }
User Inputs
a. In Line 2, replace .com in the URL based on your DC. 
b. In Line 3, enter the group ID to which you would like to add your new portal users. To access group ID, go to Setup >> Help Center >> Select the Department having your preferred User group >> choose User Groups on the left panel >> Select the user group >> The Id in the address bar is the required Group ID. 
Notes
Note: Configure the Workflow for the contacts module in the respective department where you want to add portal users to be added to the User group. 
14. Click Save to save the custom function.
15. Click Save again to save the workflow.

Share with us how this custom function helps you in your operations! Drop a comment below or reach out to us at support@zohodesk.com, we’re just an email away!

Meet you in the next post!
Regards,
Lydia | Zoho Desk

    Access your files securely from anywhere

        All-in-one knowledge management and training platform for your employees and customers.







                              Zoho Developer Community




                                                    • Desk Community Learning Series


                                                    • Digest


                                                    • Functions


                                                    • Meetups


                                                    • Kbase


                                                    • Resources


                                                    • Glossary


                                                    • Desk Marketplace


                                                    • MVP Corner


                                                    • Word of the Day


                                                    • Ask the Experts



                                                              • Sticky Posts

                                                              • Register for Zoho Desk Beta Community

                                                                With the start of the year, we have decided to take a small step in making the life of our customers a little easier. We now have easy access to all our upcoming features and a faster way to request for beta access. We open betas for some of our features
                                                              • Share your Zoho Desk story with us!

                                                                Tell us how you use Zoho Desk for your business and inspire others with your story. Be it a simple workflow rule that helps you navigate complex processes or a macro that saves your team a lot of time; share it here and help the community learn and grow with shared knowledge. 
                                                              • Tip #1: Learn to pick the right channels

                                                                Mail, live chat, telephony, social media, web forms—there are so many support channels out there. Trying to pick the right channels to offer your customers can get pretty confusing. Emails are most useful when the customer wants to put things on record. However, escalated or complicated issues should not be resolved over email because it's slow and impersonal.  When you need immediate responses, live chat is more suitable. It's also quick and convenient, so it's the go-to channel for small issues. 
                                                              • Welcome to Zoho Desk Community - Say hello here!

                                                                Hello everyone! Though we have been here for a while, it’s time to formally establish the Zoho Desk Community; we’re really happy to have you all here! This can be the place where you take a moment to introduce yourself to the rest of the community. We’d love to hear all about you, what you do, what company or industry you work for, how you use Zoho Desk and anything else that you will like to share! Here’s a little about me. I am Chinmayee. I have been associated with Zoho since 2014. I joined here
                                                              • Webinar 1: Blueprint for Customer Service

                                                                With the launch of a host of new features in Zoho Desk, we thought it’ll be great to have a few webinars to help our customers make the most of them. We’re starting off with our most talked about feature, Blueprint in Zoho Desk. You can register for the Blueprint webinar here: The webinar will be delivered by our in-house product experts. This is a good opportunity to ask questions to our experts and understand how Blueprint can help you automate your service processes. We look forward to seeing


                                                              Manage your brands on social media



                                                                    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

                                                                                        • CRM Community Learning Series

                                                                                          CRM Community Learning Series


                                                                                        • Kaizen

                                                                                          Kaizen

                                                                                        • Functions

                                                                                          Functions

                                                                                        • Meetups

                                                                                          Meetups

                                                                                        • Kbase

                                                                                          Kbase

                                                                                        • Resources

                                                                                          Resources

                                                                                        • Digest

                                                                                          Digest

                                                                                        • CRM Marketplace

                                                                                          CRM Marketplace

                                                                                        • MVP Corner

                                                                                          MVP Corner









                                                                                            Design. Discuss. Deliver.

                                                                                            Create visually engaging stories with Zoho Show.

                                                                                            Get Started Now


                                                                                              Zoho Show Resources

                                                                                                Zoho Writer

                                                                                                Get Started. Write Away!

                                                                                                Writer is a powerful online word processor, designed for collaborative work.

                                                                                                  Zoho CRM コンテンツ




                                                                                                    Nederlandse Hulpbronnen


                                                                                                        ご検討中の方




                                                                                                                • Recent Topics

                                                                                                                • Set File Upload fields as mandatory

                                                                                                                  Currently the CRM for some reason lacks the ability to set a file upload field as mandatory So we have an issue We have a requirement that before a Deal stage is set as Deal is Won the member needs to upload a file Now for some weird reason in Zoho I
                                                                                                                • Editing HTML in Zoho CRM Email Template

                                                                                                                  I am trying to create a template within the CRM email option, but need to be able to use custom HTML. There does not seem to be a way to do so.
                                                                                                                • How to make attachments mandatory

                                                                                                                  I want the user to be unable to mark an opportunity as Closed – Won if it doesn’t have any attachments. I’ve already tried client scripts and functions, but nothing worked.
                                                                                                                • SLA Ticket Report

                                                                                                                  From data to decisions: A deep dive into ticketing system reports Service level agreement (SLA) ticket reports in a help desk system are crucial for ensuring that services are delivered according to established commitments. They help maintain accountability
                                                                                                                • Zoho Backstage - PCI Compliance / Web Security

                                                                                                                  I have a couple of questions related to Backstage and payment processing.... 1. my purchasing division is not giving approval to use Backstage yet because of some security issues. In order for us to take payments via a payment gateway like Authorize.net
                                                                                                                • Zoho Tables August 2025 Update: Faster and Smoother

                                                                                                                  We’ve been working behind the scenes to make Zoho Tables faster, lighter, and more reliable. Here are the highlights: Faster Response Times Optimised the way responses are generated. Reduced memory consumption by 20–25%, leading to smoother performance
                                                                                                                • Video Upload from app says "unsupported aspect ratio" but is verified to be correct.

                                                                                                                  I and my social media person are experiencing a problem where Social will not accept video uploads to Instagram. The error we receive is "unsupported aspect ratio" but looking directly at the file in question we see that the width and ratio both match
                                                                                                                • Disposable Email Addresses

                                                                                                                  Dear zMail Team, Can you also bring out a few disposable email addresses for each accounts? That way occasional registrations and imminent spam from them can be largely solved right? ---- Deepak Vasudevan http://thamizhththendral.blogspot.com/
                                                                                                                • Zoho sheet - Zoho expense

                                                                                                                  I want to schedule to create an expense using Zoho Sheet and flow. That is the EMI that I pay on a particular date to the bank and should be itemised, like principal and interest on the loan. Can someone help me in this regard??
                                                                                                                • Ability to configure a schedule/shift for each user and/or crew in Zoho FSM

                                                                                                                  Hello, In our team of Field Agents, we have different shifts. Some field agent always work from 7:00 AM to 4:00 PM while others work the evening shift like 4:00 PM to 11:00 PM. Sometime shift are on weekdays only or on weekend. It would be great to be
                                                                                                                • Free webinar: Streamlining customer service paperwork with the Zoho Sign extension for Zoho Desk

                                                                                                                  Hello Everyone! Have you been wondering about bridging the gap between digitised customer service and business paperwork? Join our free webinar to learn how you can do this by connecting Zoho Sign, our digital signature app, with Zoho Desk, our online
                                                                                                                • Mail Search should allow grouping by conversation like Gmail.

                                                                                                                  Having switched from gmail I have found the search function hard to use. Mostly because mail is not grouped by conversation in search. If I search for a word when looking for a conversation had with someone then sometimes 10 emails will come up from the
                                                                                                                • Improve Zoho Learn updated article notifications

                                                                                                                  I noticed today while updating an article, that the notification users get says "[User Name] has published article [Article Name]..." My feedback to the product team is that it would be really helpful for an end user, if the system notification differentiated
                                                                                                                • Safari Support

                                                                                                                  Safari, the world's second largest browser, zoho desk does not officially or fully support. That needs to change.
                                                                                                                • Can I get images from an "Image Upload" field in a webhook?

                                                                                                                  I want to send images from 2 "image upload" fields via a webhook. Is this possible?
                                                                                                                • Ticket closure notification - all contacts cc'd on email thread

                                                                                                                  Hello, If a client sends an email to our service desk and cc's in other people that work at the same company - so that they are in the loop of the service request. When the we close the ticket, only the ticket owner (person who emailed us - which created
                                                                                                                • Inactive account cleanup policy for Zoho Sign

                                                                                                                  Zoho Sign reserves the right to delete accounts that are license free and inactive for more than 120 days. The account deletion will be initiated only after the user receives prior email notice about possible data deletion and how to backup the data.
                                                                                                                • Missde API documentation for Sales Receipt

                                                                                                                  Hi! I noticed that the Sales Receipt endpoint is not currently listed in your API documentation (https://www.zoho.com/books/api/v3/introduction/). Could you please provide any available temporary documentation for this endpoint, along with a detailed
                                                                                                                • Multi-currency in Zoho CRM Forecast and Reports

                                                                                                                  As a company we have branches in 4 different countries with as many different currencies. Our Sales Teams would like to work with their local currency as much as possible. The Forecast module using only 1 currency is practically usable only by the sales
                                                                                                                • How to select from pricebook when creating a salesorder or quote

                                                                                                                  I am creating a sales order and when selecting the Products I do not see any where to select from pricebooks. How do i associate this to my orders?
                                                                                                                • I cannot find my older documents from 2024 and 2023

                                                                                                                  I cannot find my older documents from 2024 and 2023.
                                                                                                                • Customising Help Center

                                                                                                                  Hi I don't think it is possible to add custom pages to help center? We'd like to use this as a customer portal with support tickets, FAQ/Guides, Billing and contracts. Is there any plans to add a feature like this or an alternative way to do it other
                                                                                                                • Ticket Approvals - External Users

                                                                                                                  The ticket approval option - we need to be able to select external users (Contacts) for approvals. Sometimes we are working with an end user and their boss needs to approve a purchase. For example, working with a cashier on a broken cash register and
                                                                                                                • Force Users to Ask Answer Bot a question... First

                                                                                                                  End users will always skip talking to a bot. It would be nice if Zoho adopted the standard and forced users to first ask a question to answer bot (or zia in some fashion) and then pass to the agent if it wasn't answered. Options to force the user to speak
                                                                                                                • View Answer Bot conversations?

                                                                                                                  We are trialing Zia and are experimenting with Answer Bot on our knowledge base. So far so good! Management asks me if it is possible to view Answer Bot conversations, the purpose being to look over its shoulder and confirm that it is working as des
                                                                                                                • Mass Email an Account

                                                                                                                  It would be nice to mass email an account stating there is an outage at their business or something specific to an account is needed to be mass communicated. Even if it makes a ticket for every Email Out to every contact in the Account. Think: the customer
                                                                                                                • Multiple Topics assigned to a single Campaign

                                                                                                                  Hello, is it possible to assign multiple Topics to a single Campaign? We frequently write a content to our subscribers that spans multiple Topics and we would like to send it to all Contacts that are subscribed to at least one of the Topics. But it looks
                                                                                                                • Zoho Projects Fonts and Accessibility missing

                                                                                                                  I cannot find any more the tab where I can change the font in Zoho Project. I also checked the knowledgebase and there they have accessibility tab which I am completely missing. Is there some setup I am missing or is it a problem with our account?
                                                                                                                • Zoho Books Custom Widgets Deprecation Error

                                                                                                                  I created a simple sample widget with zet and published it using sigma Both in the Sandbox and Production the Widgets are showing this error
                                                                                                                • Problems with PDF files in notebook

                                                                                                                  I'm evaluating Zoho Notebook as an alternative to Evernote and imported my Evernote account to Zoho Notebook. First issue is that notes in Evernote that comprise a PDF are turned into a 'group' with a single note page (that has the text from the Evernote
                                                                                                                • API (v3) Tasks sorting issue

                                                                                                                  We are using the v3 API for Projects. When we gat all tasks, per page of 100 tasks, we get the task info alright. But when we try to sort based on DESC(last_modified_time) we don't get the correct sort order. It is roughly sorted by the last_modified_time,
                                                                                                                • Assemblies make my stock go negative

                                                                                                                  I am sure this is just the way that we are using this feature, but we use assemblies, a lot. The issue for us is the way that the relive inventory and the fact that it makes our composite item stock go negative. I have added flows to auto assemble and
                                                                                                                • User Activity Reports

                                                                                                                  I'd like to get data related to user activity.  For example, Login and logout times, emails sent/received, new records created , etc. Is that currently available. I just can't seem to find anything . Thanks, Dave
                                                                                                                • Help: Populate “Contact Owner” details into Customer custom fields (for email templates) in Zoho Books

                                                                                                                  We want to send invoices on behalf of our sales agents, and include the agent’s name, email, and phone in the email body using placeholders. Plan is to copy the Customer Owner details into three Customer custom fields, so they can be used as placeholders
                                                                                                                • Undocumented Books API error message - 1000 - The requested action could not be completed. Please try again. | Unexpected error

                                                                                                                  This code sometimes throws this error 1000 - The requested action could not be completed. Please try again. | Unexpected error What does it mean? result = zoho.books.updateRecord("salesorders",organization.get("organization_id"),salesorder_id,sales_
                                                                                                                • Partial payments for retainer invoices

                                                                                                                  When a customer does not pay the entire retainer invoice there is no way to apply a partial payment. PLEASE add this function.
                                                                                                                • Mass Update not trigger workflows

                                                                                                                  Hi, I have performed a mass update of all records in a custom module using a custom view. I have a dummy checkbox on my module that I turn on or off - hoping to trigger all the new workflows that have been created for that module. However, no workflows
                                                                                                                • Multi-Select lookup field has reached its maximum??

                                                                                                                  Hi there, I want to create a multi-select lookup field in a module but I can't select the model I want the relationship to be with from the list. From the help page on this I see that you can only create a max of 2 relationships per module? Is that true?
                                                                                                                • Generating CRM reports based on date moved in staged history

                                                                                                                  Hi everyone, I'm trying to generate CRM reports of jobs (I think these are called usually deals) based on when they were moved to a particular stage, ie all jobs that were moved to Proposal/Quote in the previous financial year. I can see from other similar
                                                                                                                • Modules for missed calls, emails, texts etc

                                                                                                                  Hi there. Is there a way to create a module that would automatically show a list of all inbound calls that were missed by our users, as well as any inbound SMS's, emails & WhatsApp messages. That way, a user who is available, can work through that list
                                                                                                                • Next Page