Search Intercom conversations via the Search API

Steps

1. Authenticate all requests by setting the Authorization header to 'Bearer YOUR_TOKEN' where YOUR_TOKEN is your Intercom Access Token from the Developer Hub.
2. POST to /conversations/search with a JSON body containing a 'query' object. Simple single-condition searches use 'field', 'operator', and 'value' keys; compound searches use 'operator' (AND/OR) and a 'value' array of condition objects.
3. Searchable fields include 'state' (open, closed, snoozed), 'created_at', 'updated_at', 'assignee.id', 'tag.id', and others documented in the API reference — confirm field names against the docs before querying.
4. Control pagination with 'pagination.per_page' (max 150) and 'pagination.starting_after' (cursor from the previous response's 'pages.next.starting_after').
5. Extract conversation IDs and metadata from the 'conversations' array in the response; fetch full conversation detail with GET /conversations/{id} if you need message parts.
6. Combine multiple filters (e.g., state=open AND assignee.id=agent_123) using a compound AND query to narrow results before processing.