Actions21
- Campo Personalizado Actions
- Contato Actions
- Disparo Actions
- Fluxo Actions
- LiveChat Actions
- Tag Actions
- WhatsApp Template Actions
Contato → Buscar Contatos
AI-generatedSummary
Search contacts in NicoChat using various advanced filters to retrieve a list of matching subscribers.
Inputs
- Filtros — A collection of optional filters to narrow down the contact search, including filters by interaction within the last 24 hours, custom fields, origin channel, email, event, label ID, pagination settings, name, opt-in status, tags, phone number, and limits on the number of results.
Output shape
A list of contact objects matching the specified filters.
The operation returns multiple contact records, with pagination controlled by 'page' and 'limit' filter parameters. If no filters are provided, the system applies default values where specified (e.g., defaults to limit 50). Errors are returned in the workflow output if continue on fail is enabled.
Examples
Example 1: Find contacts who interacted in the last 24 hours on the WhatsApp channel and have accepted email opt-in.
Set filters 'is_interacted_in_last_24h' to 'yes', 'is_channel' to 'whatsapp', and 'is_opt_in_email' to 'yes' with the default limit and page values.