Help Center
How can we help? šŸ‘‹

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ā€

Notion image

Find all contacts with one of two tags:

tags: ā€œredā€ OR tags: ā€œblueā€

Notion image

Find all contacts with one tag but not another:

tags: ā€œredā€ AND NOT tags: ā€œblueā€

Notion image

Search by Created Date

Search contact by created date or created date range. Using the folowing 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 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ā€

Notion image
Ā 

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.

Notion image
Notion image
Ā 

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.
Ā 
Notion image

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.

Did this answer your question?
šŸ˜ž
😐
🤩