Conversations API

The Conversations API provides a REST interface for getting your processed speech-to-text data (also known as transcripts) and conversational insights.

You can utilize different functions of Conversations APIs by directly utilizing symbl.Conversations if you have already have a conversationId.

Sample Code

import symbl

parameters_object={'sentiment': True}

print(symbl.Conversations.get_messages(conversation_id='4650518950445056', parameters =parameters_object )

Supported Functions

These APIs require a conversationId. When you process any conversation through Symbl whether it is from Async API, Javascript SDK, Telephony or Streaming API, you'll always receive a unique conversationId, which consists of numerical digits.

You can utilize different functions of the Conversations API by directly utilizing symbl.Conversations.

FunctionDescription
get_conversation_id()Returns a unique Conversation Id of the conversation which you are currently processing.
get_job_id()Returns a Job Id of the conversation which you are currently processing.
get_messages(conversation_id)parameters:- (Optional) dictionary, takes a dictionary of parameters. For list of parameters accepted, see Speech-to-Text. Returns a list of messages (sentences spoken by speakers) in a conversation. You can use this for providing transcription for video conference, meeting or telephone call. Example:
get_topics(conversation_id)parameters:- (Optional) dictionary, takes a dictionary of parameters. For list of parameters accepted, see Topics. Returns the most relevant topics of discussion from the conversation that is generated based on the combination of the overall scope of the discussion.
get_action_items(conversation_id)Returns Action Items which are some specific outcomes recognized in the conversation that requires one or more people in the conversation to act in the future.
get_follow_ups(conversation_id)Returns 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.
get_members(conversation_id)Returns a list of all the members in a conversation. A Member is referred to a participant in the conversation that is uniquely identified as a speaker. Identifying different participants in the meetings can be done by implementing speaker separation.
get_questions(conversation_id)Returns explicit question or request for information that comes up during the conversation, whether answered or not, is recognized as a question.
get_conversation(conversation_id)Returns the conversation meta-data like meeting name, member name and email, start and end time of the meeting, meeting type and meeting id.
get_entities(conversation_id)Extracts entities (such as custom entities, location, person, date, number, organization,datetime,daterange, etc.) from the conversation.
get_trackers(conversation_id)Returns the occurrence of certain key words or phrases from the conversation.
get_analytics(conversation_id)Returns the speaker ratio, talk time, silence, pace and overlap from the conversation.
put_members(conversation_id, members_id, parameters={})members_id:- (mandatory) string, that takes the ID of the member who's details you would like to update. parameters:- (mandatory) takes a dictionary of parameters. For list of parameters accepted, see Put Members Information API page.
Updates an existing member in an conversation. This API can be used for updating the unique speakers detected as members from diarization as well.
To see an example of the usage of put_members functionality using Conversations class, see our GitHub example page.
put_speakers_events(conversation_id, parameters={})parameters:- (mandatory) takes a dictionary which contains speakerEvents. For list of parameters accepted, see Speaker Event Object page.
This API provides the functionality to update Speakers in a conversation after it has been processed.
To see an example of the usage of put_speakers_events functionality using Conversations class for Async APIs, see our GitHub example page.
To see an example of the usage of put_speakers_events functionality using Conversations class for Streaming APIs, see our GitHub example page.