Sincronização de estatísticas

As estatísticas são lidas de cada plataforma em um cronograma, a cada poucas horas dependendo dos limites de taxa da plataforma. Dois endpoints permitem ver como está essa situação e pedir uma atualização quando você não pode esperar.

GET /api/v1/analytics/sync-status

GET /api/v1/analytics/sync-status

{
  "accountGroupId": "ag_01j9x",
  "syncInProgress": false,
  "lastSyncedAt": "2026-09-08T06:12:41.000Z",
  "historyHorizonAt": "2026-03-12T00:00:00.000Z",
  "platforms": [
    {
      "platform": "INSTAGRAM",
      "connectionId": "cmlxmnxn20006hzpzvo291ckg",
      "accountName": "adaptlypost",
      "status": "IDLE",
      "lastSyncedAt": "2026-09-08T06:12:41.000Z",
      "lastErrorMessage": null,
      "historyHorizonAt": "2026-03-12T00:00:00.000Z",
      "lastDiscoveryAt": "2026-09-08T06:10:03.000Z",
      "needsAnalyticsReconnect": false
    }
  ]
}

Field	Description
syncInProgress	Verdadeiro enquanto qualquer conta estiver na fila ou sincronizando
historyHorizonAt	Data mais antiga para a qual alguma conta tem dados. Datas anteriores não têm dados, e não atividade zero
connectionId	O `id` da conta em Contas de redes sociais
status	`IDLE`, `QUEUED`, `SYNCING` ou `FAILED`
lastErrorMessage	Por que a última sincronização falhou, quando falhou
needsAnalyticsReconnect	Verdadeiro quando a conta foi conectada antes de existirem as permissões de estatísticas

Contas em plataformas sem estatísticas (X) não são listadas.

Reconectando para estatísticas

As plataformas sociais não permitem que um aplicativo adicione permissões a uma autorização já concedida. Uma conta conectada antes de o AdaptlyPost pedir acesso às estatísticas fica parada, sem sincronizações e sem erros, até que o dono dela reconecte e aprove as permissões extras. É isso que needsAnalyticsReconnect sinaliza. Um link de conexão resolve isso, permitindo que um agente ou um cliente reconecte sem compartilhar uma senha.

POST /api/v1/analytics/sync

POST /api/v1/analytics/sync

Sem corpo. Enfileira uma sincronização para cada conta com estatísticas e relê os últimos 7 dias. Use logo após publicar, quando a atualização programada está longe demais.

{
  "queued": true,
  "message": "Analytics sync queued. Fresh numbers will appear within a few minutes",
  "cooldownSecondsRemaining": null
}

Uma execução por espaço de trabalho a cada 10 minutos. Dentro do período de espera, a resposta ainda é 200:

{
  "queued": false,
  "message": "Analytics were synced recently. Please try again in 412 seconds",
  "cooldownSecondsRemaining": 412
}

A execução é assíncrona. Consulte GET /api/v1/analytics/sync-status até que syncInProgress seja false, depois leia as métricas novamente. Não tente novamente dentro do período de espera; a resposta não vai mudar.