👩‍💻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

Last updated