API de comentários e caixa de entradaAPI

Todos os comentários e mensagens em uma única fila programável

FoPost reúne comentários e mensagens diretas de cada conta conectada em uma só caixa de entrada. Liste, conte o que não foi lido, marque itens como tratados e responda, tudo pela mesma API que o seu painel usa.

Obtenha sua chave de APILer a documentação
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 }
}

Uma lista

Comentários e mensagens de todas as contas, os mais recentes primeiro, com os mesmos campos.

Contagem de não lidos

Uma única chamada para o número do selo, por espaço de trabalho ou em todos eles.

Responda por código

Responda a um comentário ou mensagem e a resposta volta para a rede.

Ler

Encaminhe as conversas recebidas para o lugar certo

Consulte a caixa de entrada periodicamente ou sob demanda, filtre por tipo, conta ou status e encaminhe cada item para o seu helpdesk, seu canal de chat ou uma pessoa. Cada item tem um link para o post ao qual pertence, quando houver.

Ler a referência da caixa de entrada
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 }

Filtrar

Por tipo, conta, plataforma ou estado de leitura, com paginação por página.

Vinculado ao post

Os comentários trazem o post ao qual pertencem, para você cruzar com as análises.

Contas da caixa de entrada

GET /v1/inbox/accounts lista quais contas conectadas alimentam a caixa de entrada.

Responder

Responda onde o cliente perguntou

Envie um POST de resposta a um item da caixa de entrada e ela será publicada como resposta a um comentário ou mensagem direta na rede de origem, pela conta conectada. Marque itens como lidos, resolvidos ou adiados com PATCH para que dois sistemas nunca tratem o mesmo item.

Ver o endpoint de resposta
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" }'

Resposta nativa

Respostas a comentários e DMs saem pela API da própria rede.

Atualizações de status

read, resolved ou snoozed, para que os itens tratados saiam da fila.

Envios explícitos

Nada responde sozinho. Cada mensagem enviada é uma solicitação feita por você.

Sincronização

Atualizada quando você precisa, discreta quando não precisa

A caixa de entrada sincroniza periodicamente para cada conta conectada. Quando você precisar do mais recente agora mesmo, chame o endpoint de atualização do espaço de trabalho e leia novamente. Com a restrição por espaço de trabalho, uma chave de agência só vê as conversas do próprio cliente.

Comece a construir
Contas conectadas em todas as redes em um único espaço de trabalho

Atualização sob demanda

POST /v1/inbox/refresh busca o mais recente de todas as contas do espaço de trabalho.

Sincronização programada

A sincronização em segundo plano mantém a lista atualizada sem nenhuma chamada sua.

Isolado por espaço de trabalho

A identidade do autor e o texto das mensagens nunca saem do espaço de trabalho ao qual pertencem.

Perguntas sobre API de comentários e caixa de entrada, respondidas

Quais redes alimentam a caixa de entrada?

Qualquer conta conectada em uma rede que exponha comentários ou mensagens pela API. GET /v1/inbox/accounts informa exatamente quais das suas contas estão incluídas.

Posso responder a mensagens diretas?

Sim, onde a rede permitir e a conta tiver concedido permissão de mensagens. O endpoint de resposta retorna um erro com o motivo quando uma rede não permite.

Com que rapidez os novos comentários aparecem?

A sincronização em segundo plano roda periodicamente por conta. Chame o endpoint de atualização antes de ler quando precisar dos itens mais recentes agora mesmo.

A API pode responder automaticamente?

Não. A API nunca envia uma resposta sem uma solicitação sua. Se você criar respostas automáticas, a decisão de enviar fica no seu código.

Recebo o perfil do autor?

Você recebe o nome de exibição e o @ como a rede os expõe, além de um link para o item original. Os dados ficam dentro do espaço de trabalho ao qual a conta pertence.

Existe limite de requisições?

Sim, 100 solicitações por minuto por chave. Use a contagem de não lidos para polling e busque a lista completa apenas quando ela mudar.

Comece a construir com API de comentários e caixa de entrada hoje

Começar é grátis e a API completa está incluída. Crie uma chave e faça sua primeira chamada em minutos.

Obtenha sua chave de API