Skip to main content

Receive Conversation Analytics

Process video file#

The first thing you need to do before getting your conversational analytics is to process your video file. This code is taken directly from our POST Video URL page. If you want to use an audio or text file you can use the code from the POST Audio URL or POST Text File pages.

While we provide you with a default video URL, you can replace that with any other video URL.

Request Example#

curl --location --request POST "https://api.symbl.ai/v1/process/video/url" \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $AUTH_TOKEN" \
--data-raw '{
"url": "https://symbltestdata.s3.us-east-2.amazonaws.com/sample_video_file.mp4",
"name": "BusinessMeeting"
}'

Response Example#

{
"conversationId": "5815170693595136",
"jobId": "9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d"
}

Receive Conversational Analytics#

In the response above, you will notice the conversationId field. Using the conversationId you can send a GET request to GET Analytics endpoint in the Conversation API.

Request Example#

curl "https://api.symbl.ai/v1/conversations/$CONVERSATION_ID/analytics" \
-H "Authorization: Bearer $AUTH_TOKEN"

Response Example#

{
"metrics": [
{
"type": "total_silence",
"percent": 29.061,
"seconds": 23.432
},
{
"type": "total_talk_time",
"percent": 70.939,
"seconds": 57.199
},
{
"type": "total_overlap",
"percent": 55.071,
"seconds": 31.5
}
],
"members": [
{
"id": "acc63fbe-c3cd-4daa-8ab0-b088142e5a0f",
"name": "Speaker 1",
"pace": {
"wpm": 68
},
"talkTime": {
"percentage": 40.912,
"seconds": 23.401
},
"listenTime": {
"percentage": 59.088,
"seconds": 33.798
},
"overlap": {
"overlapDuration": 31.5,
"overlappingMembers": [
{
"id": "a52def45-be6e-484f-908b-9ac66eaecabb",
"name": "Speaker 2",
"percent": 61.58,
"seconds": 24.94
},
{
"id": "a52def45-be6e-484f-908b-9ac66eaecacb",
"name": "Speaker 3",
"percent": 7.51,
"seconds": 1.9
},
{
"id": "a52def45-be6e-484f-908b-9ac56eaecabb",
"name": "Speaker 4",
"percent": 12.199,
"seconds": 4.66
}
]
}
},
{
"id": "a52def45-be6e-484f-908b-9ac66eaecabb",
"name": "Speaker 2",
"pace": {
"wpm": 132
},
"talkTime": {
"percentage": 29.894,
"seconds": 17.099
},
"listenTime": {
"percentage": 70.106,
"seconds": 40.1
},
"overlap": {
"overlapDuration": 24.94,
"overlappingMembers": [
{
"id": "acc63fbe-c3cd-4daa-8ab0-b088142e5a0f",
"name": "Speaker 1",
"percent": 61.58,
"seconds": 24.94
}
]
}
},
{
"id": "a52def45-be6e-484f-908b-9ac66eaecacb",
"name": "Speaker 3",
"pace": {
"wpm": 189
},
"talkTime": {
"percentage": 3.322,
"seconds": 1.9
},
"listenTime": {
"percentage": 96.678,
"seconds": 55.299
},
"overlap": {
"overlapDuration": 1.9,
"overlappingMembers": [
{
"id": "acc63fbe-c3cd-4daa-8ab0-b088142e5a0f",
"name": "Speaker 1",
"percent": 7.51,
"seconds": 1.9
}
]
}
},
{
"id": "a52def45-be6e-484f-908b-9ac56eaecabb",
"name": "Speaker 4",
"pace": {
"wpm": 152
},
"talkTime": {
"percentage": 25.873,
"seconds": 14.799
},
"listenTime": {
"percentage": 74.127,
"seconds": 42.4
},
"overlap": {
"overlapDuration": 4.66,
"overlappingMembers": [
{
"id": "acc63fbe-c3cd-4daa-8ab0-b088142e5a0f",
"name": "Speaker 1",
"percent": 12.199,
"seconds": 4.66
}
]
}
}
]
}

For a full reference of the response fields here you can view them on the GET Analytics page.

Receiving More AI Insights#

Here's more data you can grab with our Conversation API:

View conversation topics
Summary topics provide a quick overview of the key things that were talked about in the conversation.

View action items
An action item is a specific outcome recognized in the conversation that requires one or more people in the conversation to take a specific action, e.g. set up a meeting, share a file, complete a task, etc.

View follow-ups
This is a category of action items with a connotation to follow-up a request or a task like sending an email or making a phone call or booking an appointment or setting up a meeting.