Create Conversation
curl --request POST \
--url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"conversation": {
"ts": 123,
"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>",
"messagesNum": 0,
"interactionsNum": 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>",
"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>"
}
}
'import requests
url = "https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos"
payload = { "conversation": {
"ts": 123,
"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>",
"messagesNum": 0,
"interactionsNum": 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>",
"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>"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
conversation: {
ts: 123,
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>',
messagesNum: 0,
interactionsNum: 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>',
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>'
}
})
};
fetch('https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'conversation' => [
'ts' => 123,
'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>',
'messagesNum' => 0,
'interactionsNum' => 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>',
'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>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos"
payload := strings.NewReader("{\n \"conversation\": {\n \"ts\": 123,\n \"userEmail\": \"<string>\",\n \"userName\": \"<string>\",\n \"userPhone\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userCompany\": \"<string>\",\n \"userWebsite\": \"<string>\",\n \"notes\": \"<string>\",\n \"userProfilePic\": \"<string>\",\n \"value\": 123,\n \"currency\": \"<string>\",\n \"expectedCloseDate\": \"<string>\",\n \"subIndustry\": \"<string>\",\n \"source\": \"<string>\",\n \"language\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"demoDate\": \"<string>\",\n \"demoTime\": \"<string>\",\n \"demoLink\": \"<string>\",\n \"lostReason\": \"<string>\",\n \"lastActivityDate\": \"<string>\",\n \"ID\": \"<string>\",\n \"userID\": \"<string>\",\n \"campaignId\": \"<string>\",\n \"userImage\": \"<string>\",\n \"socialHandle\": \"<string>\",\n \"isFollowingBusiness\": true,\n \"socialVerified\": true,\n \"userOs\": \"<string>\",\n \"userBrowser\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"countryCode\": \"<string>\",\n \"origin\": \"<unknown>\",\n \"whatsappPhoneNumberId\": \"<string>\",\n \"whatsappBusinessNumber\": \"<string>\",\n \"whatsappDisplayPhoneNumber\": \"<string>\",\n \"whatsappBusinessAccountId\": \"<string>\",\n \"messagesNum\": 0,\n \"interactionsNum\": 123,\n \"tags\": [\n \"<string>\"\n ],\n \"convoTimeSeconds\": 123,\n \"firstMessageTS\": 123,\n \"lastMessageTS\": 123,\n \"userPlatform\": \"<string>\",\n \"smbContact\": true,\n \"smbContactName\": \"<string>\",\n \"smbContactRemovedAt\": 123,\n \"smbLastSeenAt\": 123,\n \"humanClaimedAt\": 123,\n \"humanLastRepliedAt\": 123,\n \"pendingAiReplyAt\": 123,\n \"chatAssignedTo\": \"<string>\",\n \"handoffHistory\": [\n {\n \"requestedAt\": 123,\n \"acceptedAt\": 123,\n \"completedAt\": 123,\n \"acceptedBy\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"teamIds\": [\n \"<string>\"\n ],\n \"teamKeys\": [\n \"<string>\"\n ]\n }\n ],\n \"isTyping\": true,\n \"lastModified\": 123,\n \"sessionsNum\": 123,\n \"lang\": \"<string>\",\n \"vapi\": {\n \"cost\": 123,\n \"callDuration\": 123,\n \"recordingUrl\": \"<string>\",\n \"callerPhoneNumber\": \"<string>\",\n \"calleePhoneNumber\": \"<string>\",\n \"callStatus\": \"<string>\",\n \"callError\": \"<string>\"\n },\n \"ratingFrom5\": 123,\n \"totalUserInteractions\": 123,\n \"isBlocked\": true,\n \"nodesInfo\": {\n \"currentNode\": \"<string>\"\n },\n \"capturedVariables\": \"<unknown>\",\n \"campaignCalls\": \"<array>\",\n \"sessions\": \"<array>\",\n \"endReason\": \"<string>\",\n \"isTest\": true,\n \"metrics\": \"<array>\",\n \"notifyToUserId\": \"<string>\",\n \"averageLatency\": 123,\n \"voice\": {\n \"latestSessionId\": \"<string>\",\n \"listenUrl\": \"<string>\",\n \"listenUrlUNIX\": 123\n },\n \"detailedCost\": {\n \"totalCreditsConsumed\": 123,\n \"speechGenCost\": 123,\n \"transcriberCost\": 123,\n \"twilioCost\": 123,\n \"llmCost\": 123\n },\n \"summary\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"delegatedBy\": \"<string>\",\n \"delegatedAt\": 123,\n \"lastViewed\": 123,\n \"note\": \"<string>\",\n \"hotScore\": 123,\n \"crmActivities\": [\n {\n \"id\": \"<string>\",\n \"title\": \"<string>\",\n \"date\": \"<string>\",\n \"dueDate\": \"<string>\",\n \"completed\": true,\n \"responded\": true,\n \"firstEngaged\": true,\n \"secondEngaged\": true,\n \"note\": \"<string>\",\n \"notesHistory\": [\n {\n \"text\": \"<string>\",\n \"agentId\": \"<string>\",\n \"agentName\": \"<string>\",\n \"timestamp\": \"<string>\"\n }\n ],\n \"metadata\": {}\n }\n ],\n \"crmAlerts\": {\n \"overdueECD\": true,\n \"overdueActivity\": true,\n \"staleLead\": true,\n \"responded\": true,\n \"newHandoffAssigned\": true\n },\n \"contactIdentityId\": \"<string>\",\n \"linkedChannels\": [\n \"<string>\"\n ],\n \"crossChannelContext\": \"<string>\",\n \"leadScore\": 0,\n \"funnelStepsMatched\": [],\n \"funnelScoreHistory\": [],\n \"funnelNotificationSent\": false,\n \"funnelLastEvaluated\": 123,\n \"funnelExtractedData\": {},\n \"funnelSummary\": \"<string>\",\n \"tokenUsage\": {\n \"cumulativeInputTokens\": 123,\n \"cumulativeOutputTokens\": 123,\n \"cumulativeTotalTokens\": 123,\n \"cumulativeUsd\": 123,\n \"lastTurnInputTokens\": 123,\n \"lastTurnOutputTokens\": 123,\n \"lastTurnTotalTokens\": 123,\n \"lastTurnUsd\": 123,\n \"lastTurnModelId\": \"<string>\",\n \"lastTurnContextWindow\": 123,\n \"lastTurnInputUsdPer1k\": 123,\n \"lastTurnOutputUsdPer1k\": 123,\n \"lastTurnTs\": 123,\n \"usagePerModel\": {}\n },\n \"inboundEngagementState\": {\n \"firstDecisionAt\": 123,\n \"firstDecisionShouldReply\": true,\n \"lastDecisionAt\": 123,\n \"lastDecisionShouldReply\": true,\n \"lastDecisionReason\": \"<string>\",\n \"aiOwnedThread\": true,\n \"ignoreThread\": true\n },\n \"title\": \"<string>\",\n \"lastMessage\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"conversation\": {\n \"ts\": 123,\n \"userEmail\": \"<string>\",\n \"userName\": \"<string>\",\n \"userPhone\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userCompany\": \"<string>\",\n \"userWebsite\": \"<string>\",\n \"notes\": \"<string>\",\n \"userProfilePic\": \"<string>\",\n \"value\": 123,\n \"currency\": \"<string>\",\n \"expectedCloseDate\": \"<string>\",\n \"subIndustry\": \"<string>\",\n \"source\": \"<string>\",\n \"language\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"demoDate\": \"<string>\",\n \"demoTime\": \"<string>\",\n \"demoLink\": \"<string>\",\n \"lostReason\": \"<string>\",\n \"lastActivityDate\": \"<string>\",\n \"ID\": \"<string>\",\n \"userID\": \"<string>\",\n \"campaignId\": \"<string>\",\n \"userImage\": \"<string>\",\n \"socialHandle\": \"<string>\",\n \"isFollowingBusiness\": true,\n \"socialVerified\": true,\n \"userOs\": \"<string>\",\n \"userBrowser\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"countryCode\": \"<string>\",\n \"origin\": \"<unknown>\",\n \"whatsappPhoneNumberId\": \"<string>\",\n \"whatsappBusinessNumber\": \"<string>\",\n \"whatsappDisplayPhoneNumber\": \"<string>\",\n \"whatsappBusinessAccountId\": \"<string>\",\n \"messagesNum\": 0,\n \"interactionsNum\": 123,\n \"tags\": [\n \"<string>\"\n ],\n \"convoTimeSeconds\": 123,\n \"firstMessageTS\": 123,\n \"lastMessageTS\": 123,\n \"userPlatform\": \"<string>\",\n \"smbContact\": true,\n \"smbContactName\": \"<string>\",\n \"smbContactRemovedAt\": 123,\n \"smbLastSeenAt\": 123,\n \"humanClaimedAt\": 123,\n \"humanLastRepliedAt\": 123,\n \"pendingAiReplyAt\": 123,\n \"chatAssignedTo\": \"<string>\",\n \"handoffHistory\": [\n {\n \"requestedAt\": 123,\n \"acceptedAt\": 123,\n \"completedAt\": 123,\n \"acceptedBy\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"teamIds\": [\n \"<string>\"\n ],\n \"teamKeys\": [\n \"<string>\"\n ]\n }\n ],\n \"isTyping\": true,\n \"lastModified\": 123,\n \"sessionsNum\": 123,\n \"lang\": \"<string>\",\n \"vapi\": {\n \"cost\": 123,\n \"callDuration\": 123,\n \"recordingUrl\": \"<string>\",\n \"callerPhoneNumber\": \"<string>\",\n \"calleePhoneNumber\": \"<string>\",\n \"callStatus\": \"<string>\",\n \"callError\": \"<string>\"\n },\n \"ratingFrom5\": 123,\n \"totalUserInteractions\": 123,\n \"isBlocked\": true,\n \"nodesInfo\": {\n \"currentNode\": \"<string>\"\n },\n \"capturedVariables\": \"<unknown>\",\n \"campaignCalls\": \"<array>\",\n \"sessions\": \"<array>\",\n \"endReason\": \"<string>\",\n \"isTest\": true,\n \"metrics\": \"<array>\",\n \"notifyToUserId\": \"<string>\",\n \"averageLatency\": 123,\n \"voice\": {\n \"latestSessionId\": \"<string>\",\n \"listenUrl\": \"<string>\",\n \"listenUrlUNIX\": 123\n },\n \"detailedCost\": {\n \"totalCreditsConsumed\": 123,\n \"speechGenCost\": 123,\n \"transcriberCost\": 123,\n \"twilioCost\": 123,\n \"llmCost\": 123\n },\n \"summary\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"delegatedBy\": \"<string>\",\n \"delegatedAt\": 123,\n \"lastViewed\": 123,\n \"note\": \"<string>\",\n \"hotScore\": 123,\n \"crmActivities\": [\n {\n \"id\": \"<string>\",\n \"title\": \"<string>\",\n \"date\": \"<string>\",\n \"dueDate\": \"<string>\",\n \"completed\": true,\n \"responded\": true,\n \"firstEngaged\": true,\n \"secondEngaged\": true,\n \"note\": \"<string>\",\n \"notesHistory\": [\n {\n \"text\": \"<string>\",\n \"agentId\": \"<string>\",\n \"agentName\": \"<string>\",\n \"timestamp\": \"<string>\"\n }\n ],\n \"metadata\": {}\n }\n ],\n \"crmAlerts\": {\n \"overdueECD\": true,\n \"overdueActivity\": true,\n \"staleLead\": true,\n \"responded\": true,\n \"newHandoffAssigned\": true\n },\n \"contactIdentityId\": \"<string>\",\n \"linkedChannels\": [\n \"<string>\"\n ],\n \"crossChannelContext\": \"<string>\",\n \"leadScore\": 0,\n \"funnelStepsMatched\": [],\n \"funnelScoreHistory\": [],\n \"funnelNotificationSent\": false,\n \"funnelLastEvaluated\": 123,\n \"funnelExtractedData\": {},\n \"funnelSummary\": \"<string>\",\n \"tokenUsage\": {\n \"cumulativeInputTokens\": 123,\n \"cumulativeOutputTokens\": 123,\n \"cumulativeTotalTokens\": 123,\n \"cumulativeUsd\": 123,\n \"lastTurnInputTokens\": 123,\n \"lastTurnOutputTokens\": 123,\n \"lastTurnTotalTokens\": 123,\n \"lastTurnUsd\": 123,\n \"lastTurnModelId\": \"<string>\",\n \"lastTurnContextWindow\": 123,\n \"lastTurnInputUsdPer1k\": 123,\n \"lastTurnOutputUsdPer1k\": 123,\n \"lastTurnTs\": 123,\n \"usagePerModel\": {}\n },\n \"inboundEngagementState\": {\n \"firstDecisionAt\": 123,\n \"firstDecisionShouldReply\": true,\n \"lastDecisionAt\": 123,\n \"lastDecisionShouldReply\": true,\n \"lastDecisionReason\": \"<string>\",\n \"aiOwnedThread\": true,\n \"ignoreThread\": true\n },\n \"title\": \"<string>\",\n \"lastMessage\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"conversation\": {\n \"ts\": 123,\n \"userEmail\": \"<string>\",\n \"userName\": \"<string>\",\n \"userPhone\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userCompany\": \"<string>\",\n \"userWebsite\": \"<string>\",\n \"notes\": \"<string>\",\n \"userProfilePic\": \"<string>\",\n \"value\": 123,\n \"currency\": \"<string>\",\n \"expectedCloseDate\": \"<string>\",\n \"subIndustry\": \"<string>\",\n \"source\": \"<string>\",\n \"language\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"demoDate\": \"<string>\",\n \"demoTime\": \"<string>\",\n \"demoLink\": \"<string>\",\n \"lostReason\": \"<string>\",\n \"lastActivityDate\": \"<string>\",\n \"ID\": \"<string>\",\n \"userID\": \"<string>\",\n \"campaignId\": \"<string>\",\n \"userImage\": \"<string>\",\n \"socialHandle\": \"<string>\",\n \"isFollowingBusiness\": true,\n \"socialVerified\": true,\n \"userOs\": \"<string>\",\n \"userBrowser\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"countryCode\": \"<string>\",\n \"origin\": \"<unknown>\",\n \"whatsappPhoneNumberId\": \"<string>\",\n \"whatsappBusinessNumber\": \"<string>\",\n \"whatsappDisplayPhoneNumber\": \"<string>\",\n \"whatsappBusinessAccountId\": \"<string>\",\n \"messagesNum\": 0,\n \"interactionsNum\": 123,\n \"tags\": [\n \"<string>\"\n ],\n \"convoTimeSeconds\": 123,\n \"firstMessageTS\": 123,\n \"lastMessageTS\": 123,\n \"userPlatform\": \"<string>\",\n \"smbContact\": true,\n \"smbContactName\": \"<string>\",\n \"smbContactRemovedAt\": 123,\n \"smbLastSeenAt\": 123,\n \"humanClaimedAt\": 123,\n \"humanLastRepliedAt\": 123,\n \"pendingAiReplyAt\": 123,\n \"chatAssignedTo\": \"<string>\",\n \"handoffHistory\": [\n {\n \"requestedAt\": 123,\n \"acceptedAt\": 123,\n \"completedAt\": 123,\n \"acceptedBy\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"teamIds\": [\n \"<string>\"\n ],\n \"teamKeys\": [\n \"<string>\"\n ]\n }\n ],\n \"isTyping\": true,\n \"lastModified\": 123,\n \"sessionsNum\": 123,\n \"lang\": \"<string>\",\n \"vapi\": {\n \"cost\": 123,\n \"callDuration\": 123,\n \"recordingUrl\": \"<string>\",\n \"callerPhoneNumber\": \"<string>\",\n \"calleePhoneNumber\": \"<string>\",\n \"callStatus\": \"<string>\",\n \"callError\": \"<string>\"\n },\n \"ratingFrom5\": 123,\n \"totalUserInteractions\": 123,\n \"isBlocked\": true,\n \"nodesInfo\": {\n \"currentNode\": \"<string>\"\n },\n \"capturedVariables\": \"<unknown>\",\n \"campaignCalls\": \"<array>\",\n \"sessions\": \"<array>\",\n \"endReason\": \"<string>\",\n \"isTest\": true,\n \"metrics\": \"<array>\",\n \"notifyToUserId\": \"<string>\",\n \"averageLatency\": 123,\n \"voice\": {\n \"latestSessionId\": \"<string>\",\n \"listenUrl\": \"<string>\",\n \"listenUrlUNIX\": 123\n },\n \"detailedCost\": {\n \"totalCreditsConsumed\": 123,\n \"speechGenCost\": 123,\n \"transcriberCost\": 123,\n \"twilioCost\": 123,\n \"llmCost\": 123\n },\n \"summary\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"delegatedBy\": \"<string>\",\n \"delegatedAt\": 123,\n \"lastViewed\": 123,\n \"note\": \"<string>\",\n \"hotScore\": 123,\n \"crmActivities\": [\n {\n \"id\": \"<string>\",\n \"title\": \"<string>\",\n \"date\": \"<string>\",\n \"dueDate\": \"<string>\",\n \"completed\": true,\n \"responded\": true,\n \"firstEngaged\": true,\n \"secondEngaged\": true,\n \"note\": \"<string>\",\n \"notesHistory\": [\n {\n \"text\": \"<string>\",\n \"agentId\": \"<string>\",\n \"agentName\": \"<string>\",\n \"timestamp\": \"<string>\"\n }\n ],\n \"metadata\": {}\n }\n ],\n \"crmAlerts\": {\n \"overdueECD\": true,\n \"overdueActivity\": true,\n \"staleLead\": true,\n \"responded\": true,\n \"newHandoffAssigned\": true\n },\n \"contactIdentityId\": \"<string>\",\n \"linkedChannels\": [\n \"<string>\"\n ],\n \"crossChannelContext\": \"<string>\",\n \"leadScore\": 0,\n \"funnelStepsMatched\": [],\n \"funnelScoreHistory\": [],\n \"funnelNotificationSent\": false,\n \"funnelLastEvaluated\": 123,\n \"funnelExtractedData\": {},\n \"funnelSummary\": \"<string>\",\n \"tokenUsage\": {\n \"cumulativeInputTokens\": 123,\n \"cumulativeOutputTokens\": 123,\n \"cumulativeTotalTokens\": 123,\n \"cumulativeUsd\": 123,\n \"lastTurnInputTokens\": 123,\n \"lastTurnOutputTokens\": 123,\n \"lastTurnTotalTokens\": 123,\n \"lastTurnUsd\": 123,\n \"lastTurnModelId\": \"<string>\",\n \"lastTurnContextWindow\": 123,\n \"lastTurnInputUsdPer1k\": 123,\n \"lastTurnOutputUsdPer1k\": 123,\n \"lastTurnTs\": 123,\n \"usagePerModel\": {}\n },\n \"inboundEngagementState\": {\n \"firstDecisionAt\": 123,\n \"firstDecisionShouldReply\": true,\n \"lastDecisionAt\": 123,\n \"lastDecisionShouldReply\": true,\n \"lastDecisionReason\": \"<string>\",\n \"aiOwnedThread\": true,\n \"ignoreThread\": true\n },\n \"title\": \"<string>\",\n \"lastMessage\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"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>"
}
}{
"message": "<string>",
"code": "<string>",
"issues": [
{
"message": "<string>"
}
]
}Conversations
Create Conversation
Creates a new conversation for the specified agent, using the V3 endpoints.
POST
/
agents
/
{agentId}
/
convos
Create Conversation
curl --request POST \
--url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"conversation": {
"ts": 123,
"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>",
"messagesNum": 0,
"interactionsNum": 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>",
"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>"
}
}
'import requests
url = "https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos"
payload = { "conversation": {
"ts": 123,
"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>",
"messagesNum": 0,
"interactionsNum": 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>",
"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>"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
conversation: {
ts: 123,
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>',
messagesNum: 0,
interactionsNum: 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>',
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>'
}
})
};
fetch('https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'conversation' => [
'ts' => 123,
'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>',
'messagesNum' => 0,
'interactionsNum' => 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>',
'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>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos"
payload := strings.NewReader("{\n \"conversation\": {\n \"ts\": 123,\n \"userEmail\": \"<string>\",\n \"userName\": \"<string>\",\n \"userPhone\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userCompany\": \"<string>\",\n \"userWebsite\": \"<string>\",\n \"notes\": \"<string>\",\n \"userProfilePic\": \"<string>\",\n \"value\": 123,\n \"currency\": \"<string>\",\n \"expectedCloseDate\": \"<string>\",\n \"subIndustry\": \"<string>\",\n \"source\": \"<string>\",\n \"language\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"demoDate\": \"<string>\",\n \"demoTime\": \"<string>\",\n \"demoLink\": \"<string>\",\n \"lostReason\": \"<string>\",\n \"lastActivityDate\": \"<string>\",\n \"ID\": \"<string>\",\n \"userID\": \"<string>\",\n \"campaignId\": \"<string>\",\n \"userImage\": \"<string>\",\n \"socialHandle\": \"<string>\",\n \"isFollowingBusiness\": true,\n \"socialVerified\": true,\n \"userOs\": \"<string>\",\n \"userBrowser\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"countryCode\": \"<string>\",\n \"origin\": \"<unknown>\",\n \"whatsappPhoneNumberId\": \"<string>\",\n \"whatsappBusinessNumber\": \"<string>\",\n \"whatsappDisplayPhoneNumber\": \"<string>\",\n \"whatsappBusinessAccountId\": \"<string>\",\n \"messagesNum\": 0,\n \"interactionsNum\": 123,\n \"tags\": [\n \"<string>\"\n ],\n \"convoTimeSeconds\": 123,\n \"firstMessageTS\": 123,\n \"lastMessageTS\": 123,\n \"userPlatform\": \"<string>\",\n \"smbContact\": true,\n \"smbContactName\": \"<string>\",\n \"smbContactRemovedAt\": 123,\n \"smbLastSeenAt\": 123,\n \"humanClaimedAt\": 123,\n \"humanLastRepliedAt\": 123,\n \"pendingAiReplyAt\": 123,\n \"chatAssignedTo\": \"<string>\",\n \"handoffHistory\": [\n {\n \"requestedAt\": 123,\n \"acceptedAt\": 123,\n \"completedAt\": 123,\n \"acceptedBy\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"teamIds\": [\n \"<string>\"\n ],\n \"teamKeys\": [\n \"<string>\"\n ]\n }\n ],\n \"isTyping\": true,\n \"lastModified\": 123,\n \"sessionsNum\": 123,\n \"lang\": \"<string>\",\n \"vapi\": {\n \"cost\": 123,\n \"callDuration\": 123,\n \"recordingUrl\": \"<string>\",\n \"callerPhoneNumber\": \"<string>\",\n \"calleePhoneNumber\": \"<string>\",\n \"callStatus\": \"<string>\",\n \"callError\": \"<string>\"\n },\n \"ratingFrom5\": 123,\n \"totalUserInteractions\": 123,\n \"isBlocked\": true,\n \"nodesInfo\": {\n \"currentNode\": \"<string>\"\n },\n \"capturedVariables\": \"<unknown>\",\n \"campaignCalls\": \"<array>\",\n \"sessions\": \"<array>\",\n \"endReason\": \"<string>\",\n \"isTest\": true,\n \"metrics\": \"<array>\",\n \"notifyToUserId\": \"<string>\",\n \"averageLatency\": 123,\n \"voice\": {\n \"latestSessionId\": \"<string>\",\n \"listenUrl\": \"<string>\",\n \"listenUrlUNIX\": 123\n },\n \"detailedCost\": {\n \"totalCreditsConsumed\": 123,\n \"speechGenCost\": 123,\n \"transcriberCost\": 123,\n \"twilioCost\": 123,\n \"llmCost\": 123\n },\n \"summary\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"delegatedBy\": \"<string>\",\n \"delegatedAt\": 123,\n \"lastViewed\": 123,\n \"note\": \"<string>\",\n \"hotScore\": 123,\n \"crmActivities\": [\n {\n \"id\": \"<string>\",\n \"title\": \"<string>\",\n \"date\": \"<string>\",\n \"dueDate\": \"<string>\",\n \"completed\": true,\n \"responded\": true,\n \"firstEngaged\": true,\n \"secondEngaged\": true,\n \"note\": \"<string>\",\n \"notesHistory\": [\n {\n \"text\": \"<string>\",\n \"agentId\": \"<string>\",\n \"agentName\": \"<string>\",\n \"timestamp\": \"<string>\"\n }\n ],\n \"metadata\": {}\n }\n ],\n \"crmAlerts\": {\n \"overdueECD\": true,\n \"overdueActivity\": true,\n \"staleLead\": true,\n \"responded\": true,\n \"newHandoffAssigned\": true\n },\n \"contactIdentityId\": \"<string>\",\n \"linkedChannels\": [\n \"<string>\"\n ],\n \"crossChannelContext\": \"<string>\",\n \"leadScore\": 0,\n \"funnelStepsMatched\": [],\n \"funnelScoreHistory\": [],\n \"funnelNotificationSent\": false,\n \"funnelLastEvaluated\": 123,\n \"funnelExtractedData\": {},\n \"funnelSummary\": \"<string>\",\n \"tokenUsage\": {\n \"cumulativeInputTokens\": 123,\n \"cumulativeOutputTokens\": 123,\n \"cumulativeTotalTokens\": 123,\n \"cumulativeUsd\": 123,\n \"lastTurnInputTokens\": 123,\n \"lastTurnOutputTokens\": 123,\n \"lastTurnTotalTokens\": 123,\n \"lastTurnUsd\": 123,\n \"lastTurnModelId\": \"<string>\",\n \"lastTurnContextWindow\": 123,\n \"lastTurnInputUsdPer1k\": 123,\n \"lastTurnOutputUsdPer1k\": 123,\n \"lastTurnTs\": 123,\n \"usagePerModel\": {}\n },\n \"inboundEngagementState\": {\n \"firstDecisionAt\": 123,\n \"firstDecisionShouldReply\": true,\n \"lastDecisionAt\": 123,\n \"lastDecisionShouldReply\": true,\n \"lastDecisionReason\": \"<string>\",\n \"aiOwnedThread\": true,\n \"ignoreThread\": true\n },\n \"title\": \"<string>\",\n \"lastMessage\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"conversation\": {\n \"ts\": 123,\n \"userEmail\": \"<string>\",\n \"userName\": \"<string>\",\n \"userPhone\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userCompany\": \"<string>\",\n \"userWebsite\": \"<string>\",\n \"notes\": \"<string>\",\n \"userProfilePic\": \"<string>\",\n \"value\": 123,\n \"currency\": \"<string>\",\n \"expectedCloseDate\": \"<string>\",\n \"subIndustry\": \"<string>\",\n \"source\": \"<string>\",\n \"language\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"demoDate\": \"<string>\",\n \"demoTime\": \"<string>\",\n \"demoLink\": \"<string>\",\n \"lostReason\": \"<string>\",\n \"lastActivityDate\": \"<string>\",\n \"ID\": \"<string>\",\n \"userID\": \"<string>\",\n \"campaignId\": \"<string>\",\n \"userImage\": \"<string>\",\n \"socialHandle\": \"<string>\",\n \"isFollowingBusiness\": true,\n \"socialVerified\": true,\n \"userOs\": \"<string>\",\n \"userBrowser\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"countryCode\": \"<string>\",\n \"origin\": \"<unknown>\",\n \"whatsappPhoneNumberId\": \"<string>\",\n \"whatsappBusinessNumber\": \"<string>\",\n \"whatsappDisplayPhoneNumber\": \"<string>\",\n \"whatsappBusinessAccountId\": \"<string>\",\n \"messagesNum\": 0,\n \"interactionsNum\": 123,\n \"tags\": [\n \"<string>\"\n ],\n \"convoTimeSeconds\": 123,\n \"firstMessageTS\": 123,\n \"lastMessageTS\": 123,\n \"userPlatform\": \"<string>\",\n \"smbContact\": true,\n \"smbContactName\": \"<string>\",\n \"smbContactRemovedAt\": 123,\n \"smbLastSeenAt\": 123,\n \"humanClaimedAt\": 123,\n \"humanLastRepliedAt\": 123,\n \"pendingAiReplyAt\": 123,\n \"chatAssignedTo\": \"<string>\",\n \"handoffHistory\": [\n {\n \"requestedAt\": 123,\n \"acceptedAt\": 123,\n \"completedAt\": 123,\n \"acceptedBy\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"teamIds\": [\n \"<string>\"\n ],\n \"teamKeys\": [\n \"<string>\"\n ]\n }\n ],\n \"isTyping\": true,\n \"lastModified\": 123,\n \"sessionsNum\": 123,\n \"lang\": \"<string>\",\n \"vapi\": {\n \"cost\": 123,\n \"callDuration\": 123,\n \"recordingUrl\": \"<string>\",\n \"callerPhoneNumber\": \"<string>\",\n \"calleePhoneNumber\": \"<string>\",\n \"callStatus\": \"<string>\",\n \"callError\": \"<string>\"\n },\n \"ratingFrom5\": 123,\n \"totalUserInteractions\": 123,\n \"isBlocked\": true,\n \"nodesInfo\": {\n \"currentNode\": \"<string>\"\n },\n \"capturedVariables\": \"<unknown>\",\n \"campaignCalls\": \"<array>\",\n \"sessions\": \"<array>\",\n \"endReason\": \"<string>\",\n \"isTest\": true,\n \"metrics\": \"<array>\",\n \"notifyToUserId\": \"<string>\",\n \"averageLatency\": 123,\n \"voice\": {\n \"latestSessionId\": \"<string>\",\n \"listenUrl\": \"<string>\",\n \"listenUrlUNIX\": 123\n },\n \"detailedCost\": {\n \"totalCreditsConsumed\": 123,\n \"speechGenCost\": 123,\n \"transcriberCost\": 123,\n \"twilioCost\": 123,\n \"llmCost\": 123\n },\n \"summary\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"delegatedBy\": \"<string>\",\n \"delegatedAt\": 123,\n \"lastViewed\": 123,\n \"note\": \"<string>\",\n \"hotScore\": 123,\n \"crmActivities\": [\n {\n \"id\": \"<string>\",\n \"title\": \"<string>\",\n \"date\": \"<string>\",\n \"dueDate\": \"<string>\",\n \"completed\": true,\n \"responded\": true,\n \"firstEngaged\": true,\n \"secondEngaged\": true,\n \"note\": \"<string>\",\n \"notesHistory\": [\n {\n \"text\": \"<string>\",\n \"agentId\": \"<string>\",\n \"agentName\": \"<string>\",\n \"timestamp\": \"<string>\"\n }\n ],\n \"metadata\": {}\n }\n ],\n \"crmAlerts\": {\n \"overdueECD\": true,\n \"overdueActivity\": true,\n \"staleLead\": true,\n \"responded\": true,\n \"newHandoffAssigned\": true\n },\n \"contactIdentityId\": \"<string>\",\n \"linkedChannels\": [\n \"<string>\"\n ],\n \"crossChannelContext\": \"<string>\",\n \"leadScore\": 0,\n \"funnelStepsMatched\": [],\n \"funnelScoreHistory\": [],\n \"funnelNotificationSent\": false,\n \"funnelLastEvaluated\": 123,\n \"funnelExtractedData\": {},\n \"funnelSummary\": \"<string>\",\n \"tokenUsage\": {\n \"cumulativeInputTokens\": 123,\n \"cumulativeOutputTokens\": 123,\n \"cumulativeTotalTokens\": 123,\n \"cumulativeUsd\": 123,\n \"lastTurnInputTokens\": 123,\n \"lastTurnOutputTokens\": 123,\n \"lastTurnTotalTokens\": 123,\n \"lastTurnUsd\": 123,\n \"lastTurnModelId\": \"<string>\",\n \"lastTurnContextWindow\": 123,\n \"lastTurnInputUsdPer1k\": 123,\n \"lastTurnOutputUsdPer1k\": 123,\n \"lastTurnTs\": 123,\n \"usagePerModel\": {}\n },\n \"inboundEngagementState\": {\n \"firstDecisionAt\": 123,\n \"firstDecisionShouldReply\": true,\n \"lastDecisionAt\": 123,\n \"lastDecisionShouldReply\": true,\n \"lastDecisionReason\": \"<string>\",\n \"aiOwnedThread\": true,\n \"ignoreThread\": true\n },\n \"title\": \"<string>\",\n \"lastMessage\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"conversation\": {\n \"ts\": 123,\n \"userEmail\": \"<string>\",\n \"userName\": \"<string>\",\n \"userPhone\": \"<string>\",\n \"userAddress\": \"<string>\",\n \"userCompany\": \"<string>\",\n \"userWebsite\": \"<string>\",\n \"notes\": \"<string>\",\n \"userProfilePic\": \"<string>\",\n \"value\": 123,\n \"currency\": \"<string>\",\n \"expectedCloseDate\": \"<string>\",\n \"subIndustry\": \"<string>\",\n \"source\": \"<string>\",\n \"language\": \"<string>\",\n \"linkedIn\": \"<string>\",\n \"facebook\": \"<string>\",\n \"instagram\": \"<string>\",\n \"demoDate\": \"<string>\",\n \"demoTime\": \"<string>\",\n \"demoLink\": \"<string>\",\n \"lostReason\": \"<string>\",\n \"lastActivityDate\": \"<string>\",\n \"ID\": \"<string>\",\n \"userID\": \"<string>\",\n \"campaignId\": \"<string>\",\n \"userImage\": \"<string>\",\n \"socialHandle\": \"<string>\",\n \"isFollowingBusiness\": true,\n \"socialVerified\": true,\n \"userOs\": \"<string>\",\n \"userBrowser\": \"<string>\",\n \"ipAddress\": \"<string>\",\n \"countryCode\": \"<string>\",\n \"origin\": \"<unknown>\",\n \"whatsappPhoneNumberId\": \"<string>\",\n \"whatsappBusinessNumber\": \"<string>\",\n \"whatsappDisplayPhoneNumber\": \"<string>\",\n \"whatsappBusinessAccountId\": \"<string>\",\n \"messagesNum\": 0,\n \"interactionsNum\": 123,\n \"tags\": [\n \"<string>\"\n ],\n \"convoTimeSeconds\": 123,\n \"firstMessageTS\": 123,\n \"lastMessageTS\": 123,\n \"userPlatform\": \"<string>\",\n \"smbContact\": true,\n \"smbContactName\": \"<string>\",\n \"smbContactRemovedAt\": 123,\n \"smbLastSeenAt\": 123,\n \"humanClaimedAt\": 123,\n \"humanLastRepliedAt\": 123,\n \"pendingAiReplyAt\": 123,\n \"chatAssignedTo\": \"<string>\",\n \"handoffHistory\": [\n {\n \"requestedAt\": 123,\n \"acceptedAt\": 123,\n \"completedAt\": 123,\n \"acceptedBy\": \"<string>\",\n \"organizationId\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"teamIds\": [\n \"<string>\"\n ],\n \"teamKeys\": [\n \"<string>\"\n ]\n }\n ],\n \"isTyping\": true,\n \"lastModified\": 123,\n \"sessionsNum\": 123,\n \"lang\": \"<string>\",\n \"vapi\": {\n \"cost\": 123,\n \"callDuration\": 123,\n \"recordingUrl\": \"<string>\",\n \"callerPhoneNumber\": \"<string>\",\n \"calleePhoneNumber\": \"<string>\",\n \"callStatus\": \"<string>\",\n \"callError\": \"<string>\"\n },\n \"ratingFrom5\": 123,\n \"totalUserInteractions\": 123,\n \"isBlocked\": true,\n \"nodesInfo\": {\n \"currentNode\": \"<string>\"\n },\n \"capturedVariables\": \"<unknown>\",\n \"campaignCalls\": \"<array>\",\n \"sessions\": \"<array>\",\n \"endReason\": \"<string>\",\n \"isTest\": true,\n \"metrics\": \"<array>\",\n \"notifyToUserId\": \"<string>\",\n \"averageLatency\": 123,\n \"voice\": {\n \"latestSessionId\": \"<string>\",\n \"listenUrl\": \"<string>\",\n \"listenUrlUNIX\": 123\n },\n \"detailedCost\": {\n \"totalCreditsConsumed\": 123,\n \"speechGenCost\": 123,\n \"transcriberCost\": 123,\n \"twilioCost\": 123,\n \"llmCost\": 123\n },\n \"summary\": \"<string>\",\n \"requestedTeamKey\": \"<string>\",\n \"delegatedBy\": \"<string>\",\n \"delegatedAt\": 123,\n \"lastViewed\": 123,\n \"note\": \"<string>\",\n \"hotScore\": 123,\n \"crmActivities\": [\n {\n \"id\": \"<string>\",\n \"title\": \"<string>\",\n \"date\": \"<string>\",\n \"dueDate\": \"<string>\",\n \"completed\": true,\n \"responded\": true,\n \"firstEngaged\": true,\n \"secondEngaged\": true,\n \"note\": \"<string>\",\n \"notesHistory\": [\n {\n \"text\": \"<string>\",\n \"agentId\": \"<string>\",\n \"agentName\": \"<string>\",\n \"timestamp\": \"<string>\"\n }\n ],\n \"metadata\": {}\n }\n ],\n \"crmAlerts\": {\n \"overdueECD\": true,\n \"overdueActivity\": true,\n \"staleLead\": true,\n \"responded\": true,\n \"newHandoffAssigned\": true\n },\n \"contactIdentityId\": \"<string>\",\n \"linkedChannels\": [\n \"<string>\"\n ],\n \"crossChannelContext\": \"<string>\",\n \"leadScore\": 0,\n \"funnelStepsMatched\": [],\n \"funnelScoreHistory\": [],\n \"funnelNotificationSent\": false,\n \"funnelLastEvaluated\": 123,\n \"funnelExtractedData\": {},\n \"funnelSummary\": \"<string>\",\n \"tokenUsage\": {\n \"cumulativeInputTokens\": 123,\n \"cumulativeOutputTokens\": 123,\n \"cumulativeTotalTokens\": 123,\n \"cumulativeUsd\": 123,\n \"lastTurnInputTokens\": 123,\n \"lastTurnOutputTokens\": 123,\n \"lastTurnTotalTokens\": 123,\n \"lastTurnUsd\": 123,\n \"lastTurnModelId\": \"<string>\",\n \"lastTurnContextWindow\": 123,\n \"lastTurnInputUsdPer1k\": 123,\n \"lastTurnOutputUsdPer1k\": 123,\n \"lastTurnTs\": 123,\n \"usagePerModel\": {}\n },\n \"inboundEngagementState\": {\n \"firstDecisionAt\": 123,\n \"firstDecisionShouldReply\": true,\n \"lastDecisionAt\": 123,\n \"lastDecisionShouldReply\": true,\n \"lastDecisionReason\": \"<string>\",\n \"aiOwnedThread\": true,\n \"ignoreThread\": true\n },\n \"title\": \"<string>\",\n \"lastMessage\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"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>"
}
}{
"message": "<string>",
"code": "<string>",
"issues": [
{
"message": "<string>"
}
]
}Example Request
{
"conversation": {
"ts": 1699999999,
"messagesNum": 0,
"userName": "John Doe",
"userEmail": "john@example.com",
"userPhone": "+1234567890",
"userCompany": "Acme Corp",
"notes": "Customer interested in premium plan, follow up next week",
"tags": ["new-lead"]
}
}
Example Response
{
"success": true,
"message": "Successfully created conversation: agent123_convo456",
"data": {
"ID": "agent123_convo456",
"userID": "agent123_convo456",
"ts": 1699999999,
"messagesNum": 0,
"userName": "John Doe",
"userEmail": "john@example.com",
"userPhone": "+1234567890",
"userCompany": "Acme Corp",
"notes": "Customer interested in premium plan, follow up next week",
"tags": ["new-lead"],
"lastModified": 1699999999
}
}
Notes
- A unique conversation ID is auto-generated
- The
tsfield (timestamp) is required - You must own the agent to create conversations for it
Available Lead Fields
Theconversation object supports the following optional lead fields:
| Field | Type | Description |
|---|---|---|
userName | string | User’s full name |
userEmail | string | User’s email address |
userPhone | string | User’s phone number |
userAddress | string | User’s physical address |
userCompany | string | User’s company name |
userWebsite | string | User’s website URL |
notes | string | Internal notes about the conversation/lead |
userProfilePic | string | URL to user’s profile picture |
tags | string[] | Array of tags for categorization |
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Body
application/json
Show child attributes
Show child attributes
⌘I
