REST APIGET

Riepilogo della inbox

Vedi commenti, menzioni, messaggi e recensioni non letti di tutti i tuoi account, quali canali della inbox può usare ogni account, e chiedi una nuova lettura.

La inbox riunisce quattro canali degli account collegati: i commenti ai tuoi post, le menzioni dei tuoi account nei post di altre persone, i messaggi diretti e le recensioni di Google Business Profile. TikTok e X non hanno una inbox.

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

Restituisce il numero di elementi non letti di ogni canale e, per ogni account collegato, quali canali può usare e quando è stato letto l'ultima volta.

Chiave API (Bearer token)

Permesso:inbox.readRuoli e permessi

Ogni ruolo ha inbox.read, quindi qualsiasi chiave valida può leggere la inbox.

Circa 10 minuti, non in tempo reale

AdaptlyPost legge ogni account collegato ogni 10 minuti e conserva ciò che trova. Gli elenchi rispondono da quella copia, quindi un nuovo commento, menzione, messaggio o recensione compare entro circa 10 minuti. POST /api/v1/inbox/refresh chiede una lettura subito. Gli eventi webhook nascono dalle stesse letture.

Canali che richiedono di ricollegare l'account

Ogni canale è accessibile dall'API. Quando a un collegamento manca il permesso della piattaforma per un canale o un'azione, compresi i permessi che la piattaforma sta ancora esaminando per AdaptlyPost, GET /api/v1/inbox/summary mostra il canale come RECONNECT_REQUIRED e ogni scrittura su di esso risponde 403 inbox_reconnect_required. Un token scaduto risponde allo stesso modo. Chiedi all'utente di ricollegare l'account in AdaptlyPost; riprovare non serve.

Piattaforme supportate

Quale canale ha ogni piattaforma. Un account ottiene solo i canali per cui il suo collegamento ha il permesso; il riepilogo lo indica per ogni account.

Piattaforma	Commenti	Menzioni	Messaggi	Recensioni
`FACEBOOK`	Sì	Sì	Sì	No
`INSTAGRAM`	Sì	Sola lettura, per account collegati tramite Facebook	Sì	No
`THREADS`	Sì	Sì	No	No
`YOUTUBE`	Sì	No	No	No
`LINKEDIN`	Solo pagine aziendali	No	No	No
`BLUESKY`	Sì	Sì	Sì	No
`MASTODON`	Sì	Sì	Sì	No
`GOOGLE_BUSINESS`	No	No	No	Sì

Campi del riepilogo

Campo	Descrizione
`unread`	Elementi UNREAD per canale: comments, mentions, conversations e reviews
`accounts[].accountId`	L'id dell'account di GET /social-accounts, con platform, accountName e avatarUrl
`accounts[].needsReconnect`	True quando l'account va ricollegato prima di poterne leggere i commenti
`accounts[].lastSyncedAt`	Quando AdaptlyPost ha letto l'account l'ultima volta, oppure null prima della prima lettura
`accounts[].lastErrorCode`	Perché l'ultima lettura non è riuscita, oppure null
`accounts[].comments`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED per quel canale. Vedi sotto
`accounts[].mentions`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED per quel canale. Vedi sotto
`accounts[].messages`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED per quel canale. Vedi sotto
`accounts[].reviews`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED per quel canale. Vedi sotto

Accesso ai canali

Valore	Descrizione
`AVAILABLE`	L'account può usare questo canale
`RECONNECT_REQUIRED`	La piattaforma ha il canale, ma a questo collegamento manca il permesso, oppure il suo token è scaduto. Le scritture rispondono 403 inbox_reconnect_required finché l'utente non ricollega l'account in AdaptlyPost
`UNSUPPORTED`	La piattaforma non ha questo canale

Leggi gli account subito

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

Mette in coda una lettura di ogni account collegato invece di aspettare il prossimo giro di 10 minuti, e risponde 202 { "queued": true }. Gli elenchi cambiano quando la lettura è finita.

Chiave API (Bearer token)

Permesso:inbox.readRuoli e permessi

Rifiuti

Una chiamata rifiutata risponde { statusCode, error, code, message }. Decidi in base a code. message spiega il rifiuto a parole.

Codice	Stato	Quando, e cosa fare
`inbox_item_not_found`	404	L'id non esiste o appartiene a un altro workspace. Fermati
`inbox_action_unsupported`	400	La piattaforma, o questo elemento, non permette di nascondere, eliminare o mettere mi piace. capabilities indica cosa vale. Fermati
`inbox_reconnect_required`	403	Al collegamento manca il permesso per questo canale o azione, anche se è ancora in revisione presso la piattaforma, oppure il suo token è scaduto. Chiedi all'utente di ricollegare l'account in AdaptlyPost. Non riprovare
`inbox_reply_invalid`	400	Il testo è vuoto o supera il limite. Il messaggio indica il limite. Correggi il testo
`inbox_messaging_window_closed`	400	Facebook o Instagram: la finestra di 24 ore per rispondere è chiusa. Fermati
`inbox_rate_limited`	429	La piattaforma ha limitato le richieste di AdaptlyPost. Riprova tra un po'
`inbox_platform_error`	503	La piattaforma ha avuto un errore. Riprova più tardi
`permission_denied`	403	Il ruolo della chiave non ha inbox.read o inbox.reply. Non riprovare
`subscription_required`	403	Una scrittura senza un piano AdaptlyPost attivo. Non riprovare

Leggi il riepilogo della inbox

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

Chiedi una lettura subito

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"
    }
  ]
}