RoiChatInstall

Summary

Search contacts (subscribers) using advanced filters to retrieve a list of matching contacts from the RoiChat API.

Inputs

• filters — A collection of optional filters to narrow the search results, including fields such as name, email, phone, communication channel, interaction flags in the last 24h, opt-in statuses, tags, labels, custom user field names/values, pagination (page), and result limit (max 100).

Output shape

a list of contact objects matching the specified filters

Results are paginated by the 'page' filter parameter with a maximum of 'limit' results returned per request (default 50, max 100). Returned data includes the matching contacts from the API response.

Examples

Example 1: Find contacts who interacted with the bot in the last 24 hours on the WhatsApp channel

Set filters is_bot_interacted_in_last_24h to 'yes' and is_channel to 'whatsapp', limit results and specify a page number if needed.