messenger_rooms_get
Read chat rooms in the Messenger app (pApp D00003). View rooms (chatRoomType ALL|DIRECT|GROUP, search, paging), room, participants or messages with roomUuid and roomType, or oldest for unanswered direct chats. Returns the roomUuid and messageUuid values other tools take. Hidden message content is excluded; reading marks nothing read.
Inputs
| Field | Required here | Contract |
|---|---|---|
view |
Yes | one of: oldest, rooms, room, participants, messages |
minThresholdInDays |
No | When view is oldest: integer; minimum 0 |
maxThresholdInDays |
No | When view is oldest: integer; minimum 0 |
after |
No | When view is oldest: integer; greater than 0 |
limit |
No | When view is oldest: integer; maximum 100; greater than 0; default 20 |
chatRoomType |
No | When view is rooms: ALL, DIRECT, GROUP; default ALL |
quietStatus |
No | When view is rooms: quiet, active, all; default all |
search |
No | When view is rooms: string; max length 200 |
page |
No | When view is rooms: integer; greater than 0; default 1 |
limit |
No | When view is rooms: integer; maximum 100; greater than 0; default 20 |
roomUuid |
Yes | When view is room: string; pattern ^[A-Za-z0-9_-]{1,200}$ |
roomType |
Yes | When view is room: DIRECT, GROUP |
roomUuid |
Yes | When view is participants: string; pattern ^[A-Za-z0-9_-]{1,200}$ |
roomType |
Yes | When view is participants: DIRECT, GROUP |
participantType |
No | When view is participants: SELLER_PERFORMER, SELLER, ADMIN, MANAGERS, USER, ALL; default ALL |
page |
No | When view is participants: integer; greater than 0; default 1 |
limit |
No | When view is participants: integer; maximum 100; greater than 0; default 20 |
roomUuid |
Yes | When view is messages: string; pattern ^[A-Za-z0-9_-]{1,200}$ |
roomType |
Yes | When view is messages: DIRECT, GROUP |
messageType |
No | When view is messages: ALL, TEXT, IMAGE, VIDEO, ATTACHMENT, TRANSACTION, DONATION, HIDE, SYSTEM; default ALL |
cursor |
No | When view is messages: integer; greater than 0 |
limit |
No | When view is messages: integer; maximum 100; greater than 0; default 20 |