Find messages by query

Get messages by query with support for filtering and pagination.

Filtering:

• Filter by ticket: ticket=507f1f77bcf86cd799439011
• Filter by type: type=TEXT or type=TEXT,NOTE (comma-separated values match any; bracket syntax such as type[$in]=... is NOT supported)
• Filter by bot messages: bot=true or bot=false
• Filter by date range: createdAt>=2024-01-01&createdAt<=2024-12-31

Ordering: Messages are always returned oldest-first (ascending createdAt); the sort order is not configurable.

Pagination:

• Cursor mode (recommended): pass paginated=true to receive { items, hasMore, nextBefore }; pass before=<messageId> (the previous nextBefore) to fetch the next older page. skip is ignored in this mode; limit defaults to 30 and is clamped to 1-100.
• Legacy mode (no paginated): returns a flat array; limit defaults to 1000 and values above 100 are clamped to 100; skip is applied. Pass showHistory=false to hide ticket-history entries.

Translation:

• language=es returns messages translated into the given language. Requires the project setting 'translate customer messages'; only conversation messages (TEXT, USER_TEXT, NOTE, BOT, BOT_REPLY, SHARED_COMMENT) are translated, and messages already in the target language are returned unchanged.