v1

latestOpenAPI 3.1.0MIT2026-07-26134154266.9 KB

Search contacts and messages

Full-text search across contacts (by name, email, phone) and chat messages. Returns matching contacts and messages with their session IDs. Pass contact_id to scope message hits to a single contact — strongly recommended for customer-facing workflows so the response can never leak another customer’s messages.

get/chat/sessions/search

Query parameters

qstring required

Search query (a name, email, phone, or keyword)

contact_idstring

Restrict message hits to sessions belonging to this contact. When set, the contacts[] response is also restricted to this contact (no BM25 fan-out).

Response

Default Response