Skip to main content

Conversation Groups (Beta)

In Beta Phase

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

Conversation Groups allow you to create groups of conversations by setting the grouping criteria that suits your business requirement.

The criteria of the group can be applied to the Conversation Metadata that can be any important information such as unique identifiers like agentId, customerId, userId, etc., or custom tags such as sales call, support call, internal discussion, etc.


  • Dan is the Head of Sales in his company and wishes to group calls based on the type, such as internal and external. Using the metadata label: “Internal'' and “External”, Dan can group conversations and query all conversations using this criterion.

  • Ashna manages the Customer Experience team and wants to manage conversations with vendor companies individually. Since there are over 10 vendor companies they work with, using Conversation Groups (that adds metadata with the company name), Ashna can separate out conversations for each vendor.

  • Tom is the Chief Quality Assurance Manager and wants to see the customer conversations of his team member- John to analyze his discussions with the customers. He creates a metadata label with agent names (e.g., "agentId": "johndoe") that groups conversations based on the name of the agent and allows Tom to fetch all conversations made by John.

Conversation Groups API#

You can perform CRUD operations on the Conversation Groups using the Management APIs.

For more details on these operations, go to the Conversation Groups API section.

Quick Start Guide

View step-by-step instruction on how to create and use Conversation Groups in the Quick Start Guide for Conversation Groups.

Following are the operations you can perform with Management API for Conversation Groups:

Create Conversation GroupPOST /v1/manage/group
Create Multiple Conversation GroupsPOST /v1/manage/groups
Get Conversation Group with IDGET /v1/manage/group/{groupId}
Get Multiple Conversation GroupsGET /v1/manage/groups
Update Conversation GroupPUT /v1/manage/group/{groupId}
Delete GroupDELETE /v1/manage/group/{groupId}