Skip to main content

Receive Entities From Conversation

Process video file#

The first thing you need to do before getting your entities 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 "$CONVERSATION_ID/entities" \
-H "Authorization: Bearer $AUTH_TOKEN"

Response Example#

"type": "custom",
"customType": "Company Executives",
"value": "marketing director",
"text": "marketing director",
"messageRefs": [
"id": "5118221462011904",
"text": "The marketing director is out-of-town due to some work.",
"offset": 4

For a full reference of the response fields here you can view them on the GET Entities 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.