API commenti e inboxAPI

Ogni commento e messaggio in un'unica coda programmabile

FoPost riunisce in un'unica inbox commenti e messaggi diretti di ogni account collegato. Elencali, conta i non letti, segna gli elementi come gestiti e rispondi, tutto con la stessa API usata dalla dashboard.

Ottieni la tua chiave API Leggi la documentazione

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

Un unico elenco

Commenti e messaggi da ogni account, dal più recente, con gli stessi campi.

Conteggio non letti

Una sola chiamata per il numero sul badge, per workspace o su tutti.

Rispondi dal codice

Rispondi a un commento o a un messaggio e la risposta torna sulla rete.

Lettura

Instrada le conversazioni in arrivo nel posto giusto

Interroga l'inbox a intervalli regolari o su richiesta, filtra per tipo, account o stato e inoltra ogni elemento al tuo helpdesk, al tuo canale chat o a una persona. Ogni elemento rimanda al post a cui appartiene, quando esiste.

Leggi il riferimento inbox

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 }

Filtra

Per tipo, account, piattaforma o stato di lettura, con paginazione a pagine.

Collegato al post

I commenti indicano il post a cui appartengono, così puoi unirli alle analisi.

Account dell'inbox

GET /v1/inbox/accounts elenca gli account collegati che alimentano l'inbox.

Risposta

Rispondi dove il cliente ha chiesto

Invia con POST una risposta a un elemento dell'inbox e viene pubblicata come risposta a un commento o messaggio diretto sulla rete d'origine, dall'account collegato. Segna gli elementi come letti, risolti o posticipati con PATCH, così due sistemi non gestiscono mai lo stesso elemento.

Vedi l'endpoint di risposta

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

Risposta nativa

Risposte ai commenti e DM escono tramite l'API della rete stessa.

Aggiornamenti di stato

read, resolved o snoozed, così gli elementi gestiti escono dalla coda.

Invii espliciti

Niente risponde da solo. Ogni messaggio in uscita è una richiesta che fai tu.

Sincronizzazione

Aggiornata quando ti serve, silenziosa quando non ti serve

L'inbox si sincronizza periodicamente per ogni account collegato. Quando ti servono subito i dati più recenti, chiama l'endpoint di aggiornamento del workspace e rileggi. Con la limitazione al workspace, la chiave di un'agenzia vede solo le conversazioni del proprio cliente.

Inizia a sviluppare

Account collegati su tutte le reti in un unico workspace

Aggiornamento su richiesta

POST /v1/inbox/refresh recupera le novità di ogni account del workspace.

Sincronizzazione programmata

La sincronizzazione in background mantiene aggiornato l'elenco senza alcuna chiamata da parte tua.

Isolato per workspace

Identità dell'autore e testo dei messaggi non escono mai dal workspace a cui appartengono.

API commenti e inbox: le risposte alle tue domande

Quali reti alimentano l'inbox?

Qualsiasi account collegato su una rete che espone commenti o messaggi tramite API. GET /v1/inbox/accounts ti dice esattamente quali dei tuoi account sono inclusi.

Posso rispondere ai messaggi diretti?

Sì, dove la rete lo consente e l'account ha concesso il permesso di messaggistica. Quando una rete non lo consente, l'endpoint di risposta restituisce un errore che ne indica il motivo.

Quanto velocemente compaiono i nuovi commenti?

La sincronizzazione in background viene eseguita periodicamente per ogni account. Chiama l'endpoint di aggiornamento prima di leggere quando ti servono subito gli elementi più recenti.

L'API può rispondere in automatico?

No. L'API non invia mai una risposta senza una tua richiesta. Se crei risposte automatiche, la decisione di inviare sta nel tuo codice.

Ricevo il profilo dell'autore?

Ricevi il nome visualizzato e l'handle così come li espone la rete, più un link all'elemento originale. I dati restano nel workspace a cui appartiene l'account.

Esiste un limite di richieste?

Sì, 100 richieste al minuto per chiave. Usa il conteggio dei non letti per il polling e recupera l'elenco completo solo quando cambia.

Sviluppa oggi con API commenti e inbox

Iniziare è gratis e l'API completa è inclusa. Crea una chiave e fai la tua prima chiamata in pochi minuti.

Ottieni la tua chiave API