Owlbot.AI API
Search
K
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.

Endpoint

The endpoint to access this history summary is working with a GET request :
https://www.owlbot.ai/api/chatbot/[id]/conversation
Remember to use the API Token in the headers as show in the Authentication section.
The required parameters are :
Property
Type
Description
[id]
uuid
Chatbot UUID you want to have chat history from
remember to find your chatbot UUID after listing all your chatbot as shown in previous section.

Example of Response

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