{ "type": "object", "description": "Paginated collection of messages", "properties": { "results": { "type": "array", "description": "Array of message records", "example": [ { "id": "msg_123456", "type": "MESSAGE", "text": "Hello, I need help with my order.", "richText": "

Hello, I need help with my order.

", "direction": "INCOMING", "channelId": "channel_789", "channelAccountId": "account_123", "senders": [ { "id": "actor_101", "actorId": "actor_101", "name": "John Customer", "email": "john@example.com", "type": "VISITOR" } ], "recipients": [ { "id": "actor_101", "actorId": "actor_101", "name": "John Customer", "email": "john@example.com", "type": "VISITOR" } ], "status": {}, "createdAt": "2024-01-20T10:30:00Z", "truncationStatus": "NOT_TRUNCATED", "attachments": [ { "id": "attach_001", "type": "application/pdf", "url": "https://api.hubapi.com/files/v3/files/attach_001", "filename": "invoice.pdf", "size": 102400 } ] } ], "items": { "type": "object", "description": "Represents a message within a conversation thread.", "properties": { "id": { "type": "string", "description": "Unique identifier for the message", "example": "msg_123456" }, "type": { "type": "string", "description": "Type of message", "example": "MESSAGE", "enum": [ "MESSAGE", "COMMENT", "WELCOME_MESSAGE" ] }, "text": { "type": "string", "description": "Plain text content of the message", "example": "Hello, I need help with my order." }, "richText": { "type": "string", "description": "Rich text (HTML) content of the message", "example": "

Hello, I need help with my order.

" }, "direction": { "type": "string", "description": "Direction of the message (incoming or outgoing)", "example": "INCOMING", "enum": [ "INCOMING", "OUTGOING" ] }, "channelId": { "type": "string", "description": "ID of the communication channel", "example": "channel_789" }, "channelAccountId": { "type": "string", "description": "ID of the channel account", "example": "account_123" }, "senders": { "type": "array", "description": "List of message senders", "example": [ { "id": "actor_101", "actorId": "actor_101", "name": "John Customer", "email": "john@example.com", "type": "VISITOR" } ], "items": { "type": "object", "description": "Represents a participant in a conversation (visitor, agent, or bot).", "properties": { "id": { "type": "string", "description": "Unique identifier for the actor", "example": "actor_101" }, "actorId": { "type": "string", "description": "Actor ID reference", "example": "actor_101" }, "name": { "type": "string", "description": "Display name of the actor", "example": "John Customer" }, "email": { "type": "string", "description": "Email address of the actor", "format": "email", "example": "john@example.com" }, "type": { "type": "string", "description": "Type of actor (e.g., VISITOR, AGENT, BOT)", "example": "VISITOR" } }, "required": [ "id" ] } }, "recipients": { "type": "array", "description": "List of message recipients", "example": [ { "id": "actor_101", "actorId": "actor_101", "name": "John Customer", "email": "john@example.com", "type": "VISITOR" } ], "items": { "type": "object", "description": "Represents a participant in a conversation (visitor, agent, or bot).", "properties": { "id": { "type": "string", "description": "Unique identifier for the actor", "example": "actor_101" }, "actorId": { "type": "string", "description": "Actor ID reference", "example": "actor_101" }, "name": { "type": "string", "description": "Display name of the actor", "example": "John Customer" }, "email": { "type": "string", "description": "Email address of the actor", "format": "email", "example": "john@example.com" }, "type": { "type": "string", "description": "Type of actor (e.g., VISITOR, AGENT, BOT)", "example": "VISITOR" } }, "required": [ "id" ] } }, "status": { "type": "object", "description": "Delivery status information for a message", "properties": { "statusType": { "type": "string", "description": "Current delivery status type", "example": "DELIVERED", "enum": [ "SENT", "DELIVERED", "READ", "FAILED" ] } } }, "createdAt": { "type": "string", "description": "ISO 8601 timestamp when the message was created", "format": "date-time", "example": "2024-01-20T10:30:00Z" }, "truncationStatus": { "type": "string", "description": "Whether the message was truncated", "example": "NOT_TRUNCATED" }, "attachments": { "type": "array", "description": "Message attachments", "example": [ { "id": "attach_001", "type": "application/pdf", "url": "https://api.hubapi.com/files/v3/files/attach_001", "filename": "invoice.pdf", "size": 102400 } ], "items": { "type": "object", "description": "Represents a file attachment on a message.", "properties": { "id": { "type": "string", "description": "Unique identifier for the attachment", "example": "attach_001" }, "type": { "type": "string", "description": "MIME type of the attachment", "example": "application/pdf" }, "url": { "type": "string", "description": "URL to access the attachment", "format": "uri", "example": "https://api.hubapi.com/files/v3/files/attach_001" }, "filename": { "type": "string", "description": "Original filename", "example": "invoice.pdf" }, "size": { "type": "integer", "description": "File size in bytes", "example": 102400 } } } } }, "required": [ "id", "type", "createdAt" ] } }, "paging": { "type": "object", "description": "Pagination information for list responses.", "properties": { "next": { "type": "object", "description": "Pagination cursor information for retrieving the next page.", "properties": { "after": { "type": "string", "description": "Cursor token for the next page", "example": "NTI1Cg%3D%3D" }, "link": { "type": "string", "description": "API link to the next page", "example": "/conversations/v3/conversations/inboxes?after=NTI1Cg%3D%3D" } } } } } }, "required": [ "results" ], "$schema": "https://json-schema.org/draft/2020-12/schema", "title": "MessageCollection" }