- API Reference
- Get Started
- Authentication
- Endpoints
- V3 API
- Legacy APIs
- Agents
- Introduction
- GETGet Agent
- POSTCreate/Edit Agent
- DELDelete Agent
- POSTChat Interact
- POSTConfigure State
- GETGet Single KB Doc
- PUTCreate/Edit KB Doc
- DELDelete KB Doc
- GETGet KB Docs
- POSTSearch KB Docs
- POSTSearch Vector DB
- GETGet KB Stats
- GETGet All Convos
- GETExport Convos
- POSTCreate/Edit Convo
- DELDelete Convo
- GETGet All Analytics
- GETGet Convo Analytics
- POSTCreate/Edit Analytics
- DELDelete Convo Analytics
- DELDelete All Analytics
- Workspaces
Get All Convos
Returns agent conversations (metadata only)
curl --request GET \
--url https://eu-vg-edge.moeaymandev.workers.dev/v2/agents/{agent_id}/convos \
--header 'Authorization: Bearer <token>'
{
"success": true,
"message": "Agent conversations retrieved successfully",
"data": [
{
"ID": "<string>",
"userID": "<string>",
"userName": "<string>",
"userEmail": "jsmith@example.com",
"userImage": "<string>",
"userPhone": "<string>",
"userBrowser": "<string>",
"userProfilePic": "<string>",
"origin": "web-chat",
"messagesNum": 123,
"interactionsNum": 123,
"ts": 123,
"tags": [
"<string>"
],
"convoTimeSeconds": 123,
"firstMessageTS": 123,
"lastMessageTS": 123,
"userPlatform": "<string>",
"state": "requested_chat",
"chatAssignedTo": "<string>",
"lastModified": 123,
"sessionsNum": 123
}
]
}
Authorizations
Agent/Workspace secret API key as bearer token.
Path Parameters
The ID of the agent to retrieve its conversations
Query Parameters
Page of the results to return, default is 1, query per page is 20
Response
true
"Agent conversations retrieved successfully"
Array of conversations objects
ID of the conversation.
User ID.
User's name.
User's email address.
URL to user's profile image.
User's phone number.
User's browser information.
URL to user's profile picture.
Channel origin of the message.
web-chat
, whatsapp
, discord
, gb-chat
Number of messages in the conversation.
Number of interactions in the conversation.
Timestamp of the conversation.
Tags associated with the conversation.
Duration of the conversation in seconds.
Timestamp of the first message.
Timestamp of the last message.
User's platform (e.g., mobile, desktop).
Type of action to perform, launch type doesn't require a payload
requested_chat
, human-chatting
, ai-chatting
, ended_chat
ID of the human agent (client_id) assigned to the conversation.
Timestamp of the last modification.
Number of sessions in the conversation.
curl --request GET \
--url https://eu-vg-edge.moeaymandev.workers.dev/v2/agents/{agent_id}/convos \
--header 'Authorization: Bearer <token>'
{
"success": true,
"message": "Agent conversations retrieved successfully",
"data": [
{
"ID": "<string>",
"userID": "<string>",
"userName": "<string>",
"userEmail": "jsmith@example.com",
"userImage": "<string>",
"userPhone": "<string>",
"userBrowser": "<string>",
"userProfilePic": "<string>",
"origin": "web-chat",
"messagesNum": 123,
"interactionsNum": 123,
"ts": 123,
"tags": [
"<string>"
],
"convoTimeSeconds": 123,
"firstMessageTS": 123,
"lastMessageTS": 123,
"userPlatform": "<string>",
"state": "requested_chat",
"chatAssignedTo": "<string>",
"lastModified": 123,
"sessionsNum": 123
}
]
}