Filtering Interactions

Created by Seb Coulthread, Modified on Tue, 23 Apr 2024 at 10:47 PM by Seb Coulthread

By default, the interactions presented will be ordered with the oldest showing first and paginated. To help search the data, we allow filtering of the data. The filters can be passed as query parameters to the request. The list of available filters is below:

NameData TypeDescriptionExample
enddatestringThis date is the last date to search, only interactions before and including this date will be shown2021-04-20
startdatestringThis date is the first date to search, only interactions after and including this date will be shown2020-01-20
users[]arrayThis accepts an array of user IDs6
queues[]arrayThis accepts an array of queue IDs2
tags[]arrayThis accepts an array of tag IDs1
quickrefstringThis allows you to filter by an interaction quickref12345
completedbooleanThis accepts a true or false value to filter completed interactionstrue
activebooleanThis accepts a true or false value to filter active interactionstrue
commentsbooleanThis accepts a true or false value to filter interactions which have comments left by the customertrue
feedbackstring|booleanThis accepts true or false, or a string containing 'all' to show interaction with either positive, negative or any feedback.true
false
'all'
videobooleanThis accepts a true or false value to filter interactions which were video interactionstrue
voicebooleanThis accepts a true or false value to filter interactions which were voice interactionstrue
cobrowsingbooleanThis accepts a true or false value to filter interactions which were cobrowsing interactionstrue
chatbooleanThis accepts a true or false value to filter interactions which were chat interactionstrue
handledbooleanThis accepts a true or false interaction to filter interactions which were, or were not handled by an agent, useful for tracking abandoned interactionstrue
search (deprecated)stringThis is a general search method which will search for content within tags and messages. Please note this method is deprecated and will require additional filtering parameters in the next minor release.'Complaint'

 

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article