Đọc lại lịch sử hội thoại

GET https://agents.fpt.ai/direct-bff/v1/conversations/7412/messages?after=9001&limit=30
Authorization: Bearer <khóa API của tổ chức>

{
  "conversationId": "7412",
  "messages": [
    {
      "id": "9001", "role": "user", "from": "customer",
      "text": "Đơn của tôi đâu?", "createdAt": "2026-09-14T10:30:00Z",
      "attachments": [
        { "name": "hoa-don.pdf", "type": "application/pdf", "size": 1024 }
      ]
    },
    {
      "id": "9002", "role": "assistant", "from": "bot",
      "text": "Để tôi kiểm tra giúp bạn.", "createdAt": "2026-09-14T10:30:04Z",
      "buttons": [
        { "type": "postback", "title": "Theo dõi đơn", "data": "track:SO-7781" }
      ]
    },
    {
      "id": "9003", "role": "assistant", "from": "operator",
      "text": "Đơn của anh đã xử lý xong ạ.", "createdAt": "2026-09-14T10:41:00Z"
    }
  ],
  "limit": 30,
  "hasMore": false
}

​

Lưu ý

• Dùng khóa API của tổ chức, không dùng khóa ký của kênh. Xem cách tạo tại Khóa API và hạn mức. visitorToken của Live Chat cũng đọc được đúng phiên của chính nó, dùng để giao diện tự dựng lấy lại hội thoại sau khi khách tải lại trang. Đọc phiên khác trả về 403 SESSION_FORBIDDEN.
• Phân trang bằng con trỏ, tin cũ nhất trước. Truyền after bằng mã tin nhắn cuối cùng bạn đang giữ; hasMore cho biết còn trang tiếp theo hay không.
• Mã tin nhắn là chuỗi (vượt ngưỡng số nguyên an toàn của JavaScript) nhưng vẫn sắp xếp theo thứ tự số.
• Hãy đọc from, đừng đọc role. Lượt trả lời của nhân viên được lưu với cùng role như của Agent. Ở đây from có ba giá trị: customer, bot, operator.
• Giá trị operator hiện chưa phát sinh, vì nền tảng chưa có tính năng cho nhân viên trả lời thay Agent trên kênh này. Hãy coi nó là giá trị hợp lệ nhưng đừng chờ nó xuất hiện.
• Mỗi dòng trả về là một lượt nói thật sự, chỉ xuất hiện khi có text, nút bấm, quick reply, carousel, thẻ trích dẫn hoặc tệp đính kèm. Bạn không cần tự lọc bong bóng trống.
• after sai định dạng trả về 400, không bị âm thầm bỏ qua.
• Một mã 404 cho ba trường hợp: hội thoại không tồn tại, thuộc tổ chức khác, hoặc là hội thoại nội bộ của nhân viên.
• Tệp đính kèm chỉ nêu tên, kiểu và kích thước, không kèm khóa đối tượng, vì đây là tệp do chính người gửi tải lên.
• Đọc lịch sử không tiêu tốn hạn mức lượt chạy. Nó có hạn mức riêng, mặc định 120 lần mỗi phút cho mỗi khóa API. Khi vượt, phản hồi 429 chỉ kèm header Retry-After.