# Welcome to Superseek Hey, and welcome to Superseek! The arrival of ChatGPT changed everything. After decades of hype, we finally had an AI that could understand and hold truly human-like conversations. Blown away by its capabilities, we set out to make it as easy as possible for any business to leverage AI in their everyday work. And that's why we built Superseek. Our customers use Superseek to resolve support queries instantly and improve website engagement - saving them and their teams hours every day. We're sure Superseek will deliver similar results for you too. We love feedback. We are constantly adding new features and improving as we go and we'd love to hear your thoughts on how we can make Superseek better for you. Share them [here](https://superseek.featurebase.app/). If you need any help on the way, [book time with us](https://cal.com/superseek/30min) or shoot us an email at ** and we'll be on it right away! All the best! Tobin Sebastian Co-Founder & CEO, Superseek # What is Superseek? Superseek makes it easy to create custom AI assistants for your business. You can embed it on your website to instantly resolve support queries, engage website visitors, capture leads, and more. Under the hood, Superseek is powered by OpenAI's ChatGPT and GPT-4. But while ChatGPT is trained on all (or a big chunk) of the content on the internet, Superseek is powered only by the content you feed it - webpages, help docs, PDF documents, text, etc. You can think of it as a **custom ChatGPT trained only on your content.** By limiting the knowledge the AI has access to, Superseek minimizes hallucinations (ChatGPT's tendency to make up stuff) and keeps responses focused, accurate, and up to date. In a nutshell, you can simply add your content and get a custom embeddable AI assistant instantly that provides human-like answers based only on your content. Superseek also packs additional capabilities such as content auto-sync, custom theming, human handoff & routing, lead forms, and more.

Superseek ingests your content and creates an AI assistant instantly

## # How Superseek works Superseek is a conversational AI assistant that's powered by the content you feed it. But how does it work? Here's a quick high-level overview of everything that goes on under the hood. ## Step 1: Creating the knowledge base for your AI bot The first step is to provide your AI bot with the knowledge it needs to answer queries. When you add your content to Superseek (by adding your website, by uploading documents, or by pasting plain text), two things happen. 1. **Chunking of your content** Superseek extracts all the text from the provided sources (website pages, help docs, PDFs, plain text, etc.) and then breaks it into smaller chunks. 2. **Vectorization & Embedding of your content** The chunks of text are then vectorized (converted into 1536 numbers that capture the semantic meaning of that chunk of text) and embedded in a vector database. We use Supabase as our vector database. ## Step 2: Answering questions Once the knowledge base is ready, your AI bot is ready to answer questions. Here's what happens when a question is asked. 1. **Vectorization & Embedding of the question** Similar to the step above, the question text is vectorized and embedded in the same vector database. 2. **Locating the text needed to answer** Superseek performs a similarity check to locate the best set of text chunks needed to answer the question. 3. **Generating the answer** Superseek then passes the prompt (the instructions provided to the bot) along with the question and the best-match chunks to ChatGPT via OpenAI's API to generate an answer. ## **What if the question can't be answered by AI?** AI is great, but some questions still need a human touch! If a meaningful answer cannot be generated from the provided content (or if the user marks an AI-generated response as unhelpful), here's how we help you handle it. 1. **Fallback response** You can configure the 'I don't know' response the bot provides. You can ask the user to rephrase the question and try again or to get in touch with you. It's up to you. 2. **Routing buttons** Routing buttons can be added to the fallback response to help them get in touch with you. You can have the button open a link (Zendesk or Freshdesk ticketing page, calendly, etc.) or have it show a canned response. 3. **Human handoff (via your live chat provider)** If you have an existing live chat provider (such as Zendesk chat), you can configure the button to close the Superseek widget and open the live chat widget. This way, customers who need further support get it and your team is less loaded with repetitive support questions. We currently support Zendesk, Intercom, Freshchat, and Hubspot.

Routing and human handoff with Superseek

# Quick Start Follow these steps to get up and running with Superseek today. If you face any hiccups or need any help along the way, [book time with us](https://cal.com/superseek/30min) or shoot us an email at ** and we'll help you out. ## Step 1: Add your content The first step is to add all the content you think your AI bot would need to provide meaningful answers. {% hint style="info" %} Your AI bot cannot answer outside of the knowledge you provide it. The more relevant the information it has to work with, the better. {% endhint %} To add your content, head over to [Bots](https://admin.superseek.ai/bot) in the left navigation. You will find a default AI bot ready for you named 'My Bot'. Click on Manage and head over to Source Data.
You can add web pages (your entire website, your help content, and individual web pages), documents (PDFs only), and custom content (plain text) from here. {% hint style="info" %} Indexing your web content can take a while depending on the size of your website. You can move on to the next steps while indexing is in progress. {% endhint %} {% hint style="info" %} Only PDFs that are 'readable’ i.e. you can highlight the text in it and copy and paste from it can be indexed. {% endhint %} ## Step 2: Customize your AI bot The next step is to configure how your bot looks and behaves. Head to the Settings tab (Bots > Manage > Settings) to start. ### General Settings Configure your bot's name, the instructions it should follow, the AI model, etc. here.
* **Bot name:** The default name of your first bot is My Bot. Edit it to give your bot a name. * **Bot Description:** The bot description is for your use only and will not be displayed to your users. Feel free to edit it or leave it as it is. * **AI Model:** Choose the AI model here. The higher the quality of the AI model, the higher the quality of the AI answer, and the higher the credits it uses per response. * **Company or Product Name:** Enter the company or product your AI bot should provide answers about. * **About the company or product:** Share a very brief description of your company or product. This helps the AI understand who it represents and helps it provide better responses. * **Bot Role and Instructions:** Give your AI bot instructions on who it is, how it should respond, how it should not respond, and anything else you'd like to add. **You can choose to go with our default instructions or feel free to give your own. If you do give your own instructions, please make sure to test how the bot performs before going live with it.** ### Appearance Settings Customize the theme, headline, welcome message, and starter questions here.
### Routing Settings Sometimes the AI bot will not have a relevant answer. You can configure how the bot should handle such situations here.
* **Fallback Response:** This is the canned response the bot will provide if it cannot generate a meaningful answer. Customize it to suit your business needs. * **Human handoff to your existing live chat provider:** If you have live chat enabled on your website, you can configure Superseek to hand over the conversation to your live chat tool when the question needs human intervention. Click on your live chat provider and follow the instructions to set it up. * **Routing buttons:** Along with a fallback response, you can optionally provide additional buttons to get in touch with you. You can set the button to open a link (a link to create a support ticket or schedule time with you for example) or to provide a canned response (*"Give us a call at +1 123 456 7890 for further assistance"* for example).
## Step 3: Test AI answers Once all your content has been ingested, head to the **Playground** (Bots > Manage > Playground) to test the AI bot's responses. Ask the most common questions your customers ask and check the answers.
Conversations in the playground will show up in your inbox so you can see how the inbox works. ### If the AI bot doesn't provide an answer to a question This might be because a relevant answer is not present in the source content you provided. You can consider adding the information to the source content (your website or help center for example). Alternatively, you can quickly fill the information gap by adding the question and answer in Custom Content (Bots > Source Data > Custom Content). ### If the AI bot provides an inaccurate response You can add an answer correction to fix inaccurate responses. Head over to your inbox. You can view all conversations from the Playground there. Locate the inaccurate response in the chatlog and click on Add Correction. Add the correct answer to the question. Your AI bot will now provide an accurate response to that question. Test the question again in the playground to verify. Once you are satisfied with the AI's answers, you're all set to add Superseek to your website. ## Step 4: Go live! Add Superseek to your website to start answering customer queries right away. Go to the **Share** tab (Bots > Manage > Share), copy the widget code snippet, and paste it just before the \ tag to add the chat widget to your website. # AI Knowledge Base Learn how to add, manage, disable, or delete content from your AI chatbot's knowledge base. Your AI bot will provide answers based only on the knowledge you provide. The more detailed and relevant the content you add to the AI's knowledge base, the better the answers it can generate. You can add your entire website, individual web pages, help docs, documents, and plain text. {% content-ref url="/pages/p94ZlXBOmGbWAiKlSoTT" %} [Add your website content](/home/using-superseek/ai-knowledge-base/add-your-website-content) {% endcontent-ref %} {% content-ref url="/pages/2maUZdYth2NSQ8xZREt0" %} [Add your help content](/home/using-superseek/ai-knowledge-base/add-your-help-content) {% endcontent-ref %} {% content-ref url="/pages/5e4SXMhj9omth8PDCqvV" %} [Add your documents](/home/using-superseek/ai-knowledge-base/add-your-documents) {% endcontent-ref %} {% content-ref url="/pages/H822adLsJRPiYCNXOFpr" %} [Add custom content](/home/using-superseek/ai-knowledge-base/add-custom-content) {% endcontent-ref %} {% content-ref url="/pages/oH1NI3TDx8MCZt3rEtPc" %} [Add answer correction](/home/using-superseek/ai-knowledge-base/add-answer-correction) {% endcontent-ref %} {% content-ref url="/pages/eIoHagbxJ5eSL3iq0j3l" %} [Delete content](/home/using-superseek/ai-knowledge-base/delete-content) {% endcontent-ref %} # Add your website content **Step 1:** To add your website, go to Bots, choose the AI bot you'd like to add content to, and click on Manage.
**Step 2:** In Source Data > Website Content, click on Manage. In the popup, add your website link in **Import entire website** to add your entire website. {% hint style="info" %} You can add multiple websites at the same time. Click on the + button to add more. {% endhint %}
If you'd like to add only one or a small number of individual web pages, you can add the links to **Import Individual pages**. {% hint style="info" %} It's unlikely that Superseek will be able to ingest pages with infinite scroll. {% endhint %} **Step 3:** Sit back € relax while Superseek indexes your web content. You can head over to other pages in the product while indexing is in progress. {% hint style="info" %} The larger your website, the longer it will take to ingest all the content. You can assume an average indexing speed of 20 pages a minute. {% endhint %} Once completed, the list of pages added to your AI bot's knowledge base will be shown here. {% hint style="info" %} Disable a page to remove it from your AI bot's knowledge base. {% endhint %}
# Add your help content **Step 1:** To add your help content, go to Bots, choose the AI bot you'd like to add content to, and click on Manage.
**Step 2:** In Source Data > Website Content, click on Manage. In the Import your web content popup, scroll down to the Import Help Center section. Add the link to your help center in the right section depending on your help center tool. The following help centers are supported * Zendesk * Freshdesk * Intercom * Docusaurus * Hubspot * Help Scout {% hint style="info" %} If your help center is not built using any of the tools listed above, you can add the link in the 'Import your entire website' section above and Superseek should index it. {% endhint %} If you face any issues here, drop us an email at ** and we'll set it up for you.
# Add your documents **Step 1:** To add your documents, go to Bots, choose the AI bot you'd like to add content to, and click on Manage.
**Step 2:** In Source Data > Documents, click on Add to import your PDF content to your AI bot's knowledge base. {% hint style="info" %} We do not store the documents you add. Superseek extracts the text from the provided documents, adds it to the AI's knowledge base, and then deletes the document. This is also why documents will not be displayed as a source for an AI answer. {% endhint %} {% hint style="warning" %} Only PDFs that are 'readable’ i.e. you can highlight the text in it and copy and paste from it can be indexed. {% endhint %}
# Add custom content Learn how to add custom content (plain text) to your AI bot's knowledge base. Custom content is a great way to quickly add information to your AI's knowledge base. **Step 1:** To add custom content, go to Bots, choose the AI bot you'd like to add content to and click on Manage.
**Step 2:** In Source Data > Custom Content, click on Add to instantly add plain text content to your AI bot's knowledge base. {% hint style="info" %} Both the title and content are indexed. Adding a relevant title will help your AI bot generate accurate responses. {% endhint %} {% hint style="info" %} You can add up to 2000 characters of text with each piece of custom content {% endhint %}
You can edit or delete custom content by clicking on the Edit or Delete buttons shown.
# Add answer correction Learn how to correct an inaccurate AI response so it responds correctly the next time. AI is great, but it's not without its faults. It can sometimes generate inaccurate responses. Follow these steps to correct an AI response so your bot provides an accurate response the next time. ## Adding an answer correction **Step 1:** Head over to your Inbox and go to the AI response that needs to be corrected. Click on 'Add Correction' at the bottom of the answer.
Add the correct answer for that question and click Save.
The question and corrected answer will be added to your AI bot's knowledge base. The AI bot will use the corrected answer the next time the question is asked. {% hint style="warning" %} We strongly recommend rectifying the source content responsible for the inaccurate response too. {% endhint %} All answer corrections can be found at Bots > Manage > Source Data > Corrections. # Delete content ## Delete website or help center content from your AI's knowledge base To delete website or help center content from your AI's knowledge base, head over to Bots > Source Data > Website Content. Click on Manage and then click on the Delete button next to the website/ web page/ help center links you'd like to delete. {% hint style="success" %} Deleted content is removed from your AI's knowledge base instantly. {% endhint %}
## Delete documents/ custom content/ answer corrections from your AI's knowledge base Head over to the relevant page in Bots > Source Data and click on the Delete button to remove it instantly.
{% hint style="success" %} Deleted content is removed from your AI's knowledge base instantly. {% endhint %} # AI Settings Head over to Bots > Manage > Settings > General to configure the AI bot's name, give it custom instructions, change the AI model, and more.
{% content-ref url="/pages/gAb2sneDczuV9vVd8Jfp" %} [Customize AI instructions](/home/using-superseek/ai-settings/customize-ai-instructions) {% endcontent-ref %} {% content-ref url="/pages/6wChhRDQwiZFbHlkHJUK" %} [Change AI model](/home/using-superseek/ai-settings/change-ai-model) {% endcontent-ref %} # Customize AI instructions AI instructions make up the prompt your AI bot uses to generate responses. Use our default instructions or create your own. The instructions (the prompt) you provide your AI bot dictate its role, personality, and how it interacts. You can either use our default instructions or provide your own. Head to **Bots > Manage > Settings > General**. You will find the default instructions we've provided here. {% hint style="info" %} Make sure to add your company or product name and a brief about what the company or product does in the provided fields. This helps improve your AI bot's responses. {% endhint %} The default instructions automatically incorporate your AI bot's name, your company or product name, the bot's role, and a brief about what your company or product does.
If you would like to provide custom instructions, simply disable '*Use our default instructions*' and add your own. # Change AI model Superseek offers the latest AI models from OpenAI. You can change the AI model your AI bot uses anytime. The AI model dictates the quality of your AI bot's responses. You can pick between the latest models from OpenAI. The default AI model is GPT-3.5-turbo. To change your AI model, head to **Bots > Manage > Settings > General > AI model.**
{% hint style="info" %} Superior AI models cost more AI credits per response. One GPT-3.5-turbo response costs 1 AI credit whereas one GPT-4-turbo response costs 15 AI credits. {% endhint %} # Customize Appearance Customize the colors, welcome message, bot logo, and starter questions. You can customize the theme colors, bot logo, welcome message, and starter questions to suit your brand. Head over to **Bots > Manage > Settings > Appearance** to customize.
# Fallback, Routing € Human Handoff Learn how to configure your AI bot to handle situations where it doesn't have an answer or the question requires human intervention. Occasionally, your AI bot might not have a fitting response, such as when there's insufficient data, or when human intervention becomes necessary—like when an AI response is rated unhelpful or when a user requests to converse with a person. Tailor how the bot manages these scenarios. You can * Set a fallback (I don't know) response * Transfer the conversation to a person through your existing live chat provider * Use routing buttons to guide users to a specific link (to create a ticket or to schedule time for example) or a predefined message (call us at +xx yy zz yy zz for example) * All of the above together
# Add Fallback Response A fallback response is the canned response your AI bot should provide when it doesn't have a relevant answer. When your AI bot doesn't have a relevant answer, you can configure the fallback *(I don't know)* response your AI bot should provide. A fallback response is provided when * there isn't enough information in the source data to provide a relevant answer or * an answer is marked unhelpful To configure your AI bot's fallback response, head to Bots > Manage > Settings > Routing. You can edit the fallback response here.

Configure your fallback response

# Handoff to live chat Superseek serves as the first line of support for customer queries. However, there are instances when customers need to or may prefer speaking to a person. With human handoff, you can provide customers or visitors the option to seamlessly switch between conversing with the AI and connecting with a member of your team via your current live chat tool. ## How handoff to live chat works If handoff to live chat is enabled, here are the scenarios when the option to transfer the conversation to live chat is provided * the bot doesn't have a relevant answer or * an answer is marked unhelpful or * your customer requests to talk to a human (for example, by typing *'I want to talk to a person'*) In these scenarios, Superseek will provide the option to transfer the chat to your current live chat tool. Clicking on it will instantly close Superseek and open your live chat tool.
#### The following live chat tools are supported * Intercom * Zendesk * Hubspot * Freshchat * Tidio * Crisp * Tawk.to ## How to configure human handoff Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section and enable it.
Customize the text for the button that your customers should click to transfer to live chat. Select your live chat provider and click 'Connect'. Insert your live chat tool's website widget embed code and click 'Connect' to activate human handoff. {% hint style="info" %} Here's how you can get the embed code for [Zendesk](https://docs.superseek.ai/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-zendesk#where-can-i-find-my-zendesk-embed-script), [Intercom](/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-intercom), [Freshchat](https://docs.superseek.ai/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-freshchat#where-can-i-find-my-freshchat-embed-code), [Hubspot](https://docs.superseek.ai/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-hubspot#where-can-i-find-my-hubspot-tracking-code), [Crisp](https://docs.superseek.ai/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-crisp#where-can-i-find-my-crisp-embed-code), [Tidio](https://docs.superseek.ai/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-tidio#where-can-i-find-my-tidio-installation-code), and [Tawk.to](https://docs.superseek.ai/home/using-superseek/fallback-routing-eur-human-handoff/handoff-to-live-chat/handoff-to-tawk.to#where-can-i-find-my-tawk.to-widget-code). {% endhint %}
Human handoff is now set up. Head over to the playground, ask a question that the bot will not have an answer to, and click on the handoff button to test the integration. # Handoff to Intercom Follow these steps to set up human handoff to Intercom live chat If you use Intercom as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Intercom. ## Enable Human Handoff to Intercom Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Intercom and click 'Connect'.
Paste the Intercom website widget code and click on 'Connect' to activate human handoff to Intercom live chat.
## Where can I find my Intercom Embed Code? #### In Intercom, head over to Settings.
#### Click on Installation
#### In Web, scroll down to copy the code snippet.
Paste this code snippet in Superseek to activate human handoff to Intercom live chat. # Handoff to Zendesk If you use Zendesk as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Zendesk. ## Enable Human Handoff to Zendesk Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Zendesk and click 'Connect'.
Paste the Zendesk web widget embed script and click 'Connect' to activate human handoff to Zendesk live chat. ## Where can I find my Zendesk Embed Script? Please [refer to this article from Zendesk](https://support.zendesk.com/hc/en-us/articles/4408881932698-Adding-the-Zendesk-Chat-widget-to-your-website#:~:text=From%20the%20dashboard%2C%20select%20Settings,the%20closing%20.) to get your embed script. # Handoff to Hubspot Follow these steps to set up human handoff to Intercom live chat If you use Hubspot as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Hubspot. ## Enable Human Handoff to Hubspot Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Hubspot and click 'Connect'.
Paste the Hubspot tracking code and click 'Connect' to activate human handoff to Hubspot live chat.
## Where can I find my Hubspot Tracking Code? #### In Hubspot, head to Conversations > Chatflows.
#### Hover over the chat widget you are using and head to More > Go to Inbox Settings.
#### Go to Tracking Code and click on I don't host my site on WordPress.
#### You will find the tracking code here. Click on Copy to copy the tracking code.
#### Paste this code snippet in Superseek to activate human handoff to Intercom live chat. # Handoff to Freshchat Follow these steps to set up human handoff to Intercom live chat If you use Hubspot as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Hubspot. ## Enable Human Handoff to Hubspot Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Hubspot and click 'Connect'.
Paste the Hubspot tracking code and click 'Connect' to activate human handoff to Hubspot live chat.
## Where can I find my Freshchat Embed Code? Please refer to [this article from Freshchat](https://crmsupport.freshworks.com/en/support/solutions/articles/50000004353-embed-the-freshchat-widget-on-your-website) to access your embed code. # Handoff to Crisp Follow these steps to set up human handoff to Intercom live chat If you use Hubspot as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Hubspot. ## Enable Human Handoff to Hubspot Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Hubspot and click 'Connect'.
Paste the Hubspot tracking code and click 'Connect' to activate human handoff to Hubspot live chat.
## Where can I find my Crisp Embed Code? Please refer to [this article from Crisp](https://help.crisp.chat/en/article/how-to-add-a-live-chat-to-my-website-10wcj3l/) to access your embed code. # Handoff to Tidio Follow these steps to set up human handoff to Intercom live chat If you use Hubspot as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Hubspot. ## Enable Human Handoff to Hubspot Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Hubspot and click 'Connect'.
Paste the Hubspot tracking code and click 'Connect' to activate human handoff to Hubspot live chat.
## Where can I find my Tidio Installation Code? You can find your unique Tidio javascript code by heading to **Settings > Channels > Live Chat > Installation** section. You can refer to [this article from Tidio](https://help.tidio.com/hc/en-us/articles/5378348485660-Install-Tidio-on-Your-Website#:~:text=You%20can%20find%20your%20unique,of%20your%20account%20creation%20tour.\&text=Clion%20the%20blue%20copy%20button,JavaScript%20code%20to%20your%20clipboard.) to access your installation code. # Handoff to Zoho SalesIQ Follow these steps to set up human handoff to Intercom live chat If you use Hubspot as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Hubspot. ## Enable Human Handoff to Hubspot Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Hubspot and click 'Connect'.
Paste the Hubspot tracking code and click 'Connect' to activate human handoff to Hubspot live chat.
## Where can I find my Zoho Installation Code? You can find your unique Tidio javascript code by heading to **Settings > Channels > Live Chat > Installation** section. You can refer to [this article from Tidio](https://help.tidio.com/hc/en-us/articles/5378348485660-Install-Tidio-on-Your-Website#:~:text=You%20can%20find%20your%20unique,of%20your%20account%20creation%20tour.\&text=Clion%20the%20blue%20copy%20button,JavaScript%20code%20to%20your%20clipboard.) to access your installation code. # Handoff to Tawk.to Follow these steps to set up human handoff to Tawk.to live chat. If you use Hubspot as your live chat tool, follow these steps to provide customers the option to seamlessly switch between conversing with your Superseek AI bot and connecting with a member of your team via Hubspot. ## Enable Human Handoff to Hubspot Head over to Bots > Manage > Settings > Routing. Navigate to the 'Enable handoff to Live Chat' section. Select Hubspot and click 'Connect'.
Paste the Hubspot tracking code and click 'Connect' to activate human handoff to Hubspot live chat.
## Where can I find my Tawk.to widget code? Head over to the ⚙️ Administration panel by selecting the gear icon in the upper tab menu. Then, under Channels, select Chat Widget. The \ Widget Code will be on the right. You can refer to [this article from Tawk.to](https://help.tawk.to/article/adding-a-widget-to-your-website) to access your widget code. Paste this widget code in Superseek to activate human handoff to Tawk.to live chat. # Add Routing Buttons When your AI bot doesn't have a relevant answer, it will provide a fallback response. You can optionally provide routing buttons along with every fallback response so users have a way to get in touch with you if required. ## What are routing buttons? Routing buttons can be used to **guide users to a specific link** (for eg; to create a ticket or to schedule time) or **a predefined message** (for eg; "Call us at +1 123 456 789 between 9 am and 5 pm") when a fallback response is triggered. Routing buttons are displayed along with the fallback response you've provided. {% hint style="info" %} You can add any number of routing buttons. They will be displayed together. {% endhint %} Here's an example of the AI bot responding with a canned response when the user clicks 'Call Us'.
## Adding Routing Buttons To add routing buttons, head to **Bots > Manage > Settings > Routing** and scroll down to the Routing buttons section.
Click on 'Enable Routing Buttons' to activate routing buttons. To add a button, fill in the following fields. **Route to:** Select the department or routing category. This is for your internal use and will not be displayed to users. **Button text:** Provide the text for the routing button. **Action on click:** Select what should happen when a user clicks on the button - whether it should open a link in a new tab or the bot should display a canned response. **Enter link to open / Enter canned response to show:** If you selected 'Open link', add the link you'd like to direct the user to. If you selected 'Canned Response', add the message you'd like to display. Click on Save. The routing button will not be displayed when a fallback (I don't know) response is triggered. To delete a routing button, simply click on the delete icon. # Lead Forms Learn how to create custom lead forms that show at a specified point in the conversation. Create fully customized lead forms to capture user details at a specified point during the conversation. You can add any number of fields (such as name, email address, company name, etc.) and configure the lead form to display at the start, after a specific number of questions, or only when the bot doesn't have an answer.

Lead form in Superseek

### How to create a lead form To create a lead form, head on over to **Bots > Manage > Settings > Lead Forms**.
Enable lead form for your bot. And then fill out the fields. **Title Message:** Add a title message for your lead form **Field Type:** Select from text, email, or number as field types. The form includes basic validation, like ensuring proper email format for entries in the email field. **Label:** Edit the label (first name, phone number, company, etc.,) for the field. **Mark as mandatory:** You can optionally mark certain fields as mandatory. Users must complete these fields to proceed. **Add or Delete Field:** You can add any number of fields to your lead form. Click on the delete icon to remove a field. **Data consent:** Optionally collect user data consent for compliance. Enable 'Require data consent' and include a consent message. **Display lead form:** Choose when you'd like the lead form to show up - at the start, after a specific number of questions, or only when the bot doesn't know the answer. If you choose *'when the bot doesn't know the answer'*, the lead form will show up along with the fallback response. **Require form submission to continue:** Enable this if you want to make form submission mandatory to start or continue the conversation. ## View and download the list of captured leads Head over to Inbox > Leads to view and download the list of captured leads. Filter by time and click on the download icon on the top to download a .csv file with the leads. # Inbox You can stay on top of all your bot's conversations in Inbox.
We will be adding additional filtering and analytics capabilities to the Inbox soon. # Install chat widget To install your AI chatbot on your website, head over to **Bots > Manage > Share > Install Chat Widget.** Paste the code snippet just before the \ tag to add the chat widget to your website.
If you face any issues here, drop us a mail at ** and we're happy to do it for you. # Improve AI answers Here are a couple of things you can do to improve the quality of your AI bot's answers and responses. We've listed down a couple of things you can do to improve the quality of your AI bot's responses. If you need help along the way, feel free to reach out to us at ** and we'll work with you to improve your AI bot. ## Tweak AI Instructions (the prompt) If you're using our default instructions, ensure you've filled out the Company Name and A Brief About Your Company sections (in Bots > Manage > Settings > General). This helps your AI bot understand who it's working for and what your company or product does and improves its responses.

Add company name and company description for better answers

You can also try editing the AI instructions to better convey to the AI bot how you would like it to answer or behave and how it shouldn't. The more clarity you can give it, the better. ## Add Relevant Content Your AI bot will answer based only on the content you provide it. If it's unable to provide answers or is generating inaccurate answers, it could be because it doesn't have enough relevant information in its source data. For no or incorrect responses, check if the source content contains the information needed to provide an accurate response. If not, please fill the information gap. Also, check for conflicting pieces of information in the AI's source data. For example, if two web pages (or maybe a web page and document) have different answers for the same question, we recommend that you update the content there. ## Add Corrections If you're not satisfied with a particular response your AI bot provided, you can visit the Inbox, and add a correction for that answer from there.
The next time the same (or similar) question is asked, the AI bot will respond accurately. You can track all corrections in Bots > Manage > Source Data > Corrections. ## Increase Similarity Threshold When a question is asked, your AI bot locates up to four best-match chunks of information that are required to generate a response. For more information about how this works, check out [How Superseek Works](/home/getting-started/how-superseek-works). Increase the similarity threshold to further limit which chunks meet the best-match criteria, thereby limiting the AI bot from using lower-quality chunks to generate an answer. While this may improve response quality for some specific questions, we do not recommend keeping it too high as it might limit performance for more general questions. ## Upgrade AI Model If you're using GPT-3.5-turbo, try changing the AI model to GPT-4-turbo and test the answers. GPT-4-turbo is significantly better than GPT-3.5-turbo at understanding context and following instructions. Note that higher models cost more, so make sure you've tried all other fixes and need a higher-quality model before making the change. # Usage Limits The usage limits depend on your plan. There are limits on the number of AI answer credits per month, the amount of source data you can add to your bot's knowledge base, and the auto-sync frequency of your source data. You can find the limits by plan on our [Pricing page](https://superseek.ai/pricing/). ### What happens if I exceed the limits? **Exceeding AI answer credit limit:** If you exceed the AI answer credit, the bot will default to the fallback response for every question. At this point, you can either wait until next month's cycle to refresh your AI credits quota or upgrade to a higher plan to unlock higher limits instantly. **Exceeding webpage limit in source data:** If you exceed the number of web pages (website pages, help center pages, etc.,), you can continue to use the AI bot normally, but the web pages will not auto-sync to capture new edits automatically. # Your Profile Update profile settings such as your name, email address, and password from the account tab. You can also delete your account from here. ## Update name, email address, and password. Head over to the Account tab. You can update your name, email, and password here. ## Delete your Account Head over to the Account tab and click on Delete Account. Note that account deletion is permanent and we cannot recover any data once done. # Subscription & Billing Here are some articles to help you manage your billing and subscription. {% content-ref url="/pages/fvhX7Uu3xQHAOw3un3yd" %} [Update payment card](/home/my-account/subscription-and-billing/update-payment-card) {% endcontent-ref %} {% content-ref url="/pages/40GcJTMmJ749C9s0Ykxv" %} [Download past invoices](/home/my-account/subscription-and-billing/download-past-invoices) {% endcontent-ref %} {% content-ref url="/pages/8FlLhxpCkM9SuhEnEExF" %} [Cancel Subscription](/home/my-account/subscription-and-billing/cancel-subscription) {% endcontent-ref %} # Update payment card We partner with Stripe to manage subscriptions and billing. To update your payment card, head over to the Billing tab and click on Manage Billing.
You can edit your card details on the Stripe-hosted page that loads. # Download past invoices We partner with Stripe to manage subscriptions and billing. To download your past invoices, head over to the Billing tab and click on Manage Billing.
You can download past invoices from the Stripe-hosted page that loads. # Cancel Subscription You can cancel your subscription with Superseek anytime. You will be downgraded to the Free plan at the end of the current billing cycle. We partner with Stripe to manage subscriptions and billing. To cancel your subscription, head over to the Billing tab and click on Manage Billing.
You can cancel your plan from the Stripe-hosted page that loads. {% hint style="info" %} Once you cancel your plan, you can continue to use Superseek until the end of your current month's cycle. You will be downgraded to the Free plan at the end of the cycle. {% endhint %} # API Overview Get a quick overview of Superseek APIs and see how you can build your custom Q\&A bots or fully conversational AI chatbots. With Superseek APIs, you can build custom Q\&A bots or conversational AI chatbots powered by your content. APIs are available on all plans. ## Q\&A API Q\&A bots are a basic version of chatbots. Input a single question and receive a single answer along with its sources. These bots enable the creation of straightforward Q\&A interfaces within products, leveraging the same endpoint as the chat API, but without passing any chat history. [Read more](/home/api-documentation/q-and-a-api) ## Chat API Use this endpoint to create a complete conversational chatbot in your product. Pass a question along with chat history to receive a single answer, along with its sources, that maintains context and continuity with the ongoing conversation. [Read more](broken://pages/ccaGKnZbfO0ofyDh3Quv) ## Answer Rating API The Answer Rating APIs are useful for tracking the quality of answers provided by the chat APIs. Use this endpoint to enable users to rate answers (good or bad) to track answer quality in your inbox. [Read more](broken://pages/NJ5TIY3Z0DJTUl6PKuDu) # Q\&A API Use the Q\&A API to input a single question and receive a single answer along with its sources. Q\&A bots are a basic version of chatbots. Input a single question and receive a single answer along with its sources. These bots enable the creation of straightforward Q\&A interfaces within products, leveraging the same endpoint as the chat API, but without passing any chat history. Your content should be ingested in our system for this endpoint to work. To do that, log in to our platform and add Source Data. `POST` `https://admin.superseek.ai/qa` Create a simple Q\&A interface to input a single question and receive a single answer along with its sources. Your content must be added to our platform for this endpoint to work. #### Request Body | Name | Type | Description | | ------------------------------------------ | ------ | ---------------------------- | | bot\_id\* | Number | Unique identifier of the bot | | api\_key\* | String | API key of the account | | question\* | String | The question to ask the bot | {% tabs %} {% tab title="200: OK Successful Response" %} {% code overflow="wrap" %} ```json { "chat": [ { "role": "user", "question": "What is Superseek?", "timeStamp": "Sun Jan 7 2024 15:25:47 UTC" }, { "role": "bot", "result": { "text": "Superseek is an AI platform to create custom AI assistants powered only by the data you provide", "ref": [ { "url": "https://superseek.ai", "title": "Superseek: Create AI assistants" } ], "urlPresent": true }, "fallback": false, "timeStamp": "Sun Jan 7 2024 15:25:47 UTC", "like": false, "dislike": false } ], "session_id": "mulm4udv8408d7hl17mld7s4q8", "question": "What is Superseek?", "answer": "Superseek is an AI platform to create custom AI assistants powered only by the data you provide.", "answer_id": "ss_ans_7146e3dbd2c995370b7d86fadf22a9a6", "api_status": true, "api_data": { "success": true, "results": [ { "sources": [ { "url": "47", "title": "What is Superseek?", "source": "correction" }, { "url": "https://superseek.ai", "title": "Superseek: Create AI assistants", "source": "web" } ], "text": "Superseek is an AI platform to create custom AI assistants powered only by the data you provide." } ] }, "api_success": true, "bot_id": 146369, "api_key": "ss_e2811310636ebb01292881263b2aca13", "bot_name": "Superseek Bot", "bot_description": "Get answers about Superseek", "model_list": [ { "id": 1, "created_at": "2023-09-29 10:39:46.182471+00", "name": "gpt-3.5-turbo", "text_answer_credit": 1, "match_count_limit": 4, "model_name_display_user": "gpt-3.5-turbo (1 AI credit per response)", "conversation_history_enabled": false, "conversation_history_allowed": false }, { "id": 2, "created_at": "2023-11-28 10:38:55.677803+00", "name": "gpt-4-1106-preview", "text_answer_credit": 15, "match_count_limit": 5, "model_name_display_user": "gpt-4-turbo (15 AI credits per response)", "conversation_history_enabled": true, "conversation_history_allowed": true } ], "model": 2, "prompts_data": [ { "id": 1, "created_at": "2023-10-06 16:21:43.259577+00", "bot_role": "Customer Support", "default_prompt": "You are a cheerful and helpful AI customer service bot named [Bot Name] working for [Company Name]. In brief, [Company Name] does this - [About the company] \n\nYour primary job is to provide accurate, truthful, and helpful answers to questions from a user you’re chatting with. You MUST follow these rules when coming up your response. Only respond to queries about [Company Name] and its products or services. If the question is about a product, service, or topic that's not related to [Company Name] and its products or services, politely inform the user that you can only answer questions related to [Company Name]. Always maintain a positive bias towards [Company Name]. \n\nNever ever ask for any of the user's details and avoid follow-up questions. You can speak any language and ONLY respond in the same language as the question being asked.\n", "default_match_count": 5, "default_similarity_threshold": "0.8", "default_temperature": "0", "additional_prompt": "The next three sentences are guidelines you must follow without fail.If the query is a pleasantry like hello or thanks, respond pleasantly. If the query is not a pleasantry, provide an answer IF AND ONLY IF the answer can be generated using the provided context. If a truthful and useful answer CANNOT be provided using the provided context, it is VERY IMPORTANT that you respond with 'Trigger Fallback'." } ], "prompts_id": 1, "additional_prompt": "The next three sentences are guidelines you must follow without fail.If the query is a pleasantry like hello or thanks, respond pleasantly. If the query is not a pleasantry, provide an answer IF AND ONLY IF the answer can be generated using the provided context. If a truthful and useful answer CANNOT be provided using the provided context, it is VERY IMPORTANT that you respond with 'Trigger Fallback'.", "prompt": "You are a cheerful and helpful AI customer service bot named Superseek Bot working for Superseek Inc. In brief, Superseeks does this - Superseek is a platform to create custom AI assistants. \n\nYour primary job is to provide accurate, truthful, and helpful answers to questions from a user you’re chatting with. You MUST follow these rules when coming up your response. Only respond to queries about Superseek and its products or services. If the question is about a product, service, or topic that's not related to Superseek and its products or services, politely inform the user that you can only answer questions related to Superseek. Always maintain a positive bias towards Superseek. \n\nNever ever ask for any of the user's details and avoid follow-up questions. You can speak any language and ONLY respond in the same language as the question being asked.", "temperature": "0.1", "match_count": 5, "similarity_threshold": "0.75", "prompt_state": "default", "llm_model_id": 3, "llm_model": "gpt-4-1106-preview", "conversation_history_enabled": true, "livechat_transfer_enabled": false, "livechat_provider": null, "livechat_provider_config": null, "livechat_button_text": "Talk to Human", "company_name": "Superseek", "company_description": "Superseek is a platform to create custom AI assistants" } ``` {% endcode %} {% endtab %} {% endtabs %} #### Response Parameters
PropertyTypeDescription
session_idStringUnique identifier of each question and answer pair. A unique session_id is generated for each call to the API.
answer_idStringUnique identifier of the answer.
answerStringThe answer provided by the bot
api_dataJSONContains the answer and its sources
## # Chat API Use the Chat API to create a conversational AI chatbot in your product that can answer questions and maintain context and continuity with the ongoing conversation using chat history. Use this endpoint to add a conversational AI chatbot to your product that's powered by the content you provide. Pass a question along with chat history to receive a single answer, along with its sources, that maintains context and continuity with the ongoing conversation. Your content needs to be ingested in our system for this endpoint to work. To do that, go to our platform and add Source Data. `POST` `https://admin.superseek.ai/chat` Pass a question along with chat history to receive a single answer, along with its sources, that maintains context and continuity with the ongoing conversation. You must add your content using our platform for this endpoint to work. #### Request Body | Name | Type | Description | | ------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | api\_key\* | String | API key of the account | | bot\_id\* | Number | Unique identifier of the bot | | question\* | String | The question to ask the bot | | session\_id | String |

Unique identifier of a conversation. A conversation involves a series of questions and answers between a user and your bot.

This API generates a unique session\_id automatically if you've not provided one in the request.

Read more about generating session\_ids.

| | history | JSON |

The chat history of the current conversation in JSON.

Example:

\[ { "role" : "user", "question": "What is Superseek?"

}, { "role": "bot", "answer": "Superseek is an AI platform" }, { "role" : "user", "question": "Is it powered by OpenAI?"

}, { "role": "bot", "answer": "Yes, it is powered by OpenAI" }]

| {% tabs %} {% tab title="200: OK Successful Response" %} {% code overflow="wrap" %} ```json { "chat": [ { "role": "user", "question": "Is it powered by OpenAI?", "timeStamp": "Mon Jan 8 2024 12:53:11 UTC" }, { "role": "bot", "result": { "text": "Yes, its powered by OpenAI", "ref": [ { "url": "https://superseek.ai", "title": "Superseek: Create AI assistants" } ], "urlPresent": true }, "fallback": false, "timeStamp": "Mon Jan 8 2024 12:53:11 UTC", "like": false, "dislike": false } ], "session_id": "SpHw8LknOEKrnbmwTQfiBhsiN7bRzoWXF3RVadkF", "question": "Is it powered by OpenAI?", "answer": "Yes, its powered by OpenAI", "answer_id": "ss_ans_bf7c2bfc1ded69f492c1673f5bbf3dac", "history_input": [ { "role": "user", "question": "What is Superseek?" }, { "role": "bot", "answer": "Superseek is a platform to create custom AI assistants." } ], "history": " q:What is Superseek? a:Superseek is a platform to create custom AI assistants.", "api_status": true, "api_data": { "success": true, "results": [ { "sources": [ { "url": "47", "title": "Is superseek powered by OpenAI?", "source": "correction" }, { "url": "https://superseek.ai", "title": "Superseek: Create AI assistants", "source": "web" } ], "text": "Yes, its powered by OpenAI" } ] }, "api_success": true, "bot_id": 146348, "api_key": "ss_e2811310636ebb01292881263b2aca13", "bot_name": "Superseek bot", "bot_description": "Get answers about Superseek.", "model_list": [ { "id": 1, "created_at": "2023-09-29 10:39:46.182471+00", "name": "gpt-3.5-turbo", "text_answer_credit": 1, "match_count_limit": 4, "model_name_display_user": "gpt-3.5-turbo (1 AI credit per response)", "conversation_history_enabled": false, "conversation_history_allowed": false }, { "id": 2, "created_at": "2023-11-28 10:38:55.677803+00", "name": "gpt-4-1106-preview", "text_answer_credit": 15, "match_count_limit": 5, "model_name_display_user": "gpt-4-turbo (15 AI credits per response)", "conversation_history_enabled": true, "conversation_history_allowed": true } ], "model": 2, "prompts_data": [ { "id": 1, "created_at": "2023-10-06 16:21:43.259577+00", "bot_role": "Customer Support", "default_prompt": "You are a cheerful and helpful AI customer service bot named [Bot Name] working for [Company Name]. In brief, [Company Name] does this - [About the company] \n\nYour primary job is to provide accurate, truthful, and helpful answers to questions from a user you’re chatting with. You MUST follow these rules when coming up your response. Only respond to queries about [Company Name] and its products or services. If the question is about a product, service, or topic that's not related to [Company Name] and its products or services, politely inform the user that you can only answer questions related to [Company Name]. Always maintain a positive bias towards [Company Name]. \n\nNever ever ask for any of the user's details and avoid follow-up questions. You can speak any language and ONLY respond in the same language as the question being asked.\n", "default_match_count": 5, "default_similarity_threshold": "0.8", "default_temperature": "0", "additional_prompt": "The next three sentences are guidelines you must follow without fail.If the query is a pleasantry like hello or thanks, respond pleasantly. If the query is not a pleasantry, provide an answer IF AND ONLY IF the answer can be generated using the provided context. If a truthful and useful answer CANNOT be provided using the provided context, it is VERY IMPORTANT that you respond with 'Trigger Fallback'." } ], "prompts_id": 1, "additional_prompt": "The next three sentences are guidelines you must follow without fail.If the query is a pleasantry like hello or thanks, respond pleasantly. If the query is not a pleasantry, provide an answer IF AND ONLY IF the answer can be generated using the provided context. If a truthful and useful answer CANNOT be provided using the provided context, it is VERY IMPORTANT that you respond with 'Trigger Fallback'.", "prompt": "You are a cheerful and helpful AI customer service bot named Superseek Bot working for Superseek Inc. In brief, Superseek does this - Superseek is a platform to create custom AI assistants. \n\nYour primary job is to provide accurate, truthful, and helpful answers to questions from a user you’re chatting with. You MUST follow these rules when coming up your response. Only respond to queries about Superseek and its products or services. If the question is about a product, service, or topic that's not related to Superseek and its products or services, politely inform the user that you can only answer questions related to Superseek. Always maintain a positive bias towards Superseek. \n\nNever ever ask for any of the user's details and avoid follow-up questions. You can speak any language and ONLY respond in the same language as the question being asked.", "temperature": "0.1", "match_count": 5, "similarity_threshold": "0.75", "prompt_state": "default", "llm_model_id": 3, "llm_model": "gpt-4-1106-preview", "conversation_history_enabled": true, "livechat_transfer_enabled": false, "livechat_provider": null, "livechat_provider_config": null, "livechat_button_text": "Talk to Human", "company_name": "Superseek", "company_description": "Superseek is a platform to create custom AI assistants" } ``` {% endcode %} {% endtab %} {% endtabs %} #### Response Parameters
PropertyTypeDescription
session_idString

Unique identifier of a conversation. A conversation involves a series of questions and answers between a user and your bot.

This API generates a unique session_id automatically if you've not provided one in the request. Read more about generating session_ids.

answer_idStringUnique identifier of the answer.
answerStringThe answer provided by the bot
api_dataJSONContains the answer and its sources
{% hint style="warning" %} Conversation history is not supported for GPT-3.5-turbo as the context window is not large enough. {% endhint %} # Answer Rating API Use the answer rating API to track the ratings for the bot's answers. The Answer Rating API is useful for tracking quality metrics related to the bot's responses. Use this endpoint to enable users to rate answers (good or bad) and track it in your inbox. `POST` `https://admin.superseek.ai/answer-rating` Use this endpoint to enable users to rate answers (good or bad) and track it in your inbox. #### Request Body | Name | Type | Description | | -------------------------------------------- | ------ | -------------------------------------------------------- | | api\_key\* | String | API key of the account | | bot\_id\* | Number | Unique identifier of the bot | | answer\_id\* | String | The unique identifier of each answer provided by the bot | | rating\* | Number | Pass 1 for a good rating and -1 for a bad rating | {% tabs %} {% tab title="200: OK Successful Response" %} {% code overflow="wrap" %} ```json { "chat": [ { "role": "user", "question": "What is Superseek?", "timeStamp": "Mon Jan 8 2024 12:53:11 UTC" }, { "role": "bot", "result": { "text": "Superseek is a platform to create custom AI assistants.", "ref": [ { "url": "https://superseek.ai", "title": "Superseek: Create AI assistants" } ], "urlPresent": true }, "fallback": false, "timeStamp": "Mon Jan 8 2024 12:53:11 UTC", "like": true, "dislike": false } ], "rating": "1" } ``` {% endcode %} {% endtab %} {% endtabs %} # Generate Session ID API Generate a unique session\_id for a conversation. Use this endpoint if you'd prefer to generate and manage session\_ids for bot conversations. `GET` `https://admin.superseek.ai/session-id` Use this endpoint if you'd prefer to generate and manage session\_ids for bot conversations. #### Query Parameters | Name | Type | Description | | ------------------------------------------ | ------ | ---------------------------- | | bot\_id\* | Number | Unique identifier of the bot | | api\_key\* | String | API key of the account | {% tabs %} {% tab title="200: OK Successful Response" %} {% code overflow="wrap" %} ```json // Below is the generated session_id a3ip87gkr2jh580fptg0i67m3p ``` {% endcode %} {% endtab %} {% endtabs %}