How to Search Contacts

Avochato allows you to use special search parameters to isolate contacts based on Tags, Field Values, Broadcast audience and more. Searches can be initiated within the Contacts tab of Avochato, and follow a common set of logic and search patterns.

Search by Tags

Using the following syntax (case sensitive), you can search for contacts using tags.

Find all contacts with two tags:

tags: “red” AND tags: “blue”

Find all contacts with one of two tags:

tags: “red” OR tags: “blue”

Find all contacts with one tag but not another:

tags: “red” AND NOT tags: “blue”

Search by Broadcast

Using the same logic, you can search contacts by broadcast audience. Each member of a broadcast’s audience has a hidden tag specific to that broadcast. To locate the hidden tag, navigate to the Broadcast results page and click on the specific broadcast. From there, click “X Contacts”

This will direct you to a search in the inbox. You can copy this search parameter (tags: “broadcast:xyz”) and paste it into the Contacts tab like you would for any other tag. You and also string these together using “AND”, “OR”, or “NOT” commands as highlighted above.

You can also append different suffixes onto any particular broadcast tag to get more specific results. These include:

  • tags: “broadcast:XYZ:success”
    • Contacts for whom the broadcast message’s delivery is confirmed
  • tags: “broadcast:XYZ:failure”
    • Contacts for whom the broadcast message failed
  • tags: “broadcast:XYZ:attempted”
    • Contacts for whom the broadcast message was attempted (could include both successes and failures)
  • tags: “broadcast:XYZ:undelivered”
    • Contacts for whom the broadcast message was not attempted
  • tags: “broadcast:XYZ:replied”
    • Contacts that have replied to the initial broadcast message (before any subsequent outbound message took place)

Note: These appended tags can also be found by clicking various corresponding blue links on the Broadcast Results page

Search by Field Value

You also have the option of searching contacts by specific field value or custom field value.

Find all Contacts with a Specific Field Value:

fields:”field_name=field value”

*Note: the field name is separated by an underscore instead of spaces if multiple words. Field value uses spaces, not an underscore

Example: fields:”favorite_movie=The Godfather”

Find all contacts with missing value

NOT _exists_:field

Example: NOT _exists_:name will pull a list of all contacts without a name in Avochato

Was this post helpful?

Close Menu