评论与收件箱 APIAPI

每条评论和消息，都在一个可编程的队列里

FoPost 把每个已连接账号的评论和私信汇集到一个收件箱。列出它们、统计未读数、标记为已处理并回复，全部通过控制台使用的同一套 API 完成。

获取 API 密钥阅读文档
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 }
}

一个列表

所有账号的评论和消息，最新的在前，字段统一。

未读计数

一次调用拿到角标数字，可按单个工作区或全部工作区统计。

用代码回复

回复一条评论或消息，回复内容就会发回到对应网络。

读取

把收到的对话分发到正确的地方

定时或按需轮询收件箱，按类型、账号或状态筛选，再把每一项转发到你的客服系统、聊天频道或某位同事。只要有对应的帖子，每一项都会链接回它所属的帖子。

阅读收件箱参考文档
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 }

筛选

按类型、账号、平台或已读状态筛选，支持分页。

关联到帖子

评论带有所属帖子的信息，你可以把它们与数据分析关联起来。

收件箱账号

GET /v1/inbox/accounts 列出哪些已连接账号会汇入收件箱。

回复

在客户提问的地方回答

对收件箱中的一项 POST 回复，它就会以评论回复或私信的形式，从已连接账号发布到原始网络。用 PATCH 把项目标记为已读、已解决或稍后处理，两个系统就不会重复处理同一项。

查看回复端点
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" }'

原生回复

评论回复和私信通过网络自己的 API 发出。

状态更新

read、resolved 或 snoozed，已处理的项目会移出队列。

明确发送

不会自行回复。每条外发消息都来自你发起的请求。

同步

需要时最新，不需要时安静

收件箱会为每个已连接账号定时同步。当你现在就需要最新内容时，调用该工作区的刷新端点后再读取。按工作区隔离意味着代理机构的密钥只能看到其客户自己的对话。

开始构建
一个工作区中跨所有网络的已连接账号

按需刷新

POST /v1/inbox/refresh 拉取工作区中每个账号的最新内容。

定时同步

后台同步让列表保持最新，无需你发起任何调用。

按工作区隔离

作者身份和消息文本永远不会离开它们所属的工作区。

关于 评论与收件箱 API 的常见问题解答

哪些网络会汇入收件箱？

任何已连接账号，只要其网络通过 API 开放评论或消息。GET /v1/inbox/accounts 会准确告诉你包含了哪些账号。

可以回复私信吗？

可以，前提是网络允许且账号已授予消息权限。网络不允许时，回复端点会返回说明原因的错误。

新评论多快会出现？

后台同步按账号定时运行。如果你现在就需要最新内容，读取前先调用刷新端点。

API 能自动回复吗？

不能。没有你的请求，API 绝不会发送回复。如果你要做自动回复，是否发送由你的代码决定。

能获取作者的资料吗？

你会获得网络所提供的显示名称和用户名，以及指向原始内容的链接。数据始终留在账号所属的工作区内。

有速率限制吗？

有，每个密钥每分钟 100 次请求。用未读计数来轮询，只在它变化时再获取完整列表。

今天就基于 评论与收件箱 API 开始构建

免费开始，包含完整 API。创建密钥，几分钟内完成第一次调用。

获取 API 密钥