List Conversations API Definition
The List Conversations API lists all the conversations in a customer account. This data enables developers to monitor chatbot interactions and understand how users engage with the data. Pagination lets developers navigate through large datasets.
Conversation Object Definition
The conversation
object specifies a unique turn id
, which is the first turn
in the conversation. The unique conversation_id
then specifies the conversation
within the chat history corpus.
The num_results
(default 5) specifies the maximum number of conversations to
return, and page_key
retrieves a specific page of results. Leave it blank to
get the first page.
REST Example
List Conversations Endpoint Address
Vectara exposes an HTTP endpoint at the following URL to list conversations in the chat history corpus:https://api.vectara.io/v2/chats
The API Reference shows the full List Conversations REST definition.
gRPC Example
You can find the full List Conversations gRPC definition at chat.proto.