Kuantia CRM icon

Kuantia CRM

Interact with Kuantia CRM API

Actions65

Conversations → Conversation Controller Get Counts

AI-generated

Overview

This node operation retrieves counts of conversations from the Kuantia CRM system with extensive filtering, sorting, and pagination options. It is useful for scenarios where users need to analyze or report on conversation data, such as customer support ticket volumes, unread conversations, or conversations filtered by custom fields or tags. For example, a support manager could use this node to get counts of unread conversations assigned to their team, filtered by priority or status, and sorted by creation date.

Use Case Examples

  1. Get the count of unread conversations for a specific company, filtered by tags like 'urgent' or 'customer-support'.
  2. Retrieve conversation counts grouped by a custom field such as 'status' or 'priority' to analyze workload distribution.
  3. Fetch paginated counts of conversations with specific fields selected, sorted by creation date in descending order.

Properties

Name Meaning
Page Page number for pagination (1-based). Controls which page of results to retrieve.
Limit Number of items per page. Controls the size of each page of results.
Relations Relations to include in the response, supporting nested relations using dot notation.
Select Fields to select in the response, specifying which conversation properties to return.
Sort Sort configuration for the results, can specify one or multiple fields with order (ASC or DESC).
Filters Filter conditions as a JSON object to narrow down the conversations returned.
Custom Field Filters Filter conversations by custom field values using JSON path queries for advanced filtering.
Custom Field Search Search text within custom field values to find conversations matching specific criteria.
Search Search text across name, email, and phone fields to find matching conversations.
Tags Filter conversations by tags, returning entities that contain any of the specified tags.
Custom Field Sort Sort conversations by a custom field using the format customFields.fieldName.
Custom Field Group By Group conversation counts by a custom field using the format customFields.fieldName.
Show Unread Only Boolean flag to filter and show only unread conversations.
Current User Id Current user ID used to filter conversations that belong to or are assigned to the user.
Request Options Additional request options such as batching, SSL certificate validation, proxy settings, and timeout configuration.

Output

JSON

  • counts - The counts of conversations matching the specified filters and criteria.

Dependencies

  • Kuantia CRM API with authentication credentials

Troubleshooting

  • Ensure the API credentials are correctly configured and have sufficient permissions to access conversation data.
  • Verify that JSON inputs for filters, relations, select, sort, and custom field filters are correctly formatted to avoid parsing errors.
  • Check network connectivity and proxy settings if requests fail or time out.
  • If SSL certificate validation errors occur, consider enabling the option to ignore SSL issues, but be aware of security implications.

Discussion