Skip to main content
QUERY
conversationCounts(ids: [String], departmentId: String, status: ConversationStatus, unAssigned: Boolean, tag: String, integrationType: String, integrationId: String, participating: String, awaitingResponse: String, starred: String, startDate: String, endDate: String, segment: String, assignedUserId: String, sortField: String, sortDirection: SortDirection, only: String): JSON

Arguments

ids
[String]

Filter by specific conversation IDs

departmentId
String

Filter by department ID

status
ConversationStatus

Filter by conversation status

unAssigned
Boolean

Filter unassigned conversations only ('true' to get unassigned, 'false' to get assigned, keep empty for no filter)

tag
String

Filter by tag ID or name

integrationType
String

Filter by integration type (e.g., 'messenger', 'email', 'facebook', 'whatsapp')

integrationId
String

Filter by specific integration ID

participating
String

Filter conversations where current user is participating ('true'/'false')

awaitingResponse
String

Filter conversations where customer awaiting response ('true'/'false')

starred
String

Filter starred/favorited conversations ('true'/'false')

startDate
String

Filter by start date (ISO date string)

endDate
String

Filter by end date (ISO date string)

segment
String

Filter by customer segment ID

assignedUserId
String

Filter by assigned user/agent ID

sortField
String

Field to sort results by (e.g., 'createdAt', 'updatedAt')

sortDirection
SortDirection

Sort direction: 'asc' for ascending, 'desc' for descending

only
String

Specify which count to return: 'byChannels', 'byIntegrationTypes', 'byWorkspaces', 'byTags', or null for all

Returns

JSON
Query
Response
Last modified on August 8, 2026

Related topics

conversationsTotalUnreadCountconversationResolveAllconversationsConversationcustomerCounts