Stay organized with collections
Save and categorize content based on your preferences.
You can filter conversations based on information gleaned directly from their characteristics or from attributes of operations that those conversations have been through.
Conversation filters
Conversations can be filtered on one or more of the characteristics in the following table. These filters are useful for narrowing down a search among large conversation data sets. The "Filtering" section of the List Conversations page lists the permissions you need to apply the following filters.
You can also filter conversations based on the information available from operations that have been performed on them. You can filter a conversation dataset based on the following operation attributes.
Filter term
Description
Reference code
Create time
Time at which the operation was created
metadata.create_time>"1969-12-31T16:00:10-08:00"
metadata.create_time<="1969-12-31T16:00:20-08:00"
Conversation ID
String for a specific conversation
metadata.conversation_id="some_conversation_id"
Done
Final status of an operation
Completed: done="true"
Not completed: done="false"
Operation Type
Type of operation performed on the dataset
Operation type is: metadata.operation_type="BulkAnalyzeConversations"
Operation type is not: metadata.operation_type!="BulkAnalyzeConversations"
Status
Detailed status of the operation
Completed successfully: status_code="0"
Failed but not aborted: status_code!="ABORTED"
To view the errors from running a bulk operation, you must use a curl command.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eConversations can be filtered based on their inherent characteristics, such as agent ID, conversation channel, or create time.\u003c/p\u003e\n"],["\u003cp\u003eFilters can be applied to conversation analysis data, including analysis creation time, status, and the presence of custom or smart highlights.\u003c/p\u003e\n"],["\u003cp\u003eConversations can also be filtered by labels, language, duration, or whether they originated from Dialogflow.\u003c/p\u003e\n"],["\u003cp\u003eOperation attributes like create time, conversation ID, operation type, and status can be used to filter conversations based on the operations performed on them.\u003c/p\u003e\n"],["\u003cp\u003eCurl commands are required to view errors from bulk operations, which can be filtered by operation type, like BulkAnalyzeConversations or IngestConversations.\u003c/p\u003e\n"]]],[],null,["# Filtering\n\nYou can filter conversations based on information gleaned directly from their characteristics or from attributes of operations that those conversations have been through.\n\nConversation filters\n--------------------\n\nConversations can be filtered on one or more of the characteristics in the following table. These filters are useful for narrowing down a search among large conversation data sets. The \"Filtering\" section of the [List Conversations](/contact-center/insights/docs/list-conversations-api#filtering) page lists the permissions you need to apply the following filters.\n| **Note:** When using the double quotes (\") in a curl command or a URL, you should escape them with a backslash and no extra space after (\").\n\nOperation filters\n-----------------\n\nYou can also filter conversations based on the information available from operations that have been performed on them. You can filter a conversation dataset based on the following operation attributes.\n\nTo view the errors from running a bulk operation, you must use a curl command.\n\n- Bulk analyze operations: \n\n ```bash\n curl -X GET \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -H \"Content-Type: application/json; charset=utf-8\" \"https://contactcenterinsights.googleapis.com/v1/projects/$PROJECT/locations/$LOCATION/operations?filter=metadata.operation_type=\\\"BulkAnalyzeConversations\\\"&page_size=10\"\n ```\n- Bulk ingest operations (transcript or audio): \n\n ```bash\n curl -X GET \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n -H \"Content-Type: application/json; charset=utf-8\" \"https://contactcenterinsights.googleapis.com/v1/projects/$PROJECT/locations/$LOCATION/operations?filter=metadata.operation_type=\\\"IngestConversations\\\"&page_size=10\"\n ```"]]
