Tips to build a powerful custom Widget using SalesIQ Scripts

Tips to build a powerful custom Widget using SalesIQ Scripts

Hi everyone! Great to see you. 

In our earlier posts, we discussed SalesIQ's built-in widgets and how to build real-time custom widget for e-commerce businesses. Today, we are going to discuss tips for building an effective custom widgets. As we know, widgets are highly customizable and support various visual and textual elements to make the data more actionable. They are comprised of different sections and responses to meet countless requirements. Let's learn the best hacks and tips to build a powerful widget using SalesIQ Scripts. 

Tip #1 - Select the appropriate sections:

The first step in building a custom widget is planning layouts by choosing the necessary sections to display the data/information. A section is a structure of widgets with data, titles, and buttons to perform different actions. There are totally six unique sections, 
  • Info - To display lengthy information like descriptions, etc.
  • Listing - To display a list of records like listing the associated desk tickets with the visitor.
  • Fieldset - To display short details like name, email, age, etc.
  • Metric - To display statistics, up to 3 values are allowed.
  • Profile - An layout to display the details of a company or a person
  • Empty section - To indicate operators or use when there is no data to display. 

Using sections, you can create a layout for your own widget as per your requirements and needs.    
 
Tip #2 - Third-Party integration:

The prime functionality of the custom widget is fetching data back and forth from other applications to view all the necessary information in one place. To achieve this, connect your widget to other applications using the Connection interface, eliminating the need to maintain the tokens. 
  • There are numerous pre-built connections available under default service, 
  •  You can also create a custom connection for other applications. 

Tip #3 - Equip the widget with the relevant response:

Generally, widgets help to fetch data from the external application and display it on the operator dashboard. However, widgets allow performing various actions using those data. For example, having a widget to display the customer's recent order history will be helpful in an E-commerce business. Instead of just displaying the order history, widgets can perform actions like cancelling an order, upgrading/downgrading the customer's membership, and more. 
 
Therefore, whenever an operator performs an action such as clicking a button, a response is triggered. These responses include navigation, posting a message to the visitor, embedding forms, etc to make the data more actionable. There are seven different types of responses available. 
 
1. Section_navigate - To navigate different sections in the widget to find get details.

Here, the operator can click on the listed order item to get more information about it. 

2. Sections_edit - To edit/update an existing section in the widget after performing an action.

To cancel an order, click on the "Cancel order" button, and the status will change from "Shipped" to "Cancelled."

3. Banner - To display success or failure banner after performing an action to indicate the result to the operator. 

Here, the operator is performing an action to cancel the order by clicking on the "Cancel order" button. Then the widget displays a success banner to indicate the order has been cancelled. 
 
4. Widget_detail - Align and sequence the whole layouts of the widget.

The widget's whole layout will be defined in the widget_detail. Here, the widget is comprised of four sections, metric, fieldset, listing, and empty section. 
 
5. Form - To embed the form inside the widget to perform more additional actions based on the visitor's requirements.
 
To enhance more actions, forms can be embedded in the widget. Here, to upgrade/downgrade visitors' membership, we have a form to update it. 
 
6. Widget_modification - To edit/update the contents in multiple sections after performing.
 
Here, when a return request is added by clicking on the "Add request" button (Empty Section), the widget will be modified and displays the returned order item (Listing Section). 
 
7. Post_message - Post a custom message to the visitor while performing an action.

A custom message can be set up on a widget that can be used when required. Here, while cancelling an order as per the visitor's request, a custom message with the order item name is shared with the visitor instead of the operator manually typing it. 

We hope these tips will help you build an effective widget and boost your operator's productivity. For additional information, visit our help guide. And let us know your favourite section and response type of widget in the comment section. 

Related Links:
Regards,
Sasidar Thandapani

    Access your files securely from anywhere


                  Zoho FSM Video Tutorials


                        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





                                                                              Manage your brands on social media



                                                                                    Zoho TeamInbox Resources



                                                                                        Zoho CRM Plus Resources

                                                                                          Zoho Books Resources


                                                                                            Zoho Billing 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

                                                                                                                                  • Hiding old CRM Contacts in Desk

                                                                                                                                    I have an issue with contacts in Desk.   We sync contacts from CRM with DESK and we have old contacts, eg staff members that have left businesses.  The issue is when adding a ticket (most of our tickets are raised over the phone), staff sometimes pick
                                                                                                                                  • Action Request - Zia Agents - Get Agent API

                                                                                                                                    It would be great if there was a "Fetch Agent" action for Zia Agents. The main use case here is getting the latest version of the Agent to populate the "Trigger Agent Execution" action. That action requires one to specify which version of the Agent is
                                                                                                                                  • WhatsApp Business Calling API

                                                                                                                                    Dear Zoho SalesIQ Team, I would like to request a feature that allows users to call WhatsApp numbers directly via Zoho SalesIQ. This integration would enable sending and receiving calls to and from WhatsApp numbers over the internet, without the need
                                                                                                                                  • Calendar Reminders unavailable

                                                                                                                                    For some received meeting invitations, Zoho Calendar’s web interface provides no option to add or edit a reminder. However, I can add a reminder to the same event through the phone app. That reminder then appears in the browser, but still cannot be edited
                                                                                                                                  • Zoho Desk MCP doesn't expose all functions

                                                                                                                                    Hello, I'd like to be able to draft (rather than send) ticket replies using Claude Cowork. However, the Zoho Desk MCP doesn't currently offer that, despite it being available in the API (https://desk.zoho.com/DeskAPIDocument#Threads#Threads_DraftEmailReply).
                                                                                                                                  • Email-Data Synchronization with Zoho Analytics

                                                                                                                                    Hello, Enterprise Support Community! We're excited to announce the availability of Email Data Synchronization with Zoho Analytics! This highly requested enhancement allows you to sync email data from Zoho CRM into Zoho Analytics, making it easier to analyze
                                                                                                                                  • Keeping phone number text format exporting from Books to Sheet

                                                                                                                                    We have a custom function that copies data from our customers in Books to Sheets. In the process the customers' phone numbers (unless they contain a space) get treated as numeric values, so leading zeros get stripped off, and in some cases scientific
                                                                                                                                  • #22 I Sent It to the Wrong Person

                                                                                                                                    Meera was sending an invoice to a client when she mistyped the email address. She noticed the mistake a week later, when the payment had not come in. She corrected the email address on the customer record and waited for the payment to arrive. But nothing
                                                                                                                                  • New Search Function

                                                                                                                                    Hey Team, The search function updated in our CRM about a week ago, so I assume it was an automated update across Zoho. It no longer displays leads/deals etc in Chronological order so that the most recently created or updated is the first to display which
                                                                                                                                  • Build a historical inventory snapshot in Google BigQuery using Zoho DataPrep

                                                                                                                                    Businesses using Zoho Inventory may want to transfer their inventory data to Google BigQuery to maintain an up-to-date data warehouse. While scheduled pipelines help keep BigQuery updated with the latest inventory data, businesses that also need to track
                                                                                                                                  • Zoho writer tabs

                                                                                                                                    I'm trying to post a list of actions for my team to share online. For this I need to set tabs -- can't find a way of setting tabs anywhere. Would prefer not to go to the formality of a table. Can anyone tell me how to set tabs? greigg
                                                                                                                                  • Ability to Set Text Direction for Individual Cells in Zoho Sheet

                                                                                                                                    Dear Zoho Sheet Team, We hope you are doing well. We would like to request an enhancement in Zoho Sheet that allows users to set the text direction (right-to-left or left-to-right) for individual cells, similar to what is available in Google Sheets. Use
                                                                                                                                  • Keep Zoho Books data in sync with Google BigQuery

                                                                                                                                    Businesses using Zoho Books may need to transfer their financial data to a data warehouse like Google BigQuery for reporting and analysis. Zoho DataPrep helps automate this process by preparing Zoho Books data and syncing it with BigQuery at scheduled
                                                                                                                                  • What's New - October 2026 | Zoho Backstage

                                                                                                                                    Hello everyone, The last few months of the year are usually the busiest for events, with more people to reach and more details to manage. This month, we’ve made a few changes that should save you some time and back-and-forth along the way. Here’s what’s
                                                                                                                                  • Introducing user-based authentication across Zoho CRM

                                                                                                                                    We have introduced two enhancements to simplify authentication and enable user-specific access when working with Connections and executing CRM operations across different developer tools. 1. Enable user-based authentication for Connections Connections
                                                                                                                                  • Set connection link name from variable in invokeurl

                                                                                                                                    Hi, guys. How to set in parameter "connection" a variable, instead of a string. connectionLinkName = manager.get('connectionLinkName').toString(); response = invokeurl [ url :"https://www.googleapis.com/calendar/v3/freeBusy" type :POST parameters:requestParams.toString()
                                                                                                                                  • Allow Multiple usage units to items while adding them to sales/purchase transactions

                                                                                                                                    The usage unit of items added in zoho books are static right now and can not be changed. But certain items are received or sold in multiple usage units. One example is fabric. It can be bought in Meters, inches, kgs or other units. Another example would
                                                                                                                                  • Zoho Inventory – Stock Allocation and Warehouse ManagementAs we implement Zoho One in our organization, we are currently facing a challenge with stock allocation and warehouse management. While the wa

                                                                                                                                    As we implement Zoho One in our organization, we are currently facing a challenge with stock allocation and warehouse management. While the warehouse management part can be handled in Zoho Inventory, our main requirement is the customer-wise stock allocation
                                                                                                                                  • How to restore deleted campaigns?

                                                                                                                                    I accidentally deleted my first campaign that went out today (08/21/18). How do I restore it?
                                                                                                                                  • Using IMAP configuration for shared email inboxes

                                                                                                                                    Our customer service team utilizes shared email boxes to allow multiple people to view and handle incoming customer requests. For example, the customer sends an email to info@xxxx.com and multiple people can view it and handle the request. How can I configure
                                                                                                                                  • New in Cadences: Option to Resume or Restart follow-ups when re-enrolling records into a Cadence, and specify custom un-enrollment criteria

                                                                                                                                    Managing follow-ups effectively involves understanding the appropriate timing for reaching out, as well as knowing when to take a break and resume later, or deciding if it's necessary to start the follow-up process anew. With two significant enhancements
                                                                                                                                  • Automatic Invoice Number generation for createRecord

                                                                                                                                    Hello, while testing some custom Buttons in my Zoho Books application, I noticed that I get an error that previously did not occur. After some further digging I found that the automatic transaction numbering of invoices no longer work in my organization.
                                                                                                                                  • Stop completed task lists from disappearing?

                                                                                                                                    Is there any way to stop projects from making tasks lists disappear when all the tasks in the list are completed? That's one of those little things where we're constantly fighting the product. For instance we have some projects which are ongoing - no start and end date. We use Kanban view to show the various task lists. We don't want the kanban list to disappear every time the items on it happen to be closed out. Thanks
                                                                                                                                  • Approval Processes, Now in Standard and Professional

                                                                                                                                    We encourage existing Approval Process users to switch to the new UI to access enhanced capabilities, including naming each rule and stage, setting stage-specific field updates and tasks, sending email notifications upon rejection, and tracking progress
                                                                                                                                  • Zoho Inventory - Backorder Report

                                                                                                                                    I am requesting a backorder report in Zoho Inventory to show all backorders by Sales Order and/or Customer, including the quantity of each line item ordered and quantity fulfilled. This is important for businesses who operate a lean business model and
                                                                                                                                  • Can we do Image swatches for color variants?

                                                                                                                                    We want to do something like the attached screenshot on our new zoho store. We need image swatches instead of normal text selection. We want to user to select an image as color option. Is this doable? I don't see any option on zoho backend. Please h
                                                                                                                                  • Email-Data Synchronization with Zoho Analytics

                                                                                                                                    Hello everyone, Thanks to Chad and everyone who shared their feedback. We're excited to announce support for email data synchronization with Zoho Analytics. We have been working hard to bring this highly requested feature to life, and we'd like to walk
                                                                                                                                  • Update on Using Extensions in Custom Modules

                                                                                                                                    Extensions in Zoho Projects now support custom modules. You can add extensions to custom module records and configure where each extension appears and who can access it during installation. Supported Extensions: Checklist, Google Drive, SharePoint Configure
                                                                                                                                  • 【初開催】Zoho Mail / Workplace 活用勉強会 |11/27オンライン・無料

                                                                                                                                    ユーザーの皆さま、こんにちは。 ゾーホージャパンの中野です。 11月27日(金)、Zohoコミュニティでは初めてとなる「Zoho Mail / Workplace 活用勉強会」をオンラインで開催します! すでにZoho Mail / Workplaceをご利用中の方はもちろん、Zoho Oneをご利用中で、Zoho Mailの利用を検討している方も歓迎です。 Zoho社員が製品の概要に触れながら、具体的な利用場面に沿って活用方法をご紹介します。 ■ メール対応のミスや手間を減らす 添付忘れや誤送信の対策など、日々のメール業務に役立つ便利機能を取り上げます。
                                                                                                                                  • Trigger a Workflow Function if an Attachment (Related List) has been added

                                                                                                                                    Hello, I have a Case Module with a related list which is Attachment. I want to trigger a workflow if I added an attachment. I've seen some topics about this in zoho community that was posted few months ago and based on the answers, there is no trigger
                                                                                                                                  • Breaking Change Announcement: Users API Response Restricted for Client Portal Users

                                                                                                                                    Hi all, We are introducing a breaking change to the Users API when it is accessed by Client Portal users. Status: Live This change is now live in production. Please review your integrations and make the necessary updates. Affected endpoints: GET /users
                                                                                                                                  • automatic email reminder

                                                                                                                                    in need of an email reminder to participants having trained for a course but have not paid
                                                                                                                                  • Sharedmail box access via an api

                                                                                                                                    Hi, I am trying to access a sharedmailbox via an API. I am the moderator and creator of this shared mailbox. I have created a self client but when when i try to get list of all emails, it does not list the sharedmailbox. Help me to resolve this or provide
                                                                                                                                  • Duplicate Record Creation

                                                                                                                                    Hello Team, I would like to check whether there are any options available in Zoho FSM to prevent duplicate record creation in the following modules: Assets Companies Contacts Ideally, we would like the system to check for existing records before allowing
                                                                                                                                  • CC'd User Receiving Both Regular Email Chain Response & Reply Notification

                                                                                                                                    Hi, I am trying to set up the notifications for users and I'm a bit confused. I'm testing with personal accounts and my Desk agent, and I'm noticing that CC'd users are receiving both the regular email chain that the requester (contact) receives, but
                                                                                                                                  • Default View for Email Sent

                                                                                                                                    Hi, can the default view for email sent to candidates be "ALL" instead of the current user? I have to click the dropdown menu every time so that I can see if other recruiters have already sent an email to a candidate.  Thanks!
                                                                                                                                  • KB Articles - Can't See Content or Trigger Immediate Sync

                                                                                                                                    Once a file has been submitted to the KB, there's no way to check what it actually contains. There's also no way to force an immediate sync with the source document. These are issues when one is developing and testing an agent. It makes troubleshooting
                                                                                                                                  • Enable Screen Recording in Zoho WorkDrive Mobile Apps (Android & iOS)

                                                                                                                                    Hi Zoho WorkDrive Team, How are you? We are enthusiastic Zoho One users and rely heavily on Zoho WorkDrive for internal collaboration and content sharing. The screen-recording feature in the WorkDrive web app (similar to Loom) is extremely useful- however,
                                                                                                                                  • Add Comprehensive Accessibility Features to Zoho Writer

                                                                                                                                    Hello Zoho Writer Team, We hope you are doing well. We would like to submit a feature request to enhance Zoho Writer with a full set of accessibility tools, similar to the accessibility options already available in the Zoho Desk agent interface. 🚧 Current
                                                                                                                                  • Problem with currency field in Zoho CRM

                                                                                                                                    Hi Guys Zoho Books has a feature in currency fields that automatically converts decimal numbers with commas ( , ) to period format ( . ) when pasting them. For example: R$ 2,50 --> R$ 2.50 Is this behavior available in Zoho CRM? I couldn't find any configuration
                                                                                                                                  • Next Page