List session messages
One page of a conversation, newest first — the app-web conversation view
and the WebChat session restore. Replaces core-api
GET /tenants/:tenantID/sessions/:sessionID/messages.
Operators read within their inbox scope. A plugin installed on the tenant
(Plugin token) or the tenant’s plugin connection reads unrestricted, as
on core-api.
Page by passing the createdAt (epoch ms) of the last message as
firstMessageTimestamp; the boundary message comes back again, so dedupe
by id. A session that does not exist, or that the operator’s inboxes do not
cover, answers an empty page (200), not an error. Returns 206 instead of
200 when more pages are available.
Path Parameters
The tenant of the conversation.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$The session being read.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Query Parameters
Messages per page (max 200).
1 <= x <= 200Page cursor, epoch ms: messages created at or before it. Defaults to now.
x <= 9007199254740991true reads the contact thread across sessions (minus overlapping ones) instead of this session alone.
true, false