Comment on page
👩💻
History Summary
Once you've deployed your bot to production, you can view the questions and answers that your users are asking.
The endpoint to access this history summary is working with a GET request :
https://www.owlbot.ai/api/chatbot/[id]/conversation
The required parameters are :
Property | Type | Description |
---|---|---|
[id] | uuid | Chatbot UUID you want to have chat history from |
Response is a HTTP 200 Array with a list of JSON source object :
[
{
"id":629,
"created_at":"2023-07-31T04:46:01.920296+00:00",
"user_agent":"Mozilla/5.0 (iPhone; CPU iPhone OS 16_3 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/114.0.5735.124 Mobile/15E148 Safari/604.1",
"uuid":"e659d963-8412-4fce-b0ee-XXXXX",
"visibility":1,
"ip":"XX.136.66.XX",
"geo":{
"city":"Paris",
"region":"cdg1",
"country":"FR",
"latitude":"XX.8323",
"longitude":"XX.4075",
"countryRegion":"XXX"
},
"chatbot_uuid":"694f0f35-a082-41a8-85d5-XXXX",
"session_uuid":"d48a5374-e952-4c5f-8c0f-XXXXXXX",
"messagenbr":5
},
{///},
{///}
]
Here as the description of the details provided :
Property | Type | Description |
---|---|---|
id | number | unique identifier |
created_at | timestamp | Timedate creation of the user session |
user_agent | json | This typically includes the type and version of browser, operating system, and sometimes other information such as default language. |
uuid | Universally Unique Identifier | 128-bit number used to uniquely identify some object or entity on the internet. |
visibility | number (0, 1, 2) | usefull to filter message you have seen, archive or delete |
ip | IPV4 or IPV6 Address | IP of the user who initiate the session |
geo | json | a JSON giving you information about the user location |
chatbot_uuid | Universally Unique Identifier | UUID of corresponding chatbot |
session_uuid | Universally Unique Identifier | uuid to identiy this session |
messagenbr | number | Number of message the user sent (message from Ai chatbot are not count) |
the usefull parameters is the "session_uuid", you can use it to retreive all the message from a given session