Topic Hierarchy

In Beta Phase

This feature is in the Beta phase. If you have any questions, ideas or suggestions please reach out to us at devrelations@symbl.ai.

info

This API performs best when the audio is clear and the meeting length is greater than 10 minutes. Longer length meetings are broken down by our algorithm in contextually relevant parts which helps in producing high-quality topic hierarchy.

In any conversation, there can be multiple related topics that get discussed and it is possible to organize them in a hierarchy for better insights and consumption. Symbl's Topic Hierarchy algorithm finds a pattern in the conversation and creates parent (global) topics with each parent topic having multiple child topics nested within it.

Example#

If in a meeting “Sales Conversation” was talked about and after that, discussions around “Activity Call logs”, “Salesforce”, “Draft”, “Custom Integration” and “Jira” took place, the Topic Hierarchy will make Sales Conversation as the parent topic and the rest of the topics as the child topics under it.

Topic Hierarchy understands customer conversation and returns the parent (global) topic and its child topics.

Parent Topic: The highest-level abstraction of a meeting. These are the key points on which the speakers of the meeting expanded and discussed at length.
Child Topic: These are the subtopics that aggregate or are originated from the parent topic itself. Child Topics are the topics that are linked to the parent topic as they form the time chunks of the parent topics in a certain way.

Request object#

Query Params#

Parameter	Required	Value	Description
`parentRefs`	No	true	Gives you topic hierarchy when passed in Topic API.

Response object#

Field	Description
`parentRefs`	For each topic in the response, it has a parentRefs field that points to its parent topic. If parentRefs is NULL it signifies that the topic is a parent.

Sample Response#

{
    "topics": [
        {   //Child Topic
            "id": "5907389282779136",
            "text": "salesforce",
            "type": "topic",
            "score": 0.7178597920690242,
            "messageIds": [
                "4600982711304192",
                "5487363432120320",
                "6109794119188480"
            ],
            "parentRefs": [
                {
                    "type": "topic",
                    "text": "sales conversation"
                }
            ]
        },
        {   //Parent Topic
            "id": "6697188878974976",
            "text": "sales conversation",
            "type": "topic",
            "score": 0.6968750176932417,
            "messageIds": [
                "5356560840654848",
                "5663440783802368",
                "5263998490509312",
                "6082396449406976",
                "4925138187321344",
            ],
            "parentRefs": []
        }
    ]
}

Topics Hierarchy API#

To see Topics Hierarchy in action, you need to process a conversation using Symbl. After you process a meeting, you'll receive a Conversation ID. A Conversation ID is the key to receiving conversational insights from any conversation. As an example, here's a simple API call which grabs the detected topics from the conversation.

👉 Topics Hierarchy

Grab detected topics#

Remember to replace the conversationId in the API call with the Conversation ID you get from the previous API call.

cURL
Node.js
JavaScript

curl "https://api.symbl.ai/v1/conversations/{conversationId}/topics" \
    -H "Authorization: Bearer $AUTH_TOKEN"