WFH Tip: 24 Objects in the Zobot

WFH Tip: 24 Objects in the Zobot

Before you start building a Zobot for your business, you need to know about the objects that are available inside the Zobot. This tip aims to give you an idea of the core objects that are found throughout the custom bot implementation. These objects serve as a guideline for input parameters and output response formats for the scripts used in the bots. The following are the actions that can be performed by the Zobot:
  1. Handling visitor chats
  2. Forwarding chats to humans
  3. Blocking a visitor
  4. Collecting inputs via Calendar
  5. Multiple input collection for one response, etc.
So, we'll take a look at all of these object one by one.

Request:

‌The request object is a map that contains the details of a request. You can retrieve details such as 
  • the request ID that is unique to each action
  • the embed inside which the chat is going on
  • the OS and browser used by the visitor
  • the location of the visitor and
  • the IP address of the visitor.
Syntax:
  1. {
  2.   "id" : "4fhgtd-hbnjwj-hbewjd-gyywye6" ,
  3.   "app_id" : "800009278986899",
  4.   "os" : "Apple Macintosh",
  5.    "browser" :"Apple Safari" 
  6.     "ip" : "127.89.077.12",
  7.     "location" : {
  8.     "country" : "US",
  9.     "city": "Los Angeles",
  10.     "state": "California",
  11.     "lat" : "51.023",
  12.     "long" : "12.34"
  13.   }
  14. }

Visitor:

Then comes the visitor object which is a map that contains all of the profile information of the website visitor. Using this, you can get details like
  • Name, email, phone, browser, IP address of the visitor
  • URL of the page where the visitor is currently accessing
  • Title of the visitor's current website page
  • Count on number of past chats with the visitor
  • Source from where the visitor is referred from
  • Category and potential of the visitor in CRM and
  • Custom information about the visitor.

Attachment:

The attachment is a collection object, which contains the files and the respective details of the file that were shared by the visitor during the conversation, as a message. It contains attributes like:
  • The details of the visitor who has sent the file
  • The type of file
  • The JSON object containing details of the file shared
  • Time at which the file was shared in milliseconds and
  • The comment attached with the file
  • It also contains some file object properties like 
  • Size of the file
  • The name and type of the file that has been shared by the visitor.

Message:

Each text message in the conversation between the Zobot and the visitor will be considered as the message object. It has two major attributes.
  • text which is mandatory. This is the content of the conversation.
  • And meta which is not a mandatory attribute. These are the details of the visitor message such as card data, type, etc

Responses:

  • Then, finally, we have the response object. This contains the output responses given by the bot during the conversation. It has four attributes.
  • action - Action performed by the bot
  • replies - The replies given by the bot for the particular action
  • input - The input type displayed to the visitor by the Zobot
  • suggestions - The response suggestions given by the Zobot to the visitor. When a response contains both input and suggestions, the Zobot will consider only the input and ignore the suggestions. Any interaction can have one type of input - either an input widget or free form text supported by suggestions.Also, you need to remember that visitors cannot enter any text manually when suggestions are displayed in the chat widget.
Note: Out of these four attributes, action and replies are mandatory ones.

To learn more about using objects, start building your own Zobot right away.
We also have Sample Scripts that use all of the response types mentioned above. 
For more information, check out our Help Documentation.

Regards,
Michelle

    Access your files securely from anywhere






                    Zoho Campaigns Resources




                          Zoho Developer Community



                              Bootcamp
                              Community
                              Pricing
                              Webinars
                              What's New
                              Integrations
                              Contact Support
                              Contact Sales
                                Zoho Survey Resources
                                  Features
                                  Survey Templates
                                  Integrations
                                  Community
                                  iOS Mobile Surveys
                                  Pricing
                                  Android Mobile Surveys
                                  Insurvey Blogs
                                  Insight Blogs
                                  Tips & Tricks





                                              Latest Feature Updates

                                                • Desk Community Learning Series


                                                • Digest


                                                • Functions


                                                • Meetups


                                                • Kbase


                                                • Resources


                                                • Glossary


                                                • Desk Marketplace


                                                • MVP Corner


                                                • Word of the Day


                                                • Ask the Experts




                                                    Zoho SalesIQ Resources


                                                          Manage your brands on social media
                                                          Access Zoho Social

                                                            Zoho Pagesense Resources


                                                                Zoho TeamInbox Resources

                                                                  Zoho DataPrep 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 Writer

                                                                                            Get Started. Write Away!

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

                                                                                              Zoho CRM コンテンツ






                                                                                                Nederlandse Hulpbronnen


                                                                                                    ご検討中の方




                                                                                                          • Recent Topics

                                                                                                          • Edit item custom fields

                                                                                                            Getting this error : Transactions have been created with the custom field. Hence it cannot be deleted. Not trying to delete it, just trying to change which modules to show in or to not show at all in transactions !

                                                                                                          • Rendering PDF to view on page

                                                                                                            My company upload lots of PDF files onto Zoho. But every time we open it, it downloads the file instead of viewing it on the web page. Does Zoho allow uploaded PDF files to be rendered to view on web page yet? I've been trying to use <embed> or <object> but it cannot be loaded.  (similar thread: https://help.zoho.com/portal/community/topic/how-to-open-a-pdf-file-of-a-view-in-preview-mode)

                                                                                                          • Dynamically Fetching Lookup Field Display Value

                                                                                                            I have an audit trail form, Audit_Changes, that tracks old vs new values across different forms. For lookup fields, the old/new value is the ID, but I also need the display value. What's a best practice for dynamically fetching the display value of the

                                                                                                          • Workdrive and ChatGPT Team Synced Connectors

                                                                                                            Hi, we want to be able to integrate Zoho Workdrive with OpenAI’s ChatGPT Team plan. Google Drive and OneDrive both offer this, zoho please catch up asap. We dont want to have to put our company files in google drive, we want to allow chatgpt Team edition

                                                                                                          • Ability to Create New Items When Zoho Trident is Minimized via tray or taskbar icon

                                                                                                            Allow users to create new items (emails, calendar events, tasks, etc.) directly from the system tray icon or by right clicking the task bar icon, even when the window is minimized or not actively running in the foreground. This enables quick access to

                                                                                                          • Bug Report and Suggestions for Improvement in Zoho Applications

                                                                                                            Hi Zoho Team, I’d like to report a few bugs and improvement suggestions I’ve noticed while using Zoho products: Zoho Cliq Video Call: The camera sometimes turns off automatically during video calls. This seems to be a bug — please check and fix it. Zoho

                                                                                                          • I can not see Undeliverable emails from my Mass Email Leads activity in CRM

                                                                                                            I am sending email templates and I can not see the Undeliverables? I only receive the "Out of Office" replies and any manual replies from the lead. Can you please let me know where the Undeliverable emails are sent so I can use the information to clean up the database?

                                                                                                          • Select Zoho Contacts as Meeting Participants in Zoho Cliq

                                                                                                            Hello Zoho Cliq Team, We hope you're doing well. We would like to request an enhancement to the meeting scheduling functionality in Zoho Cliq. Current Limitation: When scheduling a meeting in Zoho Cliq, participants can only be selected from: Organization

                                                                                                          • Ability to Select External Users from Participants List When Scheduling Meetings

                                                                                                            Hello Zoho Cliq Team, We hope you're doing well. We would like to request an enhancement to the meeting scheduling experience in Zoho Cliq. Current Limitation when scheduling a meeting in Zoho Cliq: External users can be selected from the list only under

                                                                                                          • Kaizen #212 - Map Dependency Fields in Zoho CRM using APIs

                                                                                                            Hi Everyone!! Welcome back to another week of Kaizen series! Over the past few weeks, we have been addressing your questions and feedback shared through our Kaizen 200th feedback form. Thank you for your continued engagement and thoughtful queries. We

                                                                                                          • Outdated state in mexico

                                                                                                            Hello Zoho team, the drop down to add the state for customers, when they introduce their state in mexico has a city named “Distrito Federal” that name changed many years ago to “ciudad de mexico”. could you please update this so my clients can find the

                                                                                                          • Is anyone using Zoho Flow with airtable?

                                                                                                            I need to build a flow that collects data from airtable and uses some of that data to create folders and files in google drive. I have fully function version of this in zapier and want to migrate to zoho. I am trying to perform a very basic fetch from

                                                                                                          • SOME FEATURES ARE NOT IN THE ZOHO SHEET IN COMPARISION TO ZOHO SHEET

                                                                                                            TO ZOHO sir/maam with due to respect i want to say that i am using ZOHO tool which is spreadsheet i want to say that some features are not there in zoho sheet as comparison to MS EXCEL like advance filter and other Features which should be there in ZOHO

                                                                                                          • AI in Zoho Workplace: A Sneak Peek into What’s Coming!

                                                                                                            Hello everyone, We’re super excited to share something we’ve been working on and we want you to be part of it! You may have seen our announcement blog post introducing a major evolution in how AI works within Zoho Workplace. Want to be among the first

                                                                                                          • Display Client Name in Zoho Creator Client Portal Dashboard

                                                                                                            Hello Zoho Creator Team, We hope you are doing well. Zoho Creator recently introduced the option to set a client’s display name in the Client Portal settings, which is very helpful for providing a personalized portal experience. However, there is currently

                                                                                                          • Meet Canvas' Grid component: Your easiest way to build responsive record templates

                                                                                                            Visual design can be exciting—until you're knee-deep in the details. Whether it's aligning text boxes to prevent overlaps, fixing negative space, or simply making sure the right data stands out, just ironing out inconsistencies takes a lot of moving parts.

                                                                                                          • Best way to share/download presentation files in Zoho without losing formatting?

                                                                                                            Hello Zoho Community, I often work with PPT/PDF files in Zoho Docs and share them with colleagues. While PDFs usually give a direct download option, I’ve noticed that PPT/PPTX files sometimes only open in the viewer without a clear download link. Is there

                                                                                                          • Workflow Failure - Notifications

                                                                                                            Good afternoon, I have just experienced an error whereby a Workflow failed, for a reason currently unknown. The problem is that one of my users had to flag this manually (thankfully he's very thorough) and this otherwise would have flown under the radar.

                                                                                                          • Introducing Bin Locations In Zoho Inventory

                                                                                                            Hello users, We are excited to let you know that your wait for the Bin Locations feature has now come to an end! Yes, you heard us right! We are here to introduce the much-awaited Bin Locations now in Zoho Inventory. But before we dive into the feature

                                                                                                          • Error "Invalid client task found corresponding properties" only when triggered from workflow ?

                                                                                                            Hi All, I am facing an error message I never encountered previously: Error in executing On Add - On Load script Error in executing thisapp.get_all_projects_api_call function. Line:(2) Error in executing thisapp.getAccessTokenFromRefreshToken function.

                                                                                                          • How to interpret Campaign report statistics - definitions/explanation

                                                                                                            I am trying to make sure I understand the Campaign report correctly Do you have a list of definitions for: Delivered - it has reached the recipient's inbox Campaign reach - is this the number that have opened the campaign email? Unique Opens Clicks/Open

                                                                                                          • Feature request - pin or flag note

                                                                                                            Hi, It would be great if you could either pin or flag one or more notes so that they remain visible when there are a bunch of notes and some get hidden in the list. Sometimes you are looking for a particular name that gets lost in a bunch of less important

                                                                                                          • Schedule a Call by Date and Time when a specific lead status is selected

                                                                                                            Hi Wanting to create a workflow where a call can be scheduled by date & time when a specific lead status is selected. Can only currently set the date by Due Date - Trigger Date - Plus 'x' day(s) Thanks

                                                                                                          • Zoho CRM's Copy Customization functionality now works across DCs, for customized accounts, and more

                                                                                                            Availability This feature is available in Standard, Professional, Enterprise, and Ultimate editions. These changes have been rolled out to all users in all DCs. For more information, please refer to these help documents: Overview | Instructions Hello

                                                                                                          • How can I bold text on Zoho Forms submit buttons?

                                                                                                            In the old theme builder, I could bold the text on a form's submit button. With the new theme builder, I can only change the text of the header or fields in the form, and not the button itself.

                                                                                                          • 5名限定 課題解決型ワークショップイベント Zoho ワークアウト開催のお知らせ (10/31)

                                                                                                            ユーザーの皆さま、こんにちは。Zoho ユーザーコミュニティチームの中野です。 10月開催のZoho ワークアウトについてお知らせします。 今回はZoomにて、オンライン開催します。 参加登録はこちら（無料）：https://us02web.zoom.us/meeting/register/BGYTysOnSqa9LA9eY2IKww ━━━━━━━━━━━━━━━━━━━━━━━━ Zoho ワークアウトとは？ Zoho ユーザー同士で交流しながら、サービスに関する疑問や不明点の解消を目的とした

                                                                                                          • Hiding Pre-defined Views

                                                                                                            You can enhance Zoho with custom views - but you cannot hide the pre-defined views. Most users focus on 4 or 5 views. Right now for EVERY user EVERY time they want to move to one of their 4 or 5 views - they have to scroll down past a long list of pre-defined views - we don't use ANY of the pre-defined views. Adding the feature to allow a predefined view to be hidden completely or only visible to certain users would be a big improvement in usability for Zoho CRM. This feature is already available

                                                                                                          • Rich-text fields in Zoho CRM

                                                                                                            Hello everyone, We're thrilled to announce an important enhancement that will significantly enhance the readability and formatting capabilities of your information: rich text options for multi-line fields. With this update, you can now enjoy a more versatile

                                                                                                          • [Integration Edition] Deluge Learning Series – Third-Party Integrations with Deluge | October 2025

                                                                                                            We’re excited to continue this three-month edition of the Deluge Learning Series: Session 1 – Integrating Zoho Apps with Deluge Using Built-In Integration Tasks Session 2 – Integrating Zoho Apps with Deluge Using invokeURL and invokeAPI Session 3 – Third-Party

                                                                                                          • Feature Request: Tag, Search, and Report on Individual Private Comments

                                                                                                            Zoho Desk Team, First, I want to say that we are extensive users of Zoho Desk and it is a core part of our support operations. We rely heavily on the private comments feature for internal communication, knowledge sharing, and maintaining a clear history

                                                                                                          • Zoho CRM Community Digest - August 2025 | Part 2

                                                                                                            Hello Everyone! Here's a quick round-up of handy tips, clever workarounds, and product updates from late August. Product Updates: Meeting Enhancements in Zoho CRM! Track whether a meeting is online, in-office, or at the client’s location using the new

                                                                                                          • Assistance Needed: Ticket Status Not Updating and Sorting by Last Customer Reply in Zoho Desk

                                                                                                            Hello, I’m facing two issues in Zoho Desk that I’d like your guidance on: Ticket Status Not Updating: When a customer replies to a ticket, the status does not change to Reopened. Instead, it remains in Waiting on Customer, even after the customer’s response

                                                                                                          • Round robin

                                                                                                            Hi, I'm trying to set up a round robin to automatically distribute tickets between agents in my team but only those tickets that are not otherwise distributed by other workflows or direct assignments. Is that possible and if so which criteria should I

                                                                                                          • Time Entry Notifications

                                                                                                            Hi All - I have support staff who place notes of their work in the time entry section of Zoho Desk. Is there a specific workflow or setting I need to enable to have the ticket holder updated via email when an entry is saved?

                                                                                                          • Change text in help desk

                                                                                                            Hi, Please let me know how can i change the this text, see screenshot.

                                                                                                          • Customer happiness customisation

                                                                                                            Hi, I was wondering if it's possible to somehow customise to whom and when customer happiness request is sent? Can you enable it only for selected tickets for example based on workflow or any other criteria (customer name, tag or anything else)? Also

                                                                                                          • Sign in process is beyond stupid. I'd rather plug my phone into USB and copy files than sign in to this POS.

                                                                                                            792 clicks and fields to fill in just to get into a 3rd rate app is too stupid for me.

                                                                                                          • No Zoho Support Response in Months

                                                                                                            I want to say that I love Zoho FSM, Books, and CRM, but the support is scary bad. About 2-3 months ago, I emailed Zoho FSM support with two specific issues I needed help with, and I have still not received one single response. I also submitted a support

                                                                                                          • Has anyone built a custom AI support agent inside Zoho (SalesIQ/Zobot)?

                                                                                                            Hi all, I’ve been experimenting with building my own AI support assistant and wanted to see if anyone here has tackled something similar within Zoho. Right now, I’ve set up a Retrieval-Augmented Generation (RAG) pipeline outside of Zoho using FAISS. It

                                                                                                          • Null

                                                                                                            If a result is null how do I make it so that a custom error pops up instead of the default error? Can someone write an example as if I were using the script builder?

                                                                                                          • Next Page