API Documentation
Chatbot Appearance
Chatbot Custom Content
Chatbot Follow Up Prompts
Chatbot Icons
Chatbot Links
Chatbot Messages
Chatbot Personas
Chatbot Prompts
Chatbot Quick Prompts
Chatbot Settings
Chatbot Threads
Fetch All Chatbots
Fetch all the chatbots
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Delimeter to identify multiple values in other parameters
Array of keys to be searched in metadata (separated by delimeter)
Array of values to be searched against above metadata keys (separated by delimeter)
Response
Success Response
Data returned from the server
List of chatbots
Email of the user that created this chatbot
Id of the user that created this chatbot
Custom content of the chatbot
Description of the chatbot
Id of the chatbot
Follow-up prompts of the chatbot
Description of the follow-up-prompt. This is the message that will be sent to the chatbot when you click on the follow-up-prompt inside the chatbot.
Id of the follow-up prompt.
Indicates whether the follow-up prompt is escalation prompt or not.
Link of the follow-up prompt. If this link is not null, then when you click on the follow-up prompt in the chatbot, this link will be opened instead of sending a message to the chatbot.
Title of the follow-up-prompt. This is the text that is shown as button in the chatbot.
List of prompts set by the user
Short description of the prompt
Id of the prompt
Actual instructions of the prompt. These will be sent to Open AI.
Decides creativity level of the chatbot response. 0 is more focused and 1 is more creative/random.
0 < x < 1
Must be a multiple of 0.01
Title of the prompt
Settings of the chatbot
Url reference of the Agent icon
Delay after which the chat window will shown in desktop when autoOpenChatWindowInDesktop is set to AUTO_OPEN_WITH_DELAY
Delay after which the chat window will shown in mobile when autoOpenChatWindowInMobile is set to AUTO_OPEN_WITH_DELAY
Option to handle behaviour auto open chat window in desktop
ALWAYS_OPEN_WITH_DELAY
, DONT_OPEN
Option to handle behaviour auto open chat window in mobile
ALWAYS_OPEN_WITH_DELAY
, DONT_OPEN
Primary color of the chatbot
Primary text color of the chatbot
Url reference of the Chat Buuble icon
Options whether to collect user details or not
MANDATORY
, OPTIONAL
, DO_NOT_COLLECT
Options of the creativity for the chatbot
restricted
, conservative
, creative
, custom
Call to Action Link
Call to Action text
Option to disable email notifications for new lead captures.
Option to disable smart followup questions generated by SiteGPT.
Distance from bottom (in px) where the chatbot icon should be shown
Any extra data you want to add to your chatbot.
Font size of the text shown in chatbot (in px)
All available GPT models
gpt-3.5-turbo
, gpt-4
Height of the chatbot
Indicates whether to hide feedback buttons (for each reply) or not in the chatbot
Indicates whether to display sources or not in the chatbot
Indicates whether to hide tooltip or not in the chatbot
Indicates whether the watermark is shown in the chatbot or not
Number of history messages to be considered when answering the question
0 < x < 50
Must be a multiple of 1
Horizantal distance (in px) where the chatbot icon should be shown
Possible options for icon position of the chatbot
LEFT
, RIGHT
Possible options foe icon size of the chatbot
SMALL
, MEDIUM
, LARGE
, XL
, 2XL
, 3XL
, 4XL
, 5XL
Url reference of the Bot icon
Localization settings of the chatbot
Localization settings for account screen in the chatbot
Localization settings for home screen in the chatbot
Localization settings for individual conversations in the chatbot
Localization settings for messages screen in the chatbot
Localization option for Learn more
option
Max width of the chatbot
Any metadata (key-value pairs) that you can assign to the chatbot. Key should be string and Value could be anything.
Mode of the chat
AI
, AGENT
Url reference of the User/person icon
Placeholder text that users see before they type their question in the chat
Selected promptId that will be used as prompt to generate Open AI response
Indicates whether to display the text in the chatbot right to left or opposite
Number of smart follow up questions to be shown when enabled.
1 < x < 5
Must be a multiple of 1
Use this to change the tone of your chatbot and also give any additional instructions
Creativity meter of the chatbot. This is valid only when creativity of the chatbot is custom
0 < x < 2
Must be a multiple of 0.01
This tooltip will be shown on the top of chatbot icon. If not set, welcome message will be shown as tooltip
Number of relevant chunks to be fetched for answering the question
1 < x < 5
Must be a multiple of 1
Use this to change the instructions you give to your chatbot in the user prompt
Url reference of the Watermark icon
Url of the watermark to be shown in the chatbot
Text to be shown as the watermark in the chatbot
This is the global webhook token that is sent in header in the calls made to the above webhook url for all messages if token is not configured at thread level
All messages are sent to this global webhook url if webhook url is not configured at thread level
The first message that the users will see in the chatbot
Quick prompts of the chatbot
Description of the quick-prompt. This is the message that will be sent to the chatbot when you click on the quick-prompt inside the chatbot.
Id of the quick-prompt
Link of the quick prompt. If this link is not null, then when you click on the quick prompt in the chatbot, this link will be opened instead of sending a message to the chatbot.
Title of the quick-prompt. This is the text that is shown as button in the chatbot.
Title of the chatbot
Overall message regarding the operation performed
Indicates whether this is success response or error response
Was this page helpful?