すべてのコメントとメッセージを、コードで扱えるひとつのキューに
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 }
}ひとつのリスト
すべてのアカウントのコメントとメッセージを、新しい順に共通のフィールドで。
未読数
バッジの数字を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で既読、解決済み、スヌーズに変更すれば、2つのシステムが同じ項目を重複して扱うことはありません。
返信エンドポイントを見る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を通じて送信されます。
ステータス更新
既読、解決済み、スヌーズに変更すれば、対応済みの項目はキューから外れます。
明示的な送信
勝手に返信することはありません。送信するメッセージはすべて、利用者が行うリクエストです。
必要なときは最新に、そうでないときは静かに
受信箱は、接続したすべてのアカウントで定期的に同期されます。今すぐ最新が必要なときは、ワークスペースのrefreshエンドポイントを呼んでから再取得してください。ワークスペース単位なので、代理店のキーが見られるのは自社のクライアントの会話だけです。
開発を始める
オンデマンド更新
POST /v1/inbox/refreshで、ワークスペース内のすべてのアカウントの最新情報を取得します。
定期同期
バックグラウンド同期により、呼び出しなしでもリストが最新に保たれます。
ワークスペースで分離
投稿者の情報やメッセージ本文が、所属するワークスペースの外に出ることはありません。