REST APIGET

Resumo da caixa de entrada

Veja comentários, menções, mensagens e avaliações não lidos das suas contas, quais canais da caixa de entrada cada conta pode usar, e peça uma nova leitura.

A caixa de entrada reúne quatro canais das contas conectadas: comentários nas suas publicações, menções às suas contas em publicações de outras pessoas, mensagens diretas e avaliações do Google Business Profile. TikTok e X não têm caixa de entrada.

GEThttps://post.adaptlypost.com/post/api/v1/inbox/summary

Retorna a contagem de não lidos de cada canal e, para cada conta conectada, quais canais ela pode usar e quando foi lida pela última vez.

Chave API (Bearer token)

Permissão:inbox.readPapéis e permissões

Todos os papéis têm inbox.read, então qualquer chave válida pode ler a caixa de entrada.

Cerca de 10 minutos, não em tempo real

O AdaptlyPost lê cada conta conectada a cada 10 minutos e guarda o que encontra. As listas respondem a partir dessa cópia, então um novo comentário, menção, mensagem ou avaliação aparece em cerca de 10 minutos. POST /api/v1/inbox/refresh pede uma leitura agora. Os eventos de webhook vêm das mesmas leituras.

Canais que precisam de reconexão

Todos os canais estão abertos à API. Quando uma conexão não tem a permissão da plataforma para um canal ou ação, incluindo permissões que a plataforma ainda está analisando para o AdaptlyPost, GET /api/v1/inbox/summary mostra o canal como RECONNECT_REQUIRED e toda escrita nele responde 403 inbox_reconnect_required. Um token expirado responde o mesmo. Peça ao usuário que reconecte a conta no AdaptlyPost; tentar de novo não ajuda.

Plataformas suportadas

Quais canais cada plataforma tem. Uma conta só recebe um canal para o qual a conexão tem permissão; o resumo mostra isso por conta.

Plataforma	Comentários	Menções	Mensagens	Avaliações
`FACEBOOK`	Sim	Sim	Sim	Não
`INSTAGRAM`	Sim	Só leitura, para contas conectadas pelo Facebook	Sim	Não
`THREADS`	Sim	Sim	Não	Não
`YOUTUBE`	Sim	Não	Não	Não
`LINKEDIN`	Só páginas de organização	Não	Não	Não
`BLUESKY`	Sim	Sim	Sim	Não
`MASTODON`	Sim	Sim	Sim	Não
`GOOGLE_BUSINESS`	Não	Não	Não	Sim

Campos do resumo

Campo	Descrição
`unread`	Itens UNREAD por canal: comments, mentions, conversations e reviews
`accounts[].accountId`	O id da conta em GET /social-accounts, com platform, accountName e avatarUrl
`accounts[].needsReconnect`	True quando a conta precisa ser reconectada antes que seus comentários possam ser lidos
`accounts[].lastSyncedAt`	Quando o AdaptlyPost leu a conta pela última vez, ou null antes da primeira leitura
`accounts[].lastErrorCode`	Por que a última leitura falhou, ou null
`accounts[].comments`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED para esse canal. Veja abaixo
`accounts[].mentions`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED para esse canal. Veja abaixo
`accounts[].messages`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED para esse canal. Veja abaixo
`accounts[].reviews`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED para esse canal. Veja abaixo

Acesso aos canais

Valor	Descrição
`AVAILABLE`	A conta pode usar este canal
`RECONNECT_REQUIRED`	A plataforma tem o canal, mas esta conexão não tem a permissão para ele, ou o token expirou. As escritas respondem 403 inbox_reconnect_required até o usuário reconectar a conta no AdaptlyPost
`UNSUPPORTED`	A plataforma não tem esse canal

Ler as contas agora

POSThttps://post.adaptlypost.com/post/api/v1/inbox/refresh

Coloca na fila uma leitura de todas as contas conectadas em vez de esperar a próxima rodada de 10 minutos, e responde 202 { "queued": true }. As listas mudam quando a leitura termina.

Chave API (Bearer token)

Permissão:inbox.readPapéis e permissões

Recusas

Uma chamada recusada responde { statusCode, error, code, message }. Decida pelo code. message explica a recusa em palavras.

Código	Status	Quando, e o que fazer
`inbox_item_not_found`	404	O id não existe ou pertence a outro espaço de trabalho. Pare
`inbox_action_unsupported`	400	A plataforma, ou este item, não permite ocultar, excluir ou curtir. capabilities diz o que se aplica. Pare
`inbox_reconnect_required`	403	A conexão não tem a permissão para este canal ou ação, incluindo uma ainda em análise pela plataforma, ou o token expirou. Peça ao usuário que reconecte a conta no AdaptlyPost. Não tente de novo
`inbox_reply_invalid`	400	O texto está vazio ou passa do limite. A mensagem informa o limite. Corrija o texto
`inbox_messaging_window_closed`	400	Facebook ou Instagram: a janela de resposta de 24 horas já passou. Pare
`inbox_rate_limited`	429	A plataforma limitou as chamadas do AdaptlyPost. Tente de novo depois de um tempo
`inbox_platform_error`	503	A plataforma falhou. Tente de novo mais tarde
`permission_denied`	403	O papel da chave não tem inbox.read ou inbox.reply. Não tente de novo
`subscription_required`	403	Uma escrita sem plano ativo do AdaptlyPost. Não tente de novo

Ler o resumo da caixa de entrada

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/inbox/summary \
  --header 'Authorization: Bearer <api-key>'

Pedir uma leitura agora

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/refresh \
  --header 'Authorization: Bearer <api-key>'

202
{ "queued": true }

200

{
  "unread": {
    "comments": 12,
    "mentions": 3,
    "conversations": 2,
    "reviews": 1
  },
  "accounts": [
    {
      "accountId": "conn_ig_001",
      "platform": "INSTAGRAM",
      "accountName": "adaptlypost",
      "avatarUrl": "https://cdn.adaptlypost.com/avatars/ig_001.jpg",
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:40:12.000Z",
      "lastErrorCode": null,
      "comments": "AVAILABLE",
      "mentions": "AVAILABLE",
      "messages": "RECONNECT_REQUIRED",
      "reviews": "UNSUPPORTED"
    },
    {
      "accountId": "conn_gbp_001",
      "platform": "GOOGLE_BUSINESS",
      "accountName": "AdaptlyPost Kraków",
      "avatarUrl": null,
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:38:55.000Z",
      "lastErrorCode": null,
      "comments": "UNSUPPORTED",
      "mentions": "UNSUPPORTED",
      "messages": "UNSUPPORTED",
      "reviews": "AVAILABLE"
    }
  ]
}