API bình luận và hộp thưAPI

Mọi bình luận và tin nhắn, trong một hàng đợi bạn có thể lập trình

FoPost kéo bình luận và tin nhắn trực tiếp từ từng tài khoản đã kết nối vào một hộp thư. Liệt kê, đếm số chưa đọc, đánh dấu đã xử lý và trả lời, tất cả qua chính API mà bảng điều khiển của bạn dùng.

GET /v1/inbox
curl "https://api.fopost.com/v1/inbox?workspace_id=9b2f6c1e-...&state=unread" \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    { "id": "1f8b6a37-...", "type": "comment", "state": "unread", "platform": "instagram", "author_name": "Customer", "author_handle": "customer", "text": "Does this ship to Canada?", "post": { "id": "7d3e0a52-...", "title": "Launch day" }, "platform_created_at": "2026-08-29T14:02:11Z", "can_reply": true, "account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." },
    { "id": "2c9d4e81-...", "type": "dm", "state": "unread", "platform": "facebook", "author_name": "Jordan P.", "author_handle": null, "text": "Hi, I need help with an order.", "post": null, "platform_created_at": "2026-08-29T13:48:30Z", "can_reply": true, "account": { "id": "c30e9f12-...", "platform": "facebook", "username": "yourbrand" }, "workspace_id": "9b2f6c1e-..." }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 2, "total_pages": 1 }
}

Một danh sách

Bình luận và tin nhắn từ mọi tài khoản, mới nhất trước, với cùng các trường.

Số chưa đọc

Một lệnh gọi duy nhất để lấy con số trên huy hiệu, theo từng không gian làm việc hoặc tất cả.

Trả lời bằng code

Trả lời bình luận hoặc tin nhắn và câu trả lời được gửi về lại mạng đó.

Đọc

Chuyển cuộc trò chuyện đến đúng nơi

Truy vấn hộp thư theo lịch hoặc khi cần, lọc theo loại, tài khoản hoặc trạng thái, và chuyển từng mục đến helpdesk, kênh chat hoặc một người xử lý. Mỗi mục liên kết ngược về bài đăng mà nó thuộc về, nếu có.

Đọc tài liệu tham khảo về hộp thư
GET /v1/inbox/unread-count
curl "https://api.fopost.com/v1/inbox/unread-count?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

{ "count": 14 }

Lọc

Theo loại, tài khoản, nền tảng hoặc trạng thái đã đọc, có phân trang.

Liên kết với bài đăng

Bình luận mang theo bài đăng mà nó thuộc về, để bạn ghép với số liệu phân tích.

Tài khoản của hộp thư

GET /v1/inbox/accounts liệt kê những tài khoản đã kết nối đang cấp dữ liệu cho hộp thư.

Trả lời

Trả lời ngay nơi khách hàng hỏi

POST một câu trả lời cho mục trong hộp thư và nó được đăng dưới dạng trả lời bình luận hoặc tin nhắn trực tiếp trên mạng gốc, từ tài khoản đã kết nối. Đánh dấu mục là đã đọc, đã giải quyết hoặc tạm hoãn bằng PATCH để hai hệ thống không bao giờ xử lý trùng một mục.

Xem endpoint trả lời
POST /v1/inbox/:id/reply
curl -X POST https://api.fopost.com/v1/inbox/1f8b6a37-.../reply \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text": "Yes, we ship to Canada. Delivery takes 3 to 5 days." }'

curl -X PATCH https://api.fopost.com/v1/inbox/1f8b6a37-... \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "state": "read" }'

Trả lời gốc

Trả lời bình luận và DM được gửi qua API gốc của mạng.

Cập nhật trạng thái

read, resolved hoặc snoozed, để các mục đã xử lý rời khỏi hàng đợi.

Gửi có chủ đích

Không có gì tự trả lời. Mọi tin nhắn gửi đi đều là một yêu cầu do bạn thực hiện.

Đồng bộ

Cập nhật khi bạn cần, yên lặng khi bạn không cần

Hộp thư đồng bộ theo lịch cho mọi tài khoản đã kết nối. Khi bạn cần dữ liệu mới nhất ngay lập tức, gọi endpoint refresh cho không gian làm việc rồi đọc lại. Giới hạn theo không gian làm việc nghĩa là khóa của agency chỉ thấy cuộc trò chuyện của chính khách hàng đó.

Bắt đầu xây dựng
Các tài khoản đã kết nối trên mọi mạng trong một không gian làm việc

Làm mới theo yêu cầu

POST /v1/inbox/refresh kéo dữ liệu mới nhất cho mọi tài khoản trong không gian làm việc.

Đồng bộ theo lịch

Đồng bộ nền giữ danh sách luôn cập nhật mà bạn không cần gọi gì.

Tách biệt theo không gian làm việc

Danh tính người viết và nội dung tin nhắn không bao giờ rời khỏi không gian làm việc mà chúng thuộc về.

Giải đáp câu hỏi về API bình luận và hộp thư

Những mạng nào cấp dữ liệu cho hộp thư?

Mọi tài khoản đã kết nối trên một mạng cung cấp bình luận hoặc tin nhắn qua API của nó. GET /v1/inbox/accounts cho bạn biết chính xác tài khoản nào được đưa vào.

Tôi có thể trả lời tin nhắn trực tiếp không?

Có, khi mạng cho phép và tài khoản đã cấp quyền nhắn tin. Endpoint trả lời trả về lỗi nêu rõ lý do khi một mạng không cho phép.

Bình luận mới xuất hiện nhanh đến mức nào?

Đồng bộ nền chạy theo lịch cho từng tài khoản. Gọi endpoint refresh trước khi đọc khi bạn cần các mục mới nhất ngay lập tức.

API có thể tự động trả lời không?

Không. API không bao giờ gửi câu trả lời nếu không có yêu cầu từ bạn. Nếu bạn xây dựng trả lời tự động, quyết định gửi nằm trong code của bạn.

Tôi có nhận được hồ sơ của người viết không?

Bạn nhận được tên hiển thị và handle theo những gì mạng cung cấp, cùng liên kết đến mục gốc. Dữ liệu nằm gọn trong không gian làm việc mà tài khoản thuộc về.

Có giới hạn tần suất không?

Có, 100 yêu cầu mỗi phút cho mỗi khóa. Dùng số chưa đọc để truy vấn định kỳ và chỉ lấy toàn bộ danh sách khi nó thay đổi.

Xây dựng trên API bình luận và hộp thư ngay hôm nay

Bắt đầu miễn phí và đã bao gồm đầy đủ API. Tạo khóa và thực hiện lệnh gọi đầu tiên chỉ trong vài phút.

Lấy khóa API