Zendesk Data Stream Parameters

The Zendesk plugin provides configurable data streams to fetch ticket information and metrics.

Each configurable data stream exposes a set of parameters that lets you filter the data you retrieve. The following information describes the available configurable data streams and their parameters in detail.

Omnichannel Engagements

Returns Zendesk omnichannel engagements, covering customer interactions across channels rather than tickets alone.

Parameter
Description
Channel
Select the communication channel to filter customer engagements.

Ticket Query

Returns the tickets matching a Zendesk search query. Use it when no saved view covers what you need.

Parameter
Description
Search query
Enter a Zendesk search query to return tickets for. See the Zendesk search query documentation for syntax reference.
Result type
Select how the query results are returned. Choose from:
  • List: All matching results are returned. This is the default option. You can then specify Columns to filter by.
  • Count: Returns a simple count based on the number of items matching the query.
  • Aggregate: Select a column by which to aggregate results, by specifying it in the Group by field.
Columns
Specify the columns to return. This helps to speed up the query if a large amount of results are returned.

Ticket Views

Returns every ticket in a Zendesk view, so a tile shows the same queue your agents work from.

Parameter
Description
Result type
Select how the query results are returned. Choose from:
  • List: All matching results are returned.
  • Count: Returns a simple count based on the number of items matching the query.

Tickets & Metrics

Returns tickets matching search criteria, together with the ticket metrics Zendesk records against them.

Parameter
Description
Type
Choose one or more ticket types (e.g., Question, Incident, Problem, Task) to narrow down results.
Priority
Filter tickets by priority level (e.g., Low, Normal, High, Urgent).
Status
Select one or more ticket statuses (e.g., New, Open, Pending, On-hold, Solved, Closed).
Additional filters
Select from the following checkboxes to apply any extra filtering criteria:
  • Channel:
    Select one or more ticket submission channels (e.g., Email, Web form, API, Chat, Social media).
  • Requester:
    Filter tickets based on the customer (requester) who submitted them.
  • Assignee:
    Choose one or more Zendesk agents assigned to the ticket.
  • Organization:
    Filter by the organization associated with the ticket requester.
  • Group:
    Limit results to tickets assigned to one or more Zendesk groups.
  • Tags:
    Include or exclude tickets that contain specific tags.
Result type
Select how the query results are returned. Choose from:
  • List: All matching results are returned. This is the default option.
    You can then specify only the Columns you need, to speed up the query.
  • Count: Returns a simple count based on the number of items matching the query.
  • Aggregate: Select a column by which to aggregate results, by specifying it in the Group by field.
Columns (incl. Metrics)
Specify the columns to return. This helps to speed up the query if a large amount of results are returned.

Voice Call Summary

Returns a summary of cost data for calls made and received through Zendesk Talk.

Parameter
Description
Columns
Specify the columns to return. This helps to speed up the query is a large amount of results are returned.

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket