Skip to content

Filtering

In the analytics, inbox and contacts section, it is possible to filter the results using the filtering control.

filter_control

In this input box, you can build sophisticated expressions to filter the results of the analytics, the conversations or the user list. These filters allow you to gain more insight into how your users interact with your bot.

Tag filtering

Using tag:tagname you can limit the results to the given tag.

Wherever you see a tag in the Inbox or the Contacts section of the studio, you can click on it to set the current filter to that tag. Additionally, you can press alt while selecting the tag to "and" the clicked tag to the current filter, or press ctrl (command on Mac) to "or" the clicked tag to the current filter. Additionally, pressing alt + ctrl/command simultaneously while clicking, adds the tag using the "and not" operators, which is convenient way to analyze a conversion funnel dropoff point.

Using text:sometext you can limit the results to the users that have sometext in their name or in their email address. For example:

  • text:John searches for users with the name John.

Using quotes, you can search for strings containing spaces:

  • text:"John Doe"

Note: currently, only the first_name, last_name and email fields of the user are considered in the fulltext search.

Specific field filters

You can set filters on any field that has been remembered. Furthermore, you can filter on any of the fields from the user variable:

  • first_name
  • last_name
  • profile_picture
  • timezone
  • locale
  • frontend
  • user_id
  • email
  • etc

These fields can be used in combination with the operators ==, != and =~

  • == - field exactly equals the given string
  • != - field does not equal the given string
  • =~ - field is LIKE the given string. This performs an SQL LIKE query, so you should add the % wildcard characters yourself in the match.

Examples:

  • email_push_status == "ok" Select any user that has indicated to want to receive emails
  • function_type =~ "%manager" Select any user that has a function type ending on "manager"

Combining filters

The and, or, not keywords can be used to combine filters.

Examples:

  • tag:success and first_name == "Arjan"
  • not ( email =~ "%mydomain.com" or email =~ "%testdomain.io" or email =~ "%ping.me" )

It is possible set up a list of predefined filters, to be able to easily switch between them. See the studio customization section to learn more about this.