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
Create Thread
Create an empty thread of the chatbot.
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
Message of a 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 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
Chatbot Quick Prompt
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
}
}
}