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

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

                                                                                                                • Cannot connect IMAP to outlook

                                                                                                                  Hello I have followed the instructions to connect my zoho account to Outlook IMAP but get this message: Session Id: bba118fb-151c-824f-9512-3ad1e91b109d Timestamp: 1708976566964 Error code: INVALIDCREDENTIALS INTERACTIONREQUIRED I'm using the exact configeration
                                                                                                                • Department Overview by Modified Time

                                                                                                                  We are trying to create visuals to show the work our agents do in Zoho Desk. Using Zoho Analytics how can we create a Department Overview per modified time and not ticket created time? In order for us to get an accurate view of the work our agents are
                                                                                                                • Where is the settings option in zoho writer?

                                                                                                                  hi, my zoho writer on windows has menu fonts too large. where do i find the settings to change this option? my screen resolution is correct and other apps/softwares in windows have no issues. regards
                                                                                                                • Enhance Sign CRM integration

                                                                                                                  Hello all, I'm working on a custom Deluge script to enhance the integration between Zoho CRM and Sign by using a writer merge template for additional flexibility. I want to replicate the post-sign document integration that exists between CRM and Sign
                                                                                                                • Zoho Workdrive download was block by security software

                                                                                                                  Hi Team, Recently workdrive download was blocked by huorong security. Could you please advise how to put zoho workdrive as white list? every time we put "*.zohoexternal.com" or "workdrive.zohoexternal.com", the warning msg will still pop in next dow
                                                                                                                • Choosing a portal option and the "Unified customer portal"?

                                                                                                                  I am trialling Zoho to replace various existing systems, one of which is a customer portal. Our portal allows clients to add and edit bookings, complete forms, manage their subscriptions and edit some CRM info. I am trying to understand how I might best
                                                                                                                • General feedback

                                                                                                                  I think Zoho is at the moment (potentially) the best, or perhaps the only, real online solution, for business, and not just business. Surely the only one that has all the features that I need (and I've probably tried everything, at least all that has a cost-free option). It has still got lots of bugs and imperfect features, so I do hope it keeps developing and becomes a really professional platform. Lots of people (including me) want to use such one platform for all scheduling/mail/note-taking...
                                                                                                                • How to add SSL to Short URL custom domain?

                                                                                                                  Hi, I've added a custom domain the the URL Shortener Domains. It's creating the short URL fine, but when clicking through, firstly I get an SSL warning, then a 400 Bad Request warning.
                                                                                                                • Single Portal for Multiple Apps

                                                                                                                  Hello, I'm just getting started with Zoho and I'm very overwhelmed. I am currently using the free trial of Zoho One, but if I can figure it out, I intend to upgrade to the paid version. Zoho One, of course, gives me  access to an entire suite of services/applications. One of the things I'd like to do is have a single place for clients (customers?) to log in and view current projects, invoices, contact information, etc. A single login for my clients. A single portal. I've come across documentation
                                                                                                                • Pivot Report Formula - using a today() variable

                                                                                                                  Is it possible for me to use a value of today() in a formula on a pivot table? I'm trying to identify where the end date of a project is greater than the current date if("10. Projects (Zoho Projects).End Date" > today(), 'Yes', 'No') I get the error that
                                                                                                                • Antispam validation failed for your domain in Accounts

                                                                                                                  I tried adding a domain to zeptomail.zoho.com, but the “add domain” operation failed. The front‑end error reads: “Domain could not be added. Please contact support@zeptomail.com.” The back‑end API returned: ``` { "error": { "code": "TM_3601", "details":
                                                                                                                • Define your custom business logic in Zoho Projects

                                                                                                                  Every organization has a defined way of executing projects. There are clear expectations around how tasks should move, when projects should progress, and which actions require validation. When these rules are consistently followed, projects remain structured
                                                                                                                • Cancelled appointments still block out timeslot

                                                                                                                  I haven't had to test this before, but I've just found a problem. I had an appointment in a certain timeslot, and that appointment was cancelled. However, Bookings won't let another appointment be booked in that slot - it makes that time unavailable until
                                                                                                                • Preventing Group Emails From Being Sent to Group Member Personal Mail

                                                                                                                  We have a group setup for a public facing email address. We have streams turned on for this group. Right now when an email is sent to this group email it hits the group stream and also sends a copy of the email to all group members. We'd like to disable
                                                                                                                • Unusual activity detected from this IP. Please try again after some time.

                                                                                                                  Hello Zoho admin and IT team We are a registered website in Eloctronic services and we been trying to add our users to the zoho system but this issue faced us ,, hope you unlocked us please.
                                                                                                                • On Edit Validation Blueprint

                                                                                                                  Hello, I have a notes field and a signature field. When the Approve button is clicked, the Signature field will appear and must be filled in. When the Reject button is clicked, the Notes field will appear and must be filled in. Question: Blueprint will
                                                                                                                • ¿Puedo migrar mi sitio desde WordPress a Zoho? ¿Zoho admite herramientas con código personalizado?

                                                                                                                  ¡Hola comunidad! Estoy evaluando la posibilidad de migrar mi sitio web https://calculadoradenotas.cl/ desde WordPress a una solución Zoho, y tengo algunas dudas técnicas que espero puedan aclararme. Mi sitio no es solo informativo: es una herramienta
                                                                                                                • How do I link my invoice to an estimate?

                                                                                                                  There has been instances where I have created estimates, however, invoices for the same estimate were created independently. The status of these estimates hasn't converted to 'invoiced'. 
                                                                                                                • Zoho Books (and other finance suite apps) - Retrospective Linking of Invoice and Sales Orders to Quotes.

                                                                                                                  In some cases, Quotes and Invoies may be created sperately instead of using the convert feature. In this feature request I am asking for the Finance Suite team to consider adding a lookup field to reference the quote on Invoices and Sales Orders, or some
                                                                                                                • Impossible to import Journal from Freshbooks

                                                                                                                  I have been trying to import journals from Freshbooks since August 30th. Every time I try to import, I get an error message. I have already made sure every row has a date. First it was saying the account and notes had unexpected input and that every debit/credit
                                                                                                                • Zoho Payroll's USA and KSA editions are available in Zoho One!

                                                                                                                  Greetings! We’re excited to share that Zoho Payroll, currently available only in India and the UAE, is now introducing the KSA (Kingdom of Saudi Arabia) edition and the USA (United States of America) edition, and these editions are now available in Zoho
                                                                                                                • Peppol: Accept Bill (Belgium)

                                                                                                                  Hi, This topic might help you if you're facing the same in Belgium. We are facing an issue while accepting a supplier bill received by Peppol in Zoho Books. There is a popup with an error message: This bill acceptance could not be completed, so it was
                                                                                                                • CRM x WorkDrive: We're rolling out the WorkDrive-powered file storage experience for existing users

                                                                                                                  Release plan: Gradual rollout to customers without file storage add-ons, in this order: 1. Standalone CRM 2. CRM Plus and Zoho One DCs: All | Editions: All Available now for: - Standalone CRM accounts in Free and Standard editions without file storage
                                                                                                                • Manage Every Customer Conversation from Every Channel inside Zoho SalesIQ

                                                                                                                  Your customers message you from everywhere. But are you really able to track, manage, and follow through on every conversation, without missing anything? With interactions coming in from websites, mobile apps, and messaging platforms like WhatsApp and
                                                                                                                • Subheaders for Sections in forms

                                                                                                                  Currently, every form section has a field name, which one can choose to show/hide to the end user. It would be great if there was an option to show a SUB-HEADER in addition to a header. It would be useful for explaining to the end user what the section
                                                                                                                • Convert invoice from zoho to xml with all details

                                                                                                                  How to convert an Invoice to XML format with all details
                                                                                                                • Prevent subform editing on a module's detail's page

                                                                                                                  Hi everyone, We would like to prevent any editing of the subform data in the : Create page Edit page Details page (as subform editing is now allowed by the recent UX update) We are able to prevent editing by making the subform fields read only in the
                                                                                                                • Export Invoices to XML file

                                                                                                                  Namaste! ZOHO suite of Apps is awesome and we as Partner, would like to use and implement the app´s from the Financial suite like ZOHO Invoice, but, in Portugal, we can only use certified Invoice Software and for this reason, we need to develop/customize on top of ZOHO Invoice to create an XML file with specific information and after this, go to the government and certified the software. As soon as we have for example, ZOHO CRM integrated with ZOHO Invoice up and running, our business opportunities
                                                                                                                • Refresh frequency

                                                                                                                  Dear Zoho Team, I really, truly appreciate that Zoho Books gets frequent updates. As a matter of fact this is how a good SaaS company should stay on top. However, I feel that I have to hit refresh almost every day. This was exciting at the beginning but
                                                                                                                • Zoho Books | Product updates | January 2026

                                                                                                                  Hello users, We’ve rolled out new features and enhancements in Zoho Books. From e-filing Form 1099 directly with the IRS to corporation tax support, explore the updates designed to enhance your bookkeeping experience. E-File Form 1099 Directly With the
                                                                                                                • Weekly Tips : Save Time with Saved Search

                                                                                                                  Let's assume your work requires you to regularly check emails from important clients that have attachments and were sent within a specific time period. Instead of entering the same conditions every time—like sender, date range, and attachments included—you
                                                                                                                • Bring real app analytics into Zoho Creator apps with Zoho Apptics

                                                                                                                  We’re kicking off the year with a release we’ve been looking forward to for a long time. After being in the works for a while, Zoho Creator and Zoho Apptics are now officially integrated, bringing in-depth product analytics directly into the Zoho Creator
                                                                                                                • Discontinuing Zoho Showtime service on May 30, 2026

                                                                                                                  Hello everyone, As a follow-up to our earlier announcement, we’d like to share an important update regarding Zoho ShowTime’s discontinuation timeline. Zoho ShowTime, our online training platform, reached its end of life on December 31, 2025, and its services
                                                                                                                • emailing estimates

                                                                                                                  Shows up in the customer mail logs as sent but nobody is receiving them, even when I send them to myself I don't get them ??? Something wrong with the mail server or my end ?
                                                                                                                • Ability to CC on a mass email

                                                                                                                  Ability to CC someone on a mass email.
                                                                                                                • No background for video recordings, no playback speed, can't even playback longer recordings - have to download…

                                                                                                                  Hi. We utilize heavily video messages on Slack, but wanted to migrate to Cliq with Zoho One, however very basic yet very frequently used feature is missing: backgrounds for video recordings and playback speed. We were not happy with Slack's 5 minute limits
                                                                                                                • Bookings duration - days

                                                                                                                  Hi team, Is there any way to setup services/bookings that span multiple days? I am using Zoho Bookings for meeting room bookings. Clients may wish to book a room for more than one day, for up to a month.  If not, is there a plan to allow services to be setup with durations of Days as well as hours and minutes? Many thanks, Anna.
                                                                                                                • Customer address in Zoho Bookings

                                                                                                                  Hello,  Is it possible to add customer address information to the Zoho bookings appointment screen? Or have it pull that information automatically from the CRM? We are wanting to use this as a field management software but it is difficult to pull the address from multiple sources when it would be ideal to have a clickable address on the appointment screen that opens up the user's maps.  It would also be advantageous for the "list view" to show appointment times instead of just duration and booking
                                                                                                                • Organize and manage PDFs with Zoho PDF Editor's dashboard

                                                                                                                  Hello users, Zoho PDF Editor's dashboard is a one-stop place to upload, sort, share PDF files, and more. This article will explore the various capabilities that Zoho PDF Editor's dashboard offers. A few highlights of Zoho PDF Editor's dashboard: Upload
                                                                                                                • Feature Request - Allow Customers To Pick Meeting Duration

                                                                                                                  Hi Bookings Team, It would be great if there was an option to allow customers to pick a duration based on a max and minimum amount of time defined by me and in increments defined by me. For example, I have some slots which are available for customers
                                                                                                                • Next Page