Get Single Conversation
curl --request GET \
--url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos/{convoId} \
--header 'Authorization: Bearer <token>'{
"success": true,
"message": "<string>",
"data": {
"userEmail": "<string>",
"userName": "<string>",
"userPhone": "<string>",
"userAddress": "<string>",
"userCompany": "<string>",
"userWebsite": "<string>",
"notes": "<string>",
"userProfilePic": "<string>",
"value": 123,
"currency": "<string>",
"expectedCloseDate": "<string>",
"subIndustry": "<string>",
"source": "<string>",
"language": "<string>",
"linkedIn": "<string>",
"facebook": "<string>",
"instagram": "<string>",
"demoDate": "<string>",
"demoTime": "<string>",
"demoLink": "<string>",
"lostReason": "<string>",
"lastActivityDate": "<string>",
"ID": "<string>",
"userID": "<string>",
"campaignId": "<string>",
"userImage": "<string>",
"socialHandle": "<string>",
"isFollowingBusiness": true,
"socialVerified": true,
"userOs": "<string>",
"userBrowser": "<string>",
"ipAddress": "<string>",
"countryCode": "<string>",
"origin": "<unknown>",
"whatsappPhoneNumberId": "<string>",
"whatsappBusinessNumber": "<string>",
"whatsappDisplayPhoneNumber": "<string>",
"whatsappBusinessAccountId": "<string>",
"voiceflowV4Session": {
"sessionKey": "<string>",
"projectId": "<string>",
"environmentAlias": "<string>",
"updatedAt": 123
},
"messagesNum": 123,
"interactionsNum": 123,
"ts": 123,
"tags": [
"<string>"
],
"convoTimeSeconds": 123,
"firstMessageTS": 123,
"lastMessageTS": 123,
"userPlatform": "<string>",
"smbContact": true,
"smbContactName": "<string>",
"smbContactRemovedAt": 123,
"smbLastSeenAt": 123,
"humanClaimedAt": 123,
"humanLastRepliedAt": 123,
"pendingAiReplyAt": 123,
"chatAssignedTo": "<string>",
"handoffHistory": [
{
"requestedAt": 123,
"acceptedAt": 123,
"completedAt": 123,
"acceptedBy": "<string>",
"organizationId": "<string>",
"requestedTeamKey": "<string>",
"teamIds": [
"<string>"
],
"teamKeys": [
"<string>"
]
}
],
"isTyping": true,
"lastModified": 123,
"sessionsNum": 123,
"lang": "<string>",
"vapi": {
"cost": 123,
"callDuration": 123,
"recordingUrl": "<string>",
"callerPhoneNumber": "<string>",
"calleePhoneNumber": "<string>",
"callStatus": "<string>",
"callError": "<string>"
},
"ratingFrom5": 123,
"totalUserInteractions": 123,
"isBlocked": true,
"nodesInfo": {
"currentNode": "<string>"
},
"capturedVariables": "<unknown>",
"campaignCalls": "<array>",
"sessions": "<array>",
"endReason": "<string>",
"isTest": true,
"metrics": "<array>",
"notifyToUserId": "<string>",
"averageLatency": 123,
"voice": {
"latestSessionId": "<string>",
"listenUrl": "<string>",
"listenUrlUNIX": 123
},
"detailedCost": {
"totalCreditsConsumed": 123,
"speechGenCost": 123,
"transcriberCost": 123,
"twilioCost": 123,
"llmCost": 123
},
"summary": "<string>",
"requestedTeamKey": "<string>",
"delegatedBy": "<string>",
"delegatedAt": 123,
"lastViewed": 123,
"note": "<string>",
"assignedTo": {
"userId": "<string>",
"name": "<string>",
"email": "<string>",
"photoUrl": "<string>",
"note": "<string>",
"assignedAt": "<string>"
},
"hotScore": 123,
"crmActivities": [
{
"id": "<string>",
"title": "<string>",
"date": "<string>",
"dueDate": "<string>",
"completed": true,
"responded": true,
"firstEngaged": true,
"secondEngaged": true,
"note": "<string>",
"notesHistory": [
{
"text": "<string>",
"agentId": "<string>",
"agentName": "<string>",
"timestamp": "<string>"
}
],
"metadata": {}
}
],
"crmAlerts": {
"overdueECD": true,
"overdueActivity": true,
"staleLead": true,
"responded": true,
"newHandoffAssigned": true
},
"contactIdentityId": "<string>",
"linkedChannels": [
"<string>"
],
"crossChannelContext": "<string>",
"leadScore": 0,
"funnelStepsMatched": [],
"funnelScoreHistory": [],
"funnelNotificationSent": false,
"funnelLastEvaluated": 123,
"funnelExtractedData": {},
"funnelSummary": "<string>",
"tokenUsage": {
"cumulativeInputTokens": 123,
"cumulativeOutputTokens": 123,
"cumulativeTotalTokens": 123,
"cumulativeUsd": 123,
"lastTurnInputTokens": 123,
"lastTurnOutputTokens": 123,
"lastTurnTotalTokens": 123,
"lastTurnUsd": 123,
"lastTurnModelId": "<string>",
"lastTurnContextWindow": 123,
"lastTurnInputUsdPer1k": 123,
"lastTurnOutputUsdPer1k": 123,
"lastTurnTs": 123,
"usagePerModel": {}
},
"inboundEngagementState": {
"firstDecisionAt": 123,
"firstDecisionShouldReply": true,
"lastDecisionAt": 123,
"lastDecisionShouldReply": true,
"lastDecisionReason": "<string>",
"aiOwnedThread": true,
"ignoreThread": true
},
"title": "<string>",
"lastMessage": "<string>"
}
}Conversations
Get Single Conversation
Retrieves details of a specific conversation for the specified agent, using the V3 endpoints.
GET
/
agents
/
{agentId}
/
convos
/
{convoId}
Get Single Conversation
curl --request GET \
--url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos/{convoId} \
--header 'Authorization: Bearer <token>'{
"success": true,
"message": "<string>",
"data": {
"userEmail": "<string>",
"userName": "<string>",
"userPhone": "<string>",
"userAddress": "<string>",
"userCompany": "<string>",
"userWebsite": "<string>",
"notes": "<string>",
"userProfilePic": "<string>",
"value": 123,
"currency": "<string>",
"expectedCloseDate": "<string>",
"subIndustry": "<string>",
"source": "<string>",
"language": "<string>",
"linkedIn": "<string>",
"facebook": "<string>",
"instagram": "<string>",
"demoDate": "<string>",
"demoTime": "<string>",
"demoLink": "<string>",
"lostReason": "<string>",
"lastActivityDate": "<string>",
"ID": "<string>",
"userID": "<string>",
"campaignId": "<string>",
"userImage": "<string>",
"socialHandle": "<string>",
"isFollowingBusiness": true,
"socialVerified": true,
"userOs": "<string>",
"userBrowser": "<string>",
"ipAddress": "<string>",
"countryCode": "<string>",
"origin": "<unknown>",
"whatsappPhoneNumberId": "<string>",
"whatsappBusinessNumber": "<string>",
"whatsappDisplayPhoneNumber": "<string>",
"whatsappBusinessAccountId": "<string>",
"voiceflowV4Session": {
"sessionKey": "<string>",
"projectId": "<string>",
"environmentAlias": "<string>",
"updatedAt": 123
},
"messagesNum": 123,
"interactionsNum": 123,
"ts": 123,
"tags": [
"<string>"
],
"convoTimeSeconds": 123,
"firstMessageTS": 123,
"lastMessageTS": 123,
"userPlatform": "<string>",
"smbContact": true,
"smbContactName": "<string>",
"smbContactRemovedAt": 123,
"smbLastSeenAt": 123,
"humanClaimedAt": 123,
"humanLastRepliedAt": 123,
"pendingAiReplyAt": 123,
"chatAssignedTo": "<string>",
"handoffHistory": [
{
"requestedAt": 123,
"acceptedAt": 123,
"completedAt": 123,
"acceptedBy": "<string>",
"organizationId": "<string>",
"requestedTeamKey": "<string>",
"teamIds": [
"<string>"
],
"teamKeys": [
"<string>"
]
}
],
"isTyping": true,
"lastModified": 123,
"sessionsNum": 123,
"lang": "<string>",
"vapi": {
"cost": 123,
"callDuration": 123,
"recordingUrl": "<string>",
"callerPhoneNumber": "<string>",
"calleePhoneNumber": "<string>",
"callStatus": "<string>",
"callError": "<string>"
},
"ratingFrom5": 123,
"totalUserInteractions": 123,
"isBlocked": true,
"nodesInfo": {
"currentNode": "<string>"
},
"capturedVariables": "<unknown>",
"campaignCalls": "<array>",
"sessions": "<array>",
"endReason": "<string>",
"isTest": true,
"metrics": "<array>",
"notifyToUserId": "<string>",
"averageLatency": 123,
"voice": {
"latestSessionId": "<string>",
"listenUrl": "<string>",
"listenUrlUNIX": 123
},
"detailedCost": {
"totalCreditsConsumed": 123,
"speechGenCost": 123,
"transcriberCost": 123,
"twilioCost": 123,
"llmCost": 123
},
"summary": "<string>",
"requestedTeamKey": "<string>",
"delegatedBy": "<string>",
"delegatedAt": 123,
"lastViewed": 123,
"note": "<string>",
"assignedTo": {
"userId": "<string>",
"name": "<string>",
"email": "<string>",
"photoUrl": "<string>",
"note": "<string>",
"assignedAt": "<string>"
},
"hotScore": 123,
"crmActivities": [
{
"id": "<string>",
"title": "<string>",
"date": "<string>",
"dueDate": "<string>",
"completed": true,
"responded": true,
"firstEngaged": true,
"secondEngaged": true,
"note": "<string>",
"notesHistory": [
{
"text": "<string>",
"agentId": "<string>",
"agentName": "<string>",
"timestamp": "<string>"
}
],
"metadata": {}
}
],
"crmAlerts": {
"overdueECD": true,
"overdueActivity": true,
"staleLead": true,
"responded": true,
"newHandoffAssigned": true
},
"contactIdentityId": "<string>",
"linkedChannels": [
"<string>"
],
"crossChannelContext": "<string>",
"leadScore": 0,
"funnelStepsMatched": [],
"funnelScoreHistory": [],
"funnelNotificationSent": false,
"funnelLastEvaluated": 123,
"funnelExtractedData": {},
"funnelSummary": "<string>",
"tokenUsage": {
"cumulativeInputTokens": 123,
"cumulativeOutputTokens": 123,
"cumulativeTotalTokens": 123,
"cumulativeUsd": 123,
"lastTurnInputTokens": 123,
"lastTurnOutputTokens": 123,
"lastTurnTotalTokens": 123,
"lastTurnUsd": 123,
"lastTurnModelId": "<string>",
"lastTurnContextWindow": 123,
"lastTurnInputUsdPer1k": 123,
"lastTurnOutputUsdPer1k": 123,
"lastTurnTs": 123,
"usagePerModel": {}
},
"inboundEngagementState": {
"firstDecisionAt": 123,
"firstDecisionShouldReply": true,
"lastDecisionAt": 123,
"lastDecisionShouldReply": true,
"lastDecisionReason": "<string>",
"aiOwnedThread": true,
"ignoreThread": true
},
"title": "<string>",
"lastMessage": "<string>"
}
}Returns full conversation metadata including lead information. You must own the agent to access its conversations.
Use this endpoint to fetch conversation details before exporting or to check user feedback status.
Example Response
{
"success": true,
"message": "Conversation retrieved successfully",
"data": {
"ID": "agent123_convo456",
"userID": "agent123_convo456",
"ts": 1699999999,
"messagesNum": 5,
"userName": "John Doe",
"userEmail": "john@example.com",
"userPhone": "+1234567890",
"userCompany": "Acme Corp",
"userAddress": "123 Main St, City, State",
"userWebsite": "https://acme.com",
"notes": "Customer interested in premium plan, follow up next week",
"tags": ["new-lead", "high-priority"],
"origin": "web-chat",
"state": "ai-chatting",
"firstMessageTS": 1699999000,
"lastMessageTS": 1699999999,
"lastModified": 1699999999
}
}
Response Fields
The response includes all conversation metadata:Lead Information
userName,userEmail,userPhone- Contact informationuserAddress,userCompany,userWebsite- Additional detailsnotes- Internal notes about the conversation/leaduserProfilePic- Profile picture URL
Conversation Data
ID,userID- IdentifiersmessagesNum- Number of messages exchangedtags- Categorization tagsstate- Current conversation stateorigin- Channel (e.g., “web-chat”, “whatsapp”)- Timestamps:
ts,firstMessageTS,lastMessageTS,lastModified
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
⌘I
