conversations
Search and list conversations for the authenticated workspace, with filtering (status, assignment, department, integration, tags, date range, segment) and sorting.
Use conversationDetail for a single conversation, or
conversationCounts for aggregate counts matching the same
filters.
Auth · x-app-token · required permission showConversations
Related: conversationDetail, conversationCounts, Conversation
conversations(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, page: Int, perPage: Int): ConversationListResponseArguments
Filter by specific conversation IDs
Filter by department id.
Filter by ConversationStatus.
true returns unassigned conversations only, false returns assigned only, omit for no filter.
Filter by tag id or name.
Filter by integration kind (e.g. messenger, email, facebook, whatsapp).
Filter by a specific Integration id.
"true"/"false" — filter conversations where the current user is participating.
"true"/"false" — filter conversations currently awaiting a customer's response.
"true"/"false" — filter starred/favorited conversations.
Filter by start date (ISO date string).
Filter by end date (ISO date string).
Filter by customer segment id.
Filter by assigned user/agent id.
Field to sort by (e.g. createdAt, updatedAt). Default: updatedAt.
Sort direction. Default: desc.
1-based page index. Default: 1. See Pagination.
Page size. Default: 20. Maximum: 100.
Returns
Conversation rows for the current page.
Standard pagination metadata: totalCount, currentPage, totalPages,
hasNextPage, hasPreviousPage, perPage.