Tin nhắn trực tiếp trên mọi mạng, từ chính code của bạn
FoPost giữ mọi luồng DM từ các tài khoản đã kết nối ở một nơi. Liệt kê hội thoại, bắt đầu hội thoại mới, nhắn cho cả một phân khúc liên hệ cùng lúc, hoặc rải một chuỗi tin nhắn qua nhiều ngày, tất cả với cùng một API key.
curl "https://api.fopost.com/v1/inbox/conversations?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY"
{
"data": [
{
"workspace_id": "9b2f6c1e-...",
"account_id": "4a71d80b-...",
"conversation_id": "t_1029384756",
"message_count": 6,
"unread_count": 2,
"last_message_at": "2026-11-10T16:42:08Z",
"last_message_text": "Is the large size back in stock?",
"last_message_outbound": false,
"participant": { "name": "Jordan P.", "handle": "jordanp", "avatar_url": "https://..." },
"account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }
}
],
"meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}Một danh sách luồng duy nhất
Mọi hội thoại DM từ mọi tài khoản đã kết nối, mới nhất lên đầu.
Broadcast
Một tin nhắn vào các luồng hiện có của một nhóm liên hệ đã lọc.
Chuỗi tin nhắn
Một chuỗi tin nhắn, mỗi tin gửi sau tin trước một số giờ nhất định.
Đọc một luồng, trả lời hoặc mở luồng mới
Trả lời trong một luồng có sẵn bằng POST /v1/inbox/:id/reply. Bắt đầu hội thoại mới theo handle trên X, Mastodon, Reddit và Slack, hoặc truyền comment_id để trả lời riêng một bình luận trên Instagram hoặc Facebook. Trên Facebook và Instagram, bạn cũng có thể hiển thị chỉ báo đang nhập, và trên Messenger có thể chuyển một luồng sang ứng dụng khác rồi nhận lại.
Đọc tài liệu tham chiếu hội thoạicurl -X POST https://api.fopost.com/v1/inbox/conversations \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"account_id": "4a71d80b-...",
"handle": "jordanp",
"text": "Thanks for the order. Your tracking link is on its way."
}'
{ "conversation_id": "t_1029384756", "item": { "id": "2c9d4e81-...", "type": "dm", ... } }Văn bản và media
Tối đa 10 media id từ thư viện của bạn đi kèm ở nơi mạng cho phép.
Đang nhập và chuyển giao
POST /v1/inbox/conversations/:id/typing và /handover cho hội thoại Meta.
X Chat
Hội thoại X được mã hóa đi qua dưới dạng bản mã; khóa nằm lại trong trình duyệt.
Nhắn cho một phân khúc mà không vi phạm quy tắc nền tảng
Broadcast đi vào các hội thoại mà tài khoản của bạn đã có với một nhóm liên hệ, được lọc theo mạng, nhãn, nguồn hoặc trường tùy chỉnh. Facebook, Instagram và WhatsApp chỉ cho phép tin nhắn doanh nghiệp trong vòng 24 giờ sau tin nhắn cuối của liên hệ, nên người nhận ngoài cửa sổ đó sẽ bị bỏ qua kèm lý do, không bao giờ bị thử gửi. Trên WhatsApp, một mẫu đã được duyệt có thể vượt qua giới hạn này.
Xem tài liệu tham chiếu broadcastcurl -X POST https://api.fopost.com/v1/broadcasts \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": "9b2f6c1e-...",
"account_id": "4a71d80b-...",
"name": "Restock, November",
"text": "The large size is back in stock this week.",
"audience": { "platforms": ["instagram"], "label_ids": ["d41e7a90-..."] }
}'
curl -X POST https://api.fopost.com/v1/broadcasts/8e2a5c13-.../send -H "X-API-Key: $API_KEY"
{ "id": "8e2a5c13-...", "status": "sending", "recipients": 212 }Gửi ngay hoặc gửi sau
Đặt scheduled_at để xếp hàng, hoặc hủy trước khi gửi.
Kết quả theo từng người nhận
GET /v1/broadcasts/:id/recipients hiển thị đã gửi, bỏ qua hay thất bại, và lý do.
Chỉ gửi một lần
Mỗi người nhận được giữ chỗ trước khi gửi, nên thử lại không bao giờ nhắn hai lần.
Theo dõi qua nhiều ngày, hoàn toàn tự động
Một chuỗi gồm tối đa 20 bước, mỗi bước là một tin nhắn và độ trễ tính bằng giờ sau bước trước. Đăng ký liên hệ theo id hoặc theo cùng bộ lọc đối tượng mà broadcast dùng, và hủy đăng ký bất cứ lúc nào. Bước nào rơi ngoài cửa sổ nhắn tin sẽ bị bỏ qua và chuỗi vẫn tiếp tục.
Xem tài liệu tham chiếu chuỗi tin nhắncurl -X POST https://api.fopost.com/v1/sequences/5b9c2e40-.../enroll \
-H "X-API-Key: $API_KEY" \
-H "Content-Type: application/json" \
-d '{ "contact_ids": ["a7f3c2d1-..."] }'
{ "id": "5b9c2e40-...", "enrolled": 1 }Tạm dừng bất cứ lúc nào
Đặt status thành paused và sẽ không có bước nào được gửi cho đến khi bạn tiếp tục.
Hủy đăng ký
POST /v1/sequences/:id/unenroll dừng một liên hệ ngay lập tức.
Số lượt đăng ký
Đang chạy, hoàn tất, đã dừng và thất bại, theo từng chuỗi.
Biết bạn đang nói chuyện với ai
Người nhắn tin cho tài khoản của bạn tự động trở thành liên hệ. Thêm thủ công hoặc nhập CSV tối đa 5.000 dòng với cột platform và cột handle. Định nghĩa tối đa 50 trường tùy chỉnh cho mỗi workspace (văn bản, số, ngày, lựa chọn hoặc có/không) và lọc broadcast cùng chuỗi tin nhắn theo các trường đó.
Bắt đầu xây dựng
Nhập CSV
POST /v1/contacts/import trả về các dòng đã tạo, đã gộp và đã bỏ qua kèm lý do.
Trường tùy chỉnh
Các cột khớp với key của một trường sẽ được điền khi nhập.
Lịch sử đầy đủ
GET /v1/contacts/:id/conversations liệt kê những gì mỗi liên hệ đã viết.
Giải đáp câu hỏi về Messaging API
Tôi có thể nhắn tin trên những mạng nào?
Cửa sổ nhắn tin là gì?
Tôi cần những scope API key nào?
Broadcast có thể nhắn cho người chưa từng nhắn cho chúng tôi không?
Có gì được gửi đi khi tôi không yêu cầu không?
Có giới hạn tốc độ không?
Xây dựng trên Messaging API 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 API key của bạn