Knowledge Base | FAQs

To request customer support, please submit a ticket from inside your control panel.

Search our help KB docs only using the AI-powered Embedded Search Tool below.

Popular Help Docs

What is a Shop Bot Pro session?

Summary: A Shop Bot Pro session occurs when a site visitor interacts with one or more of the Shop Bot Pro AI tools on a website.Shop Bot Pro sessions determines the pricing for the usage plan, with higher monthly session allowances resulting in higher pricing. The unique instance covers all interactions with the customer during their visit, including content searches, recommendations, and chat conversations. Unlike other AI tools that charge per token or query, Shop Bot Pro's pricing is based on the number of unique visitors who use the tool on the site. API calls do not count towards the monthly quota, and only customer interactions are considered valid sessions. These interactions can be tracked in the Shop Bot Pro control panel for analysis of ROI, conversions, and usage patterns.

What is a Shop Bot Pro AI dataset?

Summary: A dataset in Shop Bot Pro is a collection of database records that contain specific site URLs, text content, and AI-generated search results excerpts. It is used by AI tools to provide relevant responses to user questions and searches. The index field, generated from the text content, is used to compare search queries with site content and provide the most relevant resources. The dataset also includes an embeddings field for use with the OpenAI language model and allows for customization to target specific keywords or phrases. Multiple datasets can be created for different types of content or segmented from the main site search.

Install Shop Bot Pro JS Scripts (All Tools)

Summary: To install the Shop Bot Pro tool on your website, log into the control panel and add your URLs to the dataset index. Customize the tool with your desired colors and logo, then click the 'Install On Website' button on the tool manager. Copy the JS script and paste it into your CMS manager's JS loader method or add it directly to your files. For WordPress or other CMS systems, you can use a plugin or paste the code into the footer via the theme editor. If unsure, contact customer support for assistance. For custom sites, add the script to the footer or another include file that loads on every page.

Live Search AI Tool Installation

Summary: To install the Shop Bot Pro Live Search on your website or online store, first login to the control panel and make sure you have imported some content URLs into your data set. Then, click on the live search button and configure your tool by setting the required values, such as the search form class and search field name. Once configured, you can copy and paste the install JS file onto your website through your CMS manager. 

Embedded Search AI Tool Installation

Summary: To install the Embedded Search Tool, add content and configure the appearance and settings. Then, add the JS script tag to the desired page. There are three types of integrations: Stand-alone Segmented Content Search, Summary Results List Only, and Primary Site Search & Search Results system. Each integration type is configured and installed differently, and they have different uses such as segmented content searches or as the main search solution on your site.

Where should I install the embedded search tool? 

Summary: The decision of where to install the embedded search tool depends on how you want to use it on your website. Installing it on a stand-alone page is ideal for a dedicated search function or a segmented content area search. However, if you only want to enhance existing keyword or category-based search results, then you can include the tool above or below the existing results without a search input field turned on. 

How can I create multiple “profiles” for the embedded search results AI tool?

Summary: To create multiple profiles for embedded search results using the same dataset, users can take a snapshot of their current search configuration and name it based on its intended purpose. This snapshot can then be used as a template for different use cases, such as one with the search input field included and another with it disabled. By applying the saved snapshot to the default profile and generating an install script, users can have multiple active profiles for the same dataset. The generated scripts can be used on different areas of the site and can be switched back and forth between snapshots at any time.

Does Shop Bot Pro provide installation and configuration assistance?

Summary: Yes, we provide complete support on the configuration, installation and usage of all our tools. You can receive help with installing and configuring tools on their site by submitting a support ticket through the control panel. Use the "Contact Support" button at the bottom left of any screen for assistance.

Can I use the AI powered Live Search if I already have live search on my form?

Summary: The Shop Bot Pro Live Search Tool cannot be used alongside another keyword-based live search feature on your site. You will need to disable your current live search function in order to utilize the AI-powered semantic search features. While it is technically possible to have both live search functions active at the same time, it would result in a confusing and unappealing experience for users.

Can I place the embedded AI search inside my existing search form?

Summary: The Shop Bot Pro Embedded AI search can be integrated into existing search forms without affecting their functionality. This tool can also be added to existing results displays, enhancing them with AI-optimized results.

Why do I need to reinstall the JS script after editing a tool?

Summary: In order to update changes made to the appearance or settings of a specific tool on a website, it is necessary to reinstall the tool script. This is because the Shop Bot Pro AI tools use standard JS and CSS files, which are usually cached by the user's browser. In order to ensure that the updated version is downloaded, a new named JS script must be installed. Additionally, the use of a CDN service helps to optimize resources for users based on their location. Installing a new script with a unique file name prevents users from accessing a previously cached version of the tool.

Do I have to use all the AI tools on my site?

Summary: The Shop Bot Pro AI site offers a variety of tools, but users have the flexibility to choose which ones they want to use. Each tool functions independently and there is no obligation to use any specific one. The Live Search Add-On is the most popular stand-alone AI tool offered by Shop Bot Pro.

Are the tools branded with Shop Bot Pro info on my website?

Summary: The Shop Bot Pro AI ecommerce tools do not contain any watermarks or links to the 2026.visperity.com website, even during the free trial period. Additionally, these tools can be fully customized and branded with a company's logo and information.

Do I need an online store to use Shop Bot Pro?

Summary: Shop Bot Pro is powerful AI assisted search solution that can work with any type of website, including both ecommerce and business-only sites. It offers the most relevant search results and even has a virtual site assistant. You do not need to have an online store in order to use Shop Bot Pro but it provides some ecommerce specific features to enhance the online shopping experience.

Does my site require a framework such as jQuery or React to use Shop Bot Pro?

Summary: Shop Bot Pro does not need a framework like jQuery or React to function. The tool's JS files are written in pure JavaScript and can be used on any site, regardless of the frameworks or libraries already in use.

Add SKUs & Targeted Keywords To Search Index

Summary: To force a specific page to appear at the top of search results, add relevant keywords in the 'product_skus' field for that URL. This is useful for ensuring a product page appears first when the user searches for an exact SKU number. This field is available in the control panel and when posting content through the API. This feature can also be used for words or phrases associated with a specific page.

Excluding Content From Indexed Page Using Start-Stop Tags (Advanced)

Summary: To set up custom start and end tags for content extraction, you can add standard HTML comments to specify the desired area on your page(s) that contains only the content you want to index. This helps filter out irrelevant content such as navigation menus and advertisements from the index, ensuring more accurate AI indexing for the intended resource. To enable this advanced feature, access your control panel, select the relevant dataset, and click on the Advanced button to add custom tags. You can use existing tags from your CMS or create your own and add them to your page or CMS template file. If included, the custom data start\stop tags will be used for all content extracted from the dataset. If not specified, the entire page content between the body tags will be indexed by default.

Search Results Fine-Tuning

Summary: To optimize a document's index and improve its relevance to certain searches, it is recommended to remove any irrelevant index field content and add a summary paragraph that accurately describes the document. You can also use the Search Excerpt generator to assist in creating a relevant summary. It is also important to only include relevant content in the document's index, such as primary product information, to improve the accuracy of AI responses. Additionally, using the dedicated SKU field can help ensure that a specific item is returned as a top match for certain searches. 

Can I search my business documents with AI?

Summary: Yes, you can add documents to your AI search results by including their URLs when adding your content. The AI indexer will automatically determine the resource type and ingest the content accordingly. This includes PDF, Word, Excel, and Text documents that can be accessed through a web browser. These document types can also be included in virtual AI assistant conversations.

Can I filter segments with categories?

Summary: TShop Bot Pro's beta testing revealed that merchants wanted the ability to fine-tune and rename content in segmented datasets for specific use cases, such as knowledge base articles. The best solution was to allow the creation of new datasets with specific URLs rather than filtering by category. Merchants also desired different search result images and appearances for segmented datasets. The tool includes a generous number of quota URLs to account for duplication in multiple datasets.

Embedded Search AI Tool Installation

Summary: To install the Embedded Search Tool, add content and configure the appearance and settings. Then, add the JS script tag to the desired page. There are three types of integrations: Stand-alone Segmented Content Search, Summary Results List Only, and Primary Site Search & Search Results system. Each integration type is configured and installed differently, and they have different uses such as segmented content searches or as the main search solution on your site.

How can I segment my datasets?

Summary: To segment a specific area of your website, such as an online store or knowledge base, with the Shop Bot Pro tools, you can create a new dataset and add only the content (URLs) from that area. This will limit the results of the tool to only the content from those URLs. If you need to duplicate some URLs in multiple datasets, there is a generous quota provided for this purpose in every plan. Most merchants will only need to upgrade to a higher plan if their site's unique user count exceeds their plan's session quota, not due to a lack of indexable URLs.

Why are some URLs listed twice in my dataset?

Summary: Some URLs in the AI dataset may appear multiple times because they are split up into separate records due to their large amount of text content. This is called "chunking" and is necessary for the AI engine to work effectively. However, in search results, the specific URL will only be displayed once even if it has multiple records in the dataset.

Why does the AI powered search always return some results?

Summary: AI powered search uses semantic search to find relevance to your content based on the provided search terms. This means that even if the search is not directly related or contains misspellings or similar words, the engine will return the most relevant results first and then less relevant information afterwards. This allows for incredibly accurate results, especially for ecommerce sites where customers may be searching by product ID or SKU, as the engine will still return relevant results even for misspelled or mis-entered search terms. Unlike ChatGPT, Shop Bot Pro will only return results from your indexed content, even if the relevancy is limited, ensuring relevant results for your site's products or services.

Can I use the Visperity Live Search tool if my site already has a keyword-based live search feature?

Summary: The Shop Bot Pro Live Search Tool cannot be used alongside another keyword-based live search feature on your site. You will need to disable your current live search function in order to utilize the AI-powered semantic search features. While it is technically possible to have both live search functions active at the same time, it would result in a confusing and unappealing experience for users.

Can I extend my Shop Bot Pro AI trial?

Summary: Shop Bot Pro does not offer trial extensions due to incurring usage costs from providers during the trial period. Limiting the trial to 7 days only helps keep pricing for paid plans affordable. If a paid plan is purchased and then cancelled however, we have a very generous refund policy. 

I'm receiving an error while importing my content (URLs).

Summary: If your batch of URLs or an individual URL is not showing any information in the AI Data "Index" field or if you receive an error message when entering a URL on the 'Add Site Content' page, it is likely because your server or DNS provider has a bot-prevention system or firewall that is blocking the scraper from downloading the textual content of your page. If you are using Cloudflare, you can disable the bot-protection temporarily so that the scraper can access your content. Once you have added your URLs to your dataset, you can re-enable the bot-protection as needed. If you are using a different type of bot-prevention, you will need to whitelist the scraper's IP addresses and domains in order for it to access your content. You can find the necessary IP addresses and domains by clicking the 'View Full KB Doc' button.  

Why is my AI live search results list empty or only displays 'undefined'?

Summary: If your Live Search Add-On or Embedded Search Add-On are not working properly and displaying "undefined" as the search results, it may be because you have not authorized your domain or have excluded the specific sub-domain where the tools are installed. To fix this, log in to the control panel and make sure the correct domain and sub-domain are entered in the authorized domains setting for your dataset. This can be found below the API key. Keep in mind that if your tool is installed on a sub-domain, it must be entered as an authorized domain. When unsure, enter both the domain without the sub-domain and the sub-domain that appears in your browser's address bar. Common subdomains include www and shop.

The Live Search drop-down list is not rendering correctly after installing on my website.

Summary: The live search display could be malfunctioning on the website due to an overlay or floating search form being used. To fix this issue, a new rule needs to be added to the custom CSS field. After saving the changes and re-installing the new install script, the live search should function properly. The rule is #sbpro-live-search-list {position: relative;}

The embedded search display is not showing up on my website.

Summary: When the embedded search form does not show up on a website, it is likely due to an incorrect or missing value in the Target Class For Embedded Search Form & Results Display field during the configuration process. If the correct class name is entered and the Show Search Form option is turned on, the search form should appear on the dedicated page. It is recommended to keep the search form turned on for initial testing, and the browser's developer tools can be used to check for any errors with the class name. If an error occurs, it means the class name is incorrect and cannot be found on the designated page.

Shop Bot Pro FAQs

Will Shop Bot Pro work with my site or ecommerce system?

Yes. Shop Bot Pro works with any website and any ecommerce platform.

Shop Bot Pro's AI site tools are installed as a simple JS script tags and can be used with custom site designs, WordPress, Joomla, Drupal, Magento, Wix, etc. If you don't know how to install a third party JavaScript reference file on your site, simply contact support and we will walk you through it or we can install it for you.

Why is Shop Bot Pro better than my current search?

Simply stated, Shop Bot Pro is smarter than your current search and understands the actual intent behind your customer's query.

Shop Bot Pro seamlessly integrates the simplicity of keyword-based searches with the power of AI-driven semantic search. 

With Shop Bot Pro, users receive highly relevant results, even if they misspell their search or submit ambiguous or incomplete search queries. 

Shop Bot Pro works for both websites and online stores, delivering hyper-precise search outcomes and adeptly responding to inquiries about your site and business through our virtual site assistant tool. 

All Shop Bot Pro tools operate indepedently so you can install only the specific tools or tools that best match your content requirements. 

Our most popular tool is the Shop Bot Pro Live Search add-on which transforms your existing keyword search bar into a super-charged, AI-intelligent semantic search system without affecting your current search system and with NO custom programming. 

Embrace the future of search technology and elevate your site's user experience by installing Shop Bot Pro today.

Does Shop Bot Pro replace my current search?

Shop Bot Pro's AI-powered search tools are primarily used as an enhancement to existing site and online store search forms.

Our most popular AI tool, the Live Search Add-On, adds a real-time drop-down list of the most relevant results to your existing search form as the user types but it does not affect your current search results page.

However, we also have our Embedded Search solution which can be used either as an add-on to an existing search results page, a stand-alone search system for specific content such as help documents, or the Embedded Search tool can be employed as site's primary search solution (i.e. replace your current search).

Most users install the individual Shop Bot Pro tools as enhancement(s) to their current search system but, if required, you can use Shop Bot Pro as your entire site search solution as well.

Do I have to use all the AI tools on my site?

Nope. Every Shop Bot Pro tool is optional. 

All of the Shop Bot Pro AI site tools operate independently, and you are not required to use any specific tool. You can install whichever tool or tools that best suit your specific search and content requirements. (Our most popular stand-alone AI tool is the Live Search Add-On.) In addition to the currently available AI tools, we will also be adding more ecommerce-specific tools in the coming months and your subscription includes access to those new tools as well!

What is a Shop Bot Pro session ?

A session is when a site visitor directly interacts with one or more of the Shop Bot Pro AI tools that are installed on your site.

The unique instance (session) covers all interactions with that specific customer (site visitor) for their duration of the visit including all content searches / recommendations, questions and answers, chat dialogs and virtual assistant conversations.

Unlike many other AI site content tools, which charge per token, per query and/or per API call,  Shop Bot Pro pricing is based on the number of unique visitors that use the Shop Bot Tools on your site during the billing period. (Along with the total number of URL content resources that are added to your accont which you can search with the AI tools.)

With our simple and transparent pricing, you don't need to worry if specific customers might engage your site assistant excessively nor do you need to track the amount of data that is going back and forth from the AI engine. (You can still track all usage of your tools with your Shop Bot Pro control panel to give insights on ROI, conversions and usage patterns to fine-tune your generated results).

Every site visitor does NOT count as a session. A session is only counted against your quota if the site visitor interacts with the Shop Bot tool in some method.

Simply opening the Shop Bot Pro Chat Window or viewing a search page does not count as a instance (unique session). If you have an existing keyword search on your site that loads it's own results page, searches using that method do not count against your quota unless you have activated the Shop Bot Live Search  feature on your existing keyword search field (form) and recommended results are displayed while the user is typing their traditional keyword search query.  The live search add-on is included with all plans but not active on the site unless you specifically integrate that feature into your current keyword search function (form). (Note: Direct API Calls for content management do not count against your monthly quota. Only customer interactions are considered a valid session).

Can I use Shop Bot Pro with multiple websites?

Yes, there is no set limit on the number of sites that you can use with your Shop Bot Pro account.  

You are only limited to the number of sessions in your plan but those sessions can be used on multiple installations (websites and/or online stores). (You are also limited by the total number of alllowed (indexed) content URLs but it is very unlikely that users will reach their URL limit even when using Shop Bot Pro on multiple sites.)

Note regarding segmenting search content: If you are using Shop Bot Pro on multiple sites, you simply create different search profiles in your control panel for each site and then each individual site will only search and return the data (indexed URL's content) that is assigned to that specific profile. You are assigned a unique API key for each site (search profile) that you create in the Shop Bot Pro control panel.

What if I go over my monthly session quota?

We will send you an alert when you are within 15% of your monthly quota and again at 5%. 

Monthly Plans: If you are on a monthly Shop Bot Pro plan, you can choose to upgrade your account to the next usage level (plan type) in which case your billing date will be adjusted to the date you make that change.  (Any leftover session credits will be applied to your new plan.) You can upgrade or downgrade your account level anytime based on your site traffic requirements. However, please note that every time you change your billing plan,  your current plan will be canceled and the new plan will be billed at that time.

Once you reach your session quote, you have a 7 day grace period before you will be required to upgrade your plan as long as your usage remains withing 10% over your quota. After 10% or 7 days (whichever comes first), your account will be throttled and you will need to upgrade to the next level for that pay period for full usage. If an account is throttled, your customers may see a message that their request could not be completed. However, they will never see any message related to your account or billing status.

Annual plans: If you are on an annual Shop Bot Pro plan, you will be provided a grace period for up to 30 days as long as the overage remains in the next higher plan level.

Example: If you are on an annual Owner | Designer plan and you exceed your plan quota, we will automatically apply the usage quotes for the next plan level (Developer) for the remainer of the monthly quota period. At the beginning of the next month's quota, we will automatically revert your levels back to your paid plan.  Important: if you exceed your enrolled plan quota two consecutive monthly periods in a row, you will need to upgrade your plan to the next billing level. In that situation, you would simply need to pay the difference between your current plan and the next higher usage plan.

Does Shop Bot Pro return information about my competitors or answers to general questions like ChatGPT?

No, Shop Bot Pro is restricted to only return results based on the content (URLS) that you provide to it.

The AI powered search only looks at the your specific content that is crawled Shop Bot Pro data indexer.

Although Shop Bot Pro uses the same AI language models as ChatGPT to analyze and generate intelligent responses , it cannot and will not return data outside of it's data parameters (i.e, the content that you provide to it.)

For instance, if Shop Bot Pro crawls all your site pages and products and you ask it "What is Microsoft? ... it will not return information about Microsoft, the company, from an external source nor will it return links or references to external sites that are related to Microsoft. Shop Bot Pro will also not return links to external sites that sell Microsoft products or services. 

Shop Bot Pro is restricted to the content that you provide to it during the ingestion (indexing) process and therefore, if you ask Shop Bot Pro a question about another company, person, product or service,  Shop Bot Pro will only return information about that query as it relates to your specific content.

Therefore for the "Microsoft" example, if you sell any products or offer any services that are even remotely related to Microsoft, it will list those results first. However, if you have nothing on your site that is related to Microsoft, it will instead return results that are most relavent such to the meaning of your question. (i.e., Instead of "What is Microsoft?", the meaning of the query would be interpreted as "What is your company?" if you had no data in your content that is specifically related to Microsoft.).

The most amazing thing about AI optimized content searches is that it correlates even the most random association with one element to another. 

For example, if you are selling a specific type of products such as "Table Clothes", it will understand that is related to content associated with Dinner, Eating, Entertaining, Holidays, etc. and return the most relevant matches for a search. Even if you sell nothing "holiday" related and no other housewares, a search such as  "My In-laws are coming this winter. What should I buy to make the house more festive?" would return "Table Clothes" as a top result unless you sell other items that are much more relevant to that search such as holiday themed candles, cookie cutters, wreaths, ornaments etc.

Unlike traditional keyword or phrase based searches, even if the question is misspelled or asked incorrectly, Shop Bot Pro will return relevant results. This INTELLIGENT RELEVANCY makes it much easier for your customer to locate the product or service they are most interested in on your site and therefore increase the conversion rate of site visitors to purchasers.

Which Shop Bot Pro tools are included with my plan?

All the Shop Bot Pro AI Tools are included with every plan. 

You can use any tool that best suits your specific content requirements. 

Some sites may want to implement the Live Search feature to enhance their existing keyword search form while others may want to increase the accuracy of their search results by including embedded AI optimized results along side their existing search results. 

You can add and remove any tool at any time on your sites and your pricing does not change.

Does Shop Bot Pro share my content with other providers or sites?

No, any content URLs you add to be included in your site search results and any data collected during live chat - Q & A (site assistant data) is exclusive to your specific data store on the Shop Bot Pro servers.

The data that is analyzed by AI to index your content is not used to train other sites.

Note: All data that Shop Bot Pro uses for it's searches and AI relevancy results is already publicly available since our crawler bot only indexes URLS that you provide. However, we still do not share your content data nor do we share the search history and chat conversations with any third party. You also have the option of flushing individual conversations or the all activity from your reports at any time via your control panel.

Can Shop Bot Pro be branded to my company scheme and is the 'bot' visible in the chat windows or other processes?

Yes, Shop Bot Pro is fully skinnable to match any site theme or company branding.

The public does not see the "bot" in action at anytime since the AI work is done in the background and the magic happens when the incredibly relevant results are returned on the client side.

The Shop Bot Pro AI tools do not contain any watermarks, copyright information or links to Shop Bot Pro.

Is my data secure and do I need to backup my ingested content?

Yes your data is fully secure.

Your content data and AI generated search vectors are stored on multiple, redundant database servers on Amazon (AWS) and are fully encrypted and backed up continuously. 

All data is saved on multiple servers simultaneously and your AI requests are processed based on the best performance to the specific client. 

You do not need to backup any data that is ingested by the Shop Bot URL crawler but we do provide the option of exporting your current index data so that you can fine-tune the content text, result titles, manually add more information and then reimport it with the additional content.

Is Shop Bot Pro used for SEO?

No, Shop Bot Pro is not an SEO solution. Shop Bot Pro does not generate traffic. 

Shop Bot Pro tools interact with the user (customer) once they reach your site.

Shop Bot Pro may indirectly affect your future site traffic by increasing customer retention and improving the overal user experience so more customers may return as repeat purchasers however.

Is there an API for integration into my ecommerce platform and/or business processes?

Yes, we provide a REST API.

The API allows you to add new search content or update existing content in your Shop Bot Pro date store automatically without having to do it from the online control panel. We can assist you in setting up the pipeline to trigger the API post whenever your content is updated on your website, online store or external URL. There are also several companies that provide automated tasks schedulers for this type of scenario such as Zapier and Decisions.

What if I decide to pause or cancel my plan and what is your refund policy?

You can pause your plan anytime and your billing will simply resume when you reactivate it.  

If for any reason, you are not satisfied with your purchased subscription (service), you can cancel it anytime during the 30-day billing cycle and your subscription will be automatically cancelled and you will receive credit back to your payment method for that month's subscription fee amount only if it has been less than or equal to 7 days since the start of the billing cycle. 

The current monthly subscription fee is non-refundable if it has been more than 7 days since the new billing cycle has begun due to the usage costs we have already incurred from our service providers (partners).

Note: Due to the usage costs that we incur by our service providers when you are actively using our products, the previous month(s) payments are non-refundable.

We also offer a free tier (7-day trial) for ALL of our products to test-drive the service prior to purchasing.

If you paid for your subscription on a discounted annual plan and want to cancel, you will be refunded the remaining amount of your annual plan prorated as a monthly subscription. Example, if you purchased an annual plan for $100 and the monthly rate for that plan was $10 and you cancelled after 2 months, you will receive a prorated credit back for $80.00. ($100 - 2 months at $10/mo). 

The amount of time elapsed on an annual plan will be calculated as every 30 days as one billing cycle. Any usage for a partial billing cycle (8-30 days) will be treated as a full billing cycle when calculating the amount to refund. If the time elapsed in the annual plan falls within the first 7 days of the new monthly (30-day) billing cycle, that amount will not be debited off your annual fee prorated refund as a courtesy.


Please allow 2-4 business days for a refund credit to post back to your payment method.

To cancel your subscription, please click here.

 
 
×