Skip to main content
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, Instagram và WhatsApp, 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: Đố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. WhatsApp đọc các tin nhắn đã nhận được thông qua webhooks của Meta, vì vậy một tin nhắn mới nhận có thể xuất hiện ngay khi Ayrshare xử lý webhook của nó. Phản hồi vẫn bao gồm metadata lastUpdatednextUpdate.
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.
Các cuộc trò chuyện WhatsApp được xác định bằng số điện thoại của người liên lạc (chỉ chữ số, dạng E.164 không có dấu + đứng đầu). Một tin nhắn đi (outbound) đã lưu có thể bao gồm giá trị statussent, delivered, read, hoặc failed.
Các tin nhắn WhatsApp được gửi thông qua Send Message hiện chưa được thêm vào lịch sử Get Messages. Các tin nhắn WhatsApp đến nhận được thông qua webhooks sẽ được lưu trữ và trả về ở đây.

Tham số Header

Tham số Path

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

Tham số Query

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.
string
Chỉ trả về cuộc trò chuyện cụ thể.
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.
Khi conversationsOnly=true, chi tiết cuộc trò chuyện được trả về trong converstationsDetails. Cách viết này là một phần của phản hồi API hiện tại.
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.
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.