Chuyển đến nội dung chính
GET
Lấy tin nhắn hoặc cuộc trò chuyện cho một nền tảng messaging. Thời gian truy xuất khác nhau trên từng mạng xã hội. Trên Facebook và Instagram, tin nhắn có sẵn qua Ayrshare theo thời gian thực. Trên X/Twitter, có độ trễ lên đến 3 phút để thấy các cập nhật tin nhắn mới. Vui lòng liên hệ hỗ trợ để tìm hiểu thêm về gói Enterprise Plan nếu bạn cần truy cập tin nhắn X/Twitter theo thời gian thực.
Bộ nhớ đệm phản hồi: Các phản hồi GET messages được lưu vào bộ nhớ đệm để tối ưu hóa hiệu suất. Đối với FacebookInstagram, các phản hồi được lưu vào bộ nhớ đệm trong 60 giây. Đối với X/Twitter, các phản hồi được lưu vào bộ nhớ đệm trong 15 giây để hỗ trợ polling tốt hơn. Các trường lastUpdatednextUpdate trong phản hồi cho biết khi dữ liệu được lấy lần cuối và khi dữ liệu mới sẽ có sẵn.
Truy xuất lịch sử tin nhắn ban đầu cho Facebook và Instagram được giới hạn ở 20 tin nhắn cuối cùng. Vui lòng xem phần Truy xuất Lịch sử Tin nhắn cho Facebook và Instagram để biết thêm thông tin.

Tham số Header

Tham số Path

platform
string
bắt buộc
Nền tảng để lấy tin nhắn: facebook, instagram, twitter

Tham số Query

status
string
mặc định:"active"
bắt buộc
Trả về các cuộc trò chuyện đang hoạt động hoặc cuộc trò chuyện đã lưu trữ. Giá trị: active hoặc archived.
conversationId
string
Chỉ trả về cuộc trò chuyện cụ thể.
conversationsOnly
boolean
mặc định:false
Trả về tất cả các cuộc trò chuyện. Nếu true thì trường conversationId sẽ bị bỏ qua.
limit
integer
Chỉ dành cho X/Twitter. Giới hạn số lượng tin nhắn trả về mỗi request (1–100). Cho phép polling hiệu quả mà không cần đồng bộ lịch sử đầy đủ. Sử dụng với next để phân trang. Nếu bỏ qua, hành vi mặc định (truy xuất tin nhắn đầy đủ) sẽ được sử dụng.
next
string
Chỉ dành cho X/Twitter. Con trỏ phân trang đã mã hóa được trả về từ trường meta.pagination.next của request trước. Sử dụng với limit để lấy trang kết quả tiếp theo.