- Getting Started
- PATCHUpdate Chatbot Appearance
- POSTModify Chatbot Custom Content
- GETFetch All Follow Up Prompts
- POSTAdd Follow Up Prompt
- GETFetch Follow Up Prompt
- DELDelete Follow Up Prompt
- PATCHUpdate Follow Up Prompt
- GETFetch All Quick Prompts
- POSTAdd Quick Prompt
- GETFetch Quick Prompt
- DELDelete Quick Prompt
- PATCHUpdate Quick Prompt
- PATCHUpdate Chatbot Settings - Advanced
- PATCHUpdate Chatbot Settings - Chat Mode
- PATCHUpdate Chatbot Settings - General
- PATCHUpdate Chatbot Settings - Localization
- PATCHUpdate Chatbot Settings - User Data
API Documentation
Chatbot Appearance
Chatbot Custom Content
Chatbot Follow Up Prompts
Chatbot Quick Prompts
Chatbot Settings
Create Thread
Create an empty thread of the chatbot.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Id of the chatbot
If you pass the threadId, new thread will be created with this threadId. Otherwise, random threadId will be generated.
Mode of the chat
Email of the user that is going to chat in the thread.
curl --request POST \
--url https://sitegpt.ai/api/v0/chatbots/{chatbotId}/threads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"threadId": "xyz",
"mode": "AI",
"chatUserEmail": null
}'{
"success": true,
"message": "Created the chatbot thread successfully",
"data": {
"thread": {
"threadId": "d2cd2d88-bac1-48de-a7b4-19797451f47g",
"mode": "AI",
"messages": [],
"startedAt": "2024-05-07T06:26:01.674375Z",
"updatedAt": "2024-05-07T06:26:01.674375Z",
"chatUserId": null,
"chatbotId": "361628903185318481",
"chatUser": null
}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Id of the chatbot
Body
If you pass the threadId, new thread will be created with this threadId. Otherwise, random threadId will be generated.
Mode of the chat
AI, AGENT Email of the user that is going to chat in the thread.
Response
Indicates whether this is success response or error response
Overall message regarding the operation performed
Data returned from the server
Chatbot Thread
Id of the chatbot thread
Id of the chatbot
Id of the user chatting in the thread
Mode of the thread
AI, AGENT Timestamp indicating when the thread has been started
Timestamp indicating when the thread has been last updated
Timestamp indicating when the thread has been ended
Indicates whether conversation has been escalated or not
All messages are sent to this webhook url
The token which is sent in header in the calls made to the above webhook url for all messages
Messages of the thread
Id of the message
Type of the message in the thread
NORMAL_MESSAGE, USER_MESSAGE, AGENT_MESSAGE, SYSTEM_MESSAGE Type of the message if type of the message is SYSTEM_MESSAGE
CONVERSATION_ESCALATED, EXCEEDED_USAGE_LIMITS, EMAIL_VERIFIED, ENTERED_WRONG_OTP, PROVIDED_EMAIL, PERSONA_SELECTED, PROBLEMS_WITH_UPSTREAM_PROVIDER Model for question/answer in the chat
Text containing either question or the answer
Timestamp of the question asked or answer replied
Model for question/answer in the chat
Text containing either question or the answer
Timestamp of the question asked or answer replied
User's reaction to the message
POSITIVE, NEGATIVE, NEUTRAL Sources used to answer the question
Indicates whether this message is escalated or not
Url of the icon used in this message
Quick prompts that have been configured by chatbot owner
Id of the quick-prompt
Title of the quick-prompt. This is the text that is shown as button in the chatbot.
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.
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.
GPT Model used to answer the question
Number of messages that are read in this thread
Chat User
Id of the user
Name of the user
Email Id of the user
Phone Number of the user
Indicates whether the user is verified or not
Timestamp indicating when the user is created
Timestamp indicating when the user is last updated
Was this page helpful?
curl --request POST \
--url https://sitegpt.ai/api/v0/chatbots/{chatbotId}/threads \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"threadId": "xyz",
"mode": "AI",
"chatUserEmail": null
}'{
"success": true,
"message": "Created the chatbot thread successfully",
"data": {
"thread": {
"threadId": "d2cd2d88-bac1-48de-a7b4-19797451f47g",
"mode": "AI",
"messages": [],
"startedAt": "2024-05-07T06:26:01.674375Z",
"updatedAt": "2024-05-07T06:26:01.674375Z",
"chatUserId": null,
"chatbotId": "361628903185318481",
"chatUser": null
}
}
}