Bot Context and Visitor Fields - Zoho SalesIQ

Context variables

The bot context and visitors fields are used to store the information temporarily collected from the visitor until the conversation ends and use it across flows to make decisions and perform actions based on it.

Bot context

  1. The bot context is a variable that can be used to store/save the response from the visitor for a particular card. In the below reference, when the visitors provides the location details, it will be saved in the bot context variable (location.option).  And this variable can be used in other card to get respective value. 
  2. To save the visitor's response, click on the Save in bot context check box and provide the variable name. 


  • Type %  in the card's message text box/email content to avail all the bot context available in the bot.

Example

  • Let's take an e-commerce service where you need to send an order confirmation email once your visitors place an order via Zobot. Store the values required in a bot context on each block as shown in the below reference and use them on the send email card to send order confirmation emails to the visitors.

  • Here, the name from Name card, email from Email card, choice of product by Multiple options card, Date from the Calendar card, and location from the location card is collected and saved in the respective bot context to use in the Send email card. 

Output

  • This is the output (Order confirmation mail sent to the visitors) of the above configuration. 


Idea
Get the custom values that is set using the visitor.info() JS API using the "%visitor.custominfo.{key name}%" 

For the below visitor.info() JS API Script, 
  1. <script>
  2. $zoho.salesiq.ready=function()
  3. {
  4.    $zoho.salesiq.visitor.info({"Brand" : "Premium", "Branch": "California"});
  5. }
  6. </script>
The %visitor.custominfo.brand% will fetch and display the value Premium

Visitor fields

  1. If you want to capture additional information of a visitor other than name, email and phone, the visitor fields can be used. 
  2. The visitor fields is also a variable to save the response from the visitor for a particular card in SalesIQ. This information will be displayed in the operator's dashboard. 

  1. This information can also be pushed to Zoho CRM or Desk (both default and custom fields are supported). 
  2. To save and push the visitor's response, click on Save in visitor fields check box and provide the variable name. 
Alert
To push the visitor's response to Zoho CRM, the visitor field name should be the same as the API name. Similarly, to push the visitor's response to Zoho Desk, the visitor field name should be the same as the label name.

Example 

  1. In the e-commerce business, leads will be created along with their interested or prefered choices of products.

  1. In the below reference, when the visitors selects the prefered mobile choice, it will be saved in the visitor fields variable (interested_products) and gets pushed to the CRM field. 

  1. The CRM field name and the visitor fields name must be same for this action. Both the default and custom fields for any layouts are applicable for this action. 


Output
  1. The lead will be created in CRM along with the interested products.


Dynamic text 

The dynamic text are pre-defined values & information that is already available in the bot. These texts can be used to enrich the resposes and do API tasks using plugs

Example

  1. Initially, the value "visitor.name" is available, but the value will be empty as the bot doesn't know the visitor's name.
  2. So with the name card, we're getting name from the visitor and then using again to provide enriched response. 


Notes
Type %  in the card's message text box/email content to avail all the dynamic variables in the bot.

List of dynamic text that you can use:

Dynamic Text Format What it represents Use in welcome card Use in consequent cards
%visitor.name% Name of the visitor on the website.
%visitor.id% Reference ID for the visitor on the website.  
%visitor.email% Email Address of the visitor on the website.
%visitor.phone% The contact number of the visitor.
%visitor.department% Name of the department to which the visitor has initiated the chat.
%visitor.question% The question raised by the visitor while initiating the chat.  
%visitor.ip% The IP address of the visitor visiting the website.
%attender.name% Name of the operator attending the chat.
%visitor.pagetitle% Title of the page from where the visitor has initiated the chat.
%visitor.pageurl% URL of the page from where the visitor has initiated the chat.
%visitor.referrer% Source from where the visitor is referred from.
%visitor.state% State/Province of the visitor.
%visitor.city% City of the visitor.
%visitor.country% Country of the visitor accessing the website.
%visitor.timezone% Time zone of the visitor accessing the website.
%visitor.latitude% Latitude of the visitor.  
%visitor.longitude% Longitude of the visitor.  
%visitor.operating.system% The operating system used by the visitor.
%visitor.browser% The browser used by the visitor.
%visitor.browser.version% The version of the browser used by the visitor.  
%web.embed.name% The web embed where the visitor has initiated the chat.
%platform% The platform used by the visitors in their system.  
%screen.resolution% Screen resolution of the visitor's system.  
%search.engine% The search engine used by the visitor to reach the website.  
%search.query% Search Query (Keyword)used by the visitor to reach the website.  
%attender.email% The email address of the attendee who attends the chat.
%smart.timenow% The time period in the sequence of the day (Eg. Morning, Evening).
%company.name% Company name mentioned in Clearbit.
%company.type% Company type mentioned in Clearbit.
%company.sector% Company sector mentioned in Clearbit.
%company.location% Company location mentioned in Clearbit.
%company.website% Company website mentioned in Clearbit.
%company.employeecount% Company's employee count mentioned in Clearbit.
%company.annualrevenue% Company's annual revenue mentioned in Clearbit.
%company.marketcapital% Company's market capital mentioned in Clearbit.
%company.fundraised% Company fund details present in Clearbit.
%company.twitterfollowers% Your company's Twitter followers from Clearbit.
%company.facebooklikes% The likes you got on Facebook registered in Clearbit.
%company.industrytype% The industry type your company belongs to.



        Create. Review. Publish.

        Write, edit, collaborate on, and publish documents to different content management platforms.

        Get Started Now


          Access your files securely from anywhere

            Zoho CRM Training Programs

            Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

            Zoho CRM Training
              Redefine the way you work
              with Zoho Workplace

                Zoho DataPrep Personalized Demo

                If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

                Zoho CRM Training

                  Create, share, and deliver

                  beautiful slides from anywhere.

                  Get Started Now


                    Zoho Sign now offers specialized one-on-one training for both administrators and developers.

                    BOOK A SESSION







                                Quick LinksWorkflow AutomationData Collection
                                Web FormsEnterpriseOnline Data Collection Tool
                                Embeddable FormsBankingBegin Data Collection
                                Interactive FormsWorkplaceData Collection App
                                CRM FormsCustomer ServiceAccessible Forms
                                Digital FormsMarketingForms for Small Business
                                HTML FormsEducationForms for Enterprise
                                Contact FormsE-commerceForms for any business
                                Lead Generation FormsHealthcareForms for Startups
                                Wordpress FormsCustomer onboardingForms for Small Business
                                No Code FormsConstructionRSVP tool for holidays
                                Free FormsTravelFeatures for Order Forms
                                Prefill FormsNon-Profit

                                Intake FormsLegal
                                Mobile App
                                Form DesignerHR
                                Mobile Forms
                                Card FormsFoodOffline Forms
                                Assign FormsPhotographyMobile Forms Features
                                Translate FormsReal EstateKiosk in Mobile Forms
                                Electronic Forms
                                Drag & drop form builder

                                Notification Emails for FormsAlternativesSecurity & Compliance
                                Holiday FormsGoogle Forms alternative GDPR
                                Form to PDFJotform alternativeHIPAA Forms
                                Email FormsFormstack alternativeEncrypted Forms

                                Wufoo alternativeSecure Forms

                                TypeformWCAG


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

                                              Create. Review. Publish.

                                              Write, edit, collaborate on, and publish documents to different content management platforms.

                                              Get Started Now





                                                                You are currently viewing the help pages of Qntrl’s earlier version. Click here to view our latest version—Qntrl 3.0's help articles.




                                                                    Manage your brands on social media


                                                                      • Desk Community Learning Series


                                                                      • Digest


                                                                      • Functions


                                                                      • Meetups


                                                                      • Kbase


                                                                      • Resources


                                                                      • Glossary


                                                                      • Desk Marketplace


                                                                      • MVP Corner


                                                                      • Word of the Day


                                                                      • Ask the Experts


                                                                        Zoho Sheet Resources

                                                                         

                                                                            Zoho Forms Resources


                                                                              Secure your business
                                                                              communication with Zoho Mail


                                                                              Mail on the move with
                                                                              Zoho Mail mobile application

                                                                                Stay on top of your schedule
                                                                                at all times


                                                                                Carry your calendar with you
                                                                                Anytime, anywhere




                                                                                      Zoho Sign Resources

                                                                                        Sign, Paperless!

                                                                                        Sign and send business documents on the go!

                                                                                        Get Started Now




                                                                                                Zoho TeamInbox Resources





                                                                                                          Zoho DataPrep Demo

                                                                                                          Get a personalized demo or POC

                                                                                                          REGISTER NOW


                                                                                                            Design. Discuss. Deliver.

                                                                                                            Create visually engaging stories with Zoho Show.

                                                                                                            Get Started Now








                                                                                                                                • Related Articles

                                                                                                                                • FAQs

                                                                                                                                  What are FAQs? FAQs are a list of common questions customers have asked about your product or service. This section inside your SalesIQ dashboard will contain a list of these common questions along with the relevant answers, and can be shared by ...
                                                                                                                                • How SalesIQ identifies website visitors?

                                                                                                                                  Past Chats & Visits Using the information provided during the prior chats and visits, SalesIQ can identify the visitor by their registered name and email when they revisit the website. SalesIQ will assign the identity passed to the JS API for the ...
                                                                                                                                • Integrating Google AI with Zoho SalesIQ

                                                                                                                                  Note to customers: This feature is part of our upcoming Summer ’26 release and will be rolled out in phases. If you would like early access to explore the feature, please fill out this form. Google AI in SalesIQ When Google AI is integrated with ...
                                                                                                                                • Integrating DeepSeek with Zoho SalesIQ

                                                                                                                                  Note to customers: This feature is part of our upcoming Summer ’26 release and will be rolled out in phases. If you would like early access to explore the feature, please fill out this form. DeepSeek in SalesIQ When DeepSeek is integrated with ...
                                                                                                                                • Integrating Anthropic with Zoho SalesIQ

                                                                                                                                  Note to customers: This feature is part of our upcoming Summer ’26 release and will be rolled out in phases. If you would like early access to explore the feature, please fill out this form. Anthropic in SalesIQ When Anthropic is integrated with ...
                                                                                                                                  Wherever you are is as good as
                                                                                                                                  your workplace

                                                                                                                                    Resources

                                                                                                                                    Videos

                                                                                                                                    Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                                                                    eBooks

                                                                                                                                    Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                                                                    Webinars

                                                                                                                                    Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                                                                    CRM Tips

                                                                                                                                    Make the most of Zoho CRM with these useful tips.



                                                                                                                                      Zoho Show Resources