REST APIGET

Commenti della inbox

Elenca i commenti ai tuoi post su Facebook, Instagram, Threads, YouTube, LinkedIn, Bluesky e Mastodon, poi rispondi, nascondili, metti mi piace, eliminali o segnali come completati.

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

Restituisce i commenti ai post dei tuoi account, dal più recente. Risponde { comments, total, hasMore, nextCursor }.

Chiave API (Bearer token)

Permesso:inbox.readRuoli e permessi

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

Parametri della query

Parametro	Tipo	Descrizione
`accountIds`	`string[]`	Solo questi account, tramite l'id di GET /social-accounts. Ripeti la chiave o separa i valori con virgole. Fino a 50
`platforms`	`PlatformType[]`	Solo queste piattaforme. Ripeti la chiave o separa i valori con virgole
`statuses`	`InboxStatus[]`	Solo elementi in questi stati: UNREAD, READ o DONE. Ripeti la chiave o separa i valori con virgole
`since`	`string (ISO 8601)`	Solo elementi creati sulla piattaforma in questa data e ora o dopo
`search`	`string`	Testo da cercare
`postId`	`string`	Solo i commenti a questo post di AdaptlyPost, tramite il suo id di /social-posts
`platformPostId`	`string`	Solo i commenti a questo post, tramite l'id del post della piattaforma
`limit`	`number`	Elementi per pagina, da 1 a 100. Predefinito 25
`cursor`	`string`	Il nextCursor della pagina precedente. nextCursor è null nell'ultima pagina

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.

Campi del commento

Campo	Descrizione
`id`	ID del commento. Usalo con gli endpoint indicati sotto
`accountId`	L'account a cui appartiene l'elemento: il suo id di GET /social-accounts
`platform`	La piattaforma, come PlatformType
`accountName`	Nome visualizzato di quell'account
`postId`	L'id del post di AdaptlyPost, oppure null quando il post non è stato pubblicato tramite AdaptlyPost
`platformPostId`	L'id della piattaforma del post su cui si trova il commento
`postText`	Testo di quel post
`postPermalink`	Link a quel post
`platformCommentId`	L'id della piattaforma del commento
`parentPlatformCommentId`	L'id della piattaforma del commento a cui questo risponde, oppure null per un commento di primo livello
`isReply`	True quando il commento risponde a un altro commento
`author`	Chi l'ha scritto: id (l'id utente della piattaforma), name, username e avatarUrl. id, username e avatarUrl possono essere null
`text`	Il testo del commento
`permalink`	Link pubblico sulla piattaforma, oppure null quando la piattaforma non ne fornisce uno
`likeCount`	Mi piace sul commento, oppure null quando la piattaforma non li riporta
`createdAt`	Quando è stato creato sulla piattaforma
`status`	UNREAD, READ o DONE. Solo AdaptlyPost conserva questo stato; la piattaforma non lo vede
`isHidden`	True quando il commento è nascosto sulla piattaforma
`isOwn`	True quando l'ha scritto il tuo account
`replied`	True quando il tuo account ha una risposta sotto il commento, inviata da AdaptlyPost o dall'app della piattaforma
`repliedAt`	Quando il tuo account ha risposto l'ultima volta, oppure null
`likedByAccount`	True quando il tuo account ha messo mi piace
`capabilities`	canReply, canHide, canDelete e canLike: cosa permette questo commento. Controllali prima di chiamare un'azione

Leggi una discussione

GEThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id

Restituisce { comment, parent, replies }: il commento, il commento a cui risponde (null per un commento di primo livello) e le risposte sotto di esso. Un id sconosciuto risponde 404 inbox_item_not_found.

Chiave API (Bearer token)

Permesso:inbox.readRuoli e permessi

Rispondi a un commento

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/reply

Pubblica una risposta dell'account sotto il commento e risponde 201 con la nuova risposta come commento.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

Le scritture richiedono inbox.reply (Amministratore ed Editor) e un piano AdaptlyPost attivo. Senza il piano rispondono 403 subscription_required.

Parametri del corpo

Parametro	Tipo	Descrizione
`text`OBBLIGATORIO	`string`	La risposta. Segue il limite dei commenti della piattaforma: LinkedIn 1250, Threads 500, Bluesky 300, Mastodon 500, YouTube 10000, Facebook 8000 e Instagram 2200 caratteri

Nascondere, mettere mi piace ed eliminare

Ogni azione risponde 400 inbox_action_unsupported quando la piattaforma o il commento non la permette. capabilities sul commento te lo dice in anticipo.

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/hide

Nasconde il commento sulla piattaforma e risponde 200 con il commento.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/unhide

Mostra di nuovo un commento nascosto e risponde 200 con il commento.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/like

Mette mi piace al commento dall'account e risponde 200 con il commento.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

DELETEhttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/like

Toglie il mi piace dell'account e risponde 200 con il commento.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

DELETEhttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id

Elimina il commento sulla piattaforma e dalla inbox di AdaptlyPost, e risponde 200 { "deleted": true }.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

Eliminare e mettere mi piace per piattaforma

Cosa permette ogni piattaforma all'account di eliminare e di apprezzare. Su Threads l'eliminazione richiede il permesso threads_delete, quindi un collegamento Threads meno recente risponde 403 inbox_reconnect_required finché non viene ricollegato.

Piattaforma	Eliminare	Mi piace e togliere mi piace
`FACEBOOK`	Qualsiasi commento ai post della Pagina	Sì
`INSTAGRAM`	Qualsiasi commento ai post dell'account	No
`YOUTUBE`	Solo i commenti del canale stesso	No
`THREADS`	Solo le risposte dell'account stesso	No
`BLUESKY`	Solo le risposte dell'account stesso	Sì
`MASTODON`	Solo le risposte dell'account stesso	Sì, come preferito
`LINKEDIN`	Qualsiasi commento ai post dell'organizzazione	Sì

Segna come letto o completato

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/status

Imposta lo stato di un massimo di 100 commenti e risponde { comments, unreadCount }.

Chiave API (Bearer token)

Permesso:inbox.replyRuoli e permessi

Parametri del corpo

Parametro	Tipo	Descrizione
`ids`OBBLIGATORIO	`string[]`	Da 1 a 100 id presi dall'elenco
`status`OBBLIGATORIO	`InboxStatus`	UNREAD, READ o DONE

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

Elenca i commenti non letti

curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/inbox/comments?statuses=UNREAD&platforms=INSTAGRAM,FACEBOOK&limit=25' \
  --header 'Authorization: Bearer <api-key>'

Leggi una discussione di commenti

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

200
{
  "comment": { "id": "cmt_8f2a1c40", "isReply": false, "...": "..." },
  "parent": null,
  "replies": [
    { "id": "cmt_9b31d7e2", "isReply": true, "isOwn": true, "...": "..." }
  ]
}

Rispondi a un commento

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/reply \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "Thanks Ana, the new plan starts on Monday." }'

Nascondi, metti mi piace o elimina un commento

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

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

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

Segna i commenti come completati

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/status \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": ["cmt_8f2a1c40", "cmt_7c02e9a1"], "status": "DONE" }'

200

{
  "comments": [
    {
      "id": "cmt_8f2a1c40",
      "accountId": "conn_ig_001",
      "platform": "INSTAGRAM",
      "accountName": "adaptlypost",
      "postId": "cmm0z0k3q0000i0r5mxn0hfhs",
      "platformPostId": "18034417852490123",
      "postText": "Plan a week of posts in one sitting",
      "postPermalink": "https://www.instagram.com/p/C9x2Lm0tQ1a/",
      "platformCommentId": "17890455123456789",
      "parentPlatformCommentId": null,
      "isReply": false,
      "author": {
        "id": "17841400000000001",
        "name": "Ana Souza",
        "username": "ana.souza",
        "avatarUrl": null
      },
      "text": "Does this work with Reels too?",
      "permalink": null,
      "likeCount": 2,
      "createdAt": "2026-11-08T09:12:44.000Z",
      "status": "UNREAD",
      "isHidden": false,
      "isOwn": false,
      "replied": false,
      "repliedAt": null,
      "likedByAccount": false,
      "capabilities": {
        "canReply": true,
        "canHide": true,
        "canDelete": true,
        "canLike": false
      }
    }
  ],
  "total": 12,
  "hasMore": false,
  "nextCursor": null
}