모든 댓글과 메시지를 코드로 다룰 수 있는 하나의 대기열에
FoPost가 연결된 각 계정의 댓글과 다이렉트 메시지를 하나의 인박스로 모아요. 목록을 조회하고, 읽지 않은 항목 수를 세고, 처리 완료로 표시하고, 답장하세요. 모두 대시보드가 쓰는 것과 같은 API로 할 수 있어요.
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 }
}목록 하나
모든 계정의 댓글과 메시지를 최신순으로, 같은 필드로 제공해요.
읽지 않은 항목 수
배지 숫자를 호출 한 번으로, 워크스페이스별 또는 전체로 가져와요.
코드로 답장
댓글이나 메시지에 답하면 답장이 네트워크로 전송돼요.
들어오는 대화를 알맞은 곳으로 전달
일정에 따라 또는 필요할 때 인박스를 폴링하고, 유형, 계정, 상태로 필터링한 뒤 각 항목을 헬프데스크, 채팅 채널, 또는 담당자에게 전달하세요. 연결된 게시물이 있으면 모든 항목이 해당 게시물로 연결돼요.
인박스 레퍼런스 읽기curl "https://api.fopost.com/v1/inbox/unread-count?workspace_id=9b2f6c1e-..." \
-H "X-API-Key: $API_KEY"
{ "count": 14 }필터
유형, 계정, 플랫폼, 읽음 상태별로, 페이지 단위 페이지네이션과 함께.
게시물과 연결
댓글에 해당 게시물이 담겨 있어 분석 데이터와 결합할 수 있어요.
인박스 계정
GET /v1/inbox/accounts가 인박스로 들어오는 연결 계정을 보여 줘요.
고객이 물어본 곳에서 답변
인박스 항목에 답장을 POST하면 원래 네트워크에서 연결된 계정으로 댓글 답글이나 다이렉트 메시지로 게시돼요. PATCH로 항목을 읽음, 해결됨, 다시 알림으로 표시해 두 시스템이 같은 항목을 처리하지 않게 하세요.
답장 엔드포인트 보기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" }'네이티브 답장
댓글 답글과 DM은 네트워크 자체 API를 통해 전송돼요.
상태 업데이트
read, resolved, snoozed로 처리된 항목은 대기열에서 빠져요.
명시적 전송
아무것도 저절로 답장하지 않아요. 모든 발신 메시지는 직접 보낸 요청이에요.
필요할 땐 최신으로, 아닐 땐 조용히
인박스는 연결된 모든 계정에 대해 정해진 일정에 따라 동기화돼요. 지금 바로 최신 내용이 필요하면 워크스페이스의 refresh 엔드포인트를 호출하고 다시 읽으세요. 워크스페이스 범위 덕분에 에이전시 키는 해당 클라이언트의 대화만 볼 수 있어요.
개발 시작하기
필요할 때 새로고침
POST /v1/inbox/refresh가 워크스페이스의 모든 계정에서 최신 내용을 가져와요.
예약 동기화
백그라운드 동기화가 별도 호출 없이 목록을 최신 상태로 유지해요.
워크스페이스 격리
작성자 정보와 메시지 내용은 해당 워크스페이스 밖으로 나가지 않아요.