Search Contacts
Search your contacts by tags, field values, broadcast audience and more.
Avochato allows you to use special search parameters to isolate contacts based on Tags, Field Values, Created Date, 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 Created Date
Search contact by created date or created date range. Using the following syntax, you can search for contacts created between December 1, 2022 - December 31, 2022 with:
created_at: “2022/12/01...2022/12/31”
To search for a contact created on a specific date use created_at:"2022-12-08”
Search by Status, e.g. Landline
Search contacts by the following status attributes:
- muted
- landline
- blocked
- double_opted_in
Example 1: Identify contacts who have been set to blocked and muted by entering following into the search bar:
blocked: false AND muted: true
Example 2: Identify contacts that returned a 30006 landline error by entering the following into the search bar:
landline: true
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 can 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:
Example:
fields:”favorite_movie=The Godfather”
- Favorite Movie is the field name. When the field name is two+ words, the words need to be separated by an underscore, e.g. “favorite_movie” is correct, not “favorite movie”.
- The Godfather is the field value. When the field value is two+ words, it does use spaces, not an underscore, .e.g. “The Godfather” is correct.
Using the following syntax (case sensitive), you can search for contacts using custom fields.
fields:”field_name=field value”
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.