Message Created

Subscription · messageCreated

messageCreated(conversationId: ID!): MessageView!

Nhận tin nhắn mới trong một DM hoặc kênh sau khi server đã lưu thành công. Sự kiện được phát cho lần tạo mới; retry sendMessage với cùng clientMessageId trả tin gốc mà không phát lại messageCreated. Payload gồm sequence và clientMessageId để client sắp thứ tự và gộp với tin đang hiển thị lạc quan.

Kết nối GraphQL WebSocket (graphql-ws) tại wss://<host>/graphql hoặc ws://<host>/graphql trong môi trường local. Truyền connectionParams.authorization: "Bearer <accessToken>". Cần đăng nhập và là thành viên conversation; server kiểm tra quyền khi đăng ký và trước mỗi sự kiện, đồng thời kiểm tra lại access token trước khi phát. WebSocket có thể mất sự kiện khi ngắt kết nối hoặc xử lý chậm, nên sau khi kết nối lại hãy dùng messagesSince từ sequence cao nhất đã giữ và gộp theo id/clientMessageId.

Input

Đối số	Kiểu GraphQL	Bắt buộc	Quy tắc và ý nghĩa
`conversationId`	`ID!`	Có	UUID của conversation muốn theo dõi; không nhận `null`, không có giá trị mặc định.

Output

Mỗi sự kiện trả về MessageView!, không null. Đây là trạng thái tin tại lúc tạo, không phải luồng lưu trữ để phát lại các tin bị bỏ lỡ.

MessageView

Trường	Kiểu GraphQL	Ý nghĩa
`id`	`ID!`	ID tin nhắn trên server.
`clientMessageId`	`String!`	ID client đã gửi.
`conversationId`	`ID!`	Conversation chứa tin nhắn.
`senderId`	`ID!`	Người gửi.
`sequence`	`Int!`	Thứ tự tăng trong conversation.
`type`	`MessageType!`	`TEXT` là tin do người dùng gửi; enum cũng có `SYSTEM`.
`content`	`String`	Nội dung; có thể rỗng với tin chỉ có tệp, hoặc `null` khi tin đã xóa mềm.
`replyToMessageId`	`ID`	ID tin được trả lời hoặc `null`.
`replyTo`	`MessageSummary`	Tóm tắt tin được trả lời hoặc `null`; xem MessageSummary.
`createdAt`	`DateTime!`	Thời điểm tạo.
`updatedAt`	`DateTime!`	Thời điểm cập nhật.
`deletedAt`	`DateTime`	Thời điểm xóa mềm hoặc `null`.
`attachments`	`[MessageAttachmentView!]!`	Tệp đính kèm; danh sách và phần tử không `null`. Xem MessageAttachmentView.
`reactions`	`[ReactionSummary!]!`	Phản ứng nhóm theo emoji; danh sách và phần tử không `null`. Xem ReactionSummary.

MessageSummary

Trường	Kiểu GraphQL	Ý nghĩa
`id`	`ID!`	ID tin được trả lời.
`senderId`	`ID!`	Người gửi tin đó.
`content`	`String`	Nội dung hoặc `null` nếu đã xóa.
`deletedAt`	`DateTime`	Thời điểm xóa mềm hoặc `null`.

MessageAttachmentView

Trường	Kiểu GraphQL	Ý nghĩa
`id`	`ID!`	ID tệp đính kèm để lấy URL tải hoặc xem trước.
`fileName`	`String!`	Tên tệp sau khi server xử lý.
`contentType`	`String!`	MIME type đã lưu.
`size`	`Int!`	Kích thước byte do client báo.

Trường	Kiểu GraphQL	Ý nghĩa
`emoji`	`String!`	Emoji phản ứng.
`userIds`	`[ID!]!`	ID người đã dùng emoji này; danh sách và phần tử không `null`.

Ví dụ

subscription MessageCreated($conversationId: ID!) {
  messageCreated(conversationId: $conversationId) {
    id
    clientMessageId
    conversationId
    senderId
    sequence
    type
    content
    replyToMessageId
    replyTo { id senderId content deletedAt }
    createdAt
    updatedAt
    deletedAt
    attachments { id fileName contentType size }
    reactions { emoji userIds }
  }
}

Biến:

{
  "conversationId": "33333333-3333-4333-8333-333333333333"
}

Một payload minh họa:

{
  "data": {
    "messageCreated": {
      "id": "55555555-5555-4555-8555-555555555555",
      "clientMessageId": "send-005",
      "conversationId": "33333333-3333-4333-8333-333333333333",
      "senderId": "11111111-1111-4111-8111-111111111111",
      "sequence": 5,
      "type": "TEXT",
      "content": "Chào bạn",
      "replyToMessageId": null,
      "replyTo": null,
      "createdAt": "2026-09-26T09:01:00.000Z",
      "updatedAt": "2026-09-26T09:01:00.000Z",
      "deletedAt": null,
      "attachments": [],
      "reactions": []
    }
  }
}

Thiếu hoặc sai Bearer token bị từ chối khi kết nối; ID sai định dạng trả BAD_USER_INPUT, còn người không phải thành viên conversation nhận FORBIDDEN. Nếu token hết hạn hoặc quyền thành viên bị thu hồi, lần phát tiếp theo sẽ ngừng stream. Subscription không bảo đảm nhận đủ sự kiện; dữ liệu đã lưu lấy bằng query.

Chữ ký operation được tạo từ GraphQL schema.