API voor reacties en inboxAPI

Elke reactie en elk bericht, in één wachtrij waarop je kunt bouwen

FoPost haalt reacties en directe berichten van elk gekoppeld account op in één inbox. Bekijk ze, tel wat ongelezen is, markeer items als afgehandeld en antwoord, allemaal via dezelfde API die je dashboard gebruikt.

Haal je API-sleutel opLees de documentatie
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 }
}

Eén lijst

Reacties en berichten van elk account, nieuwste eerst, met dezelfde velden.

Aantal ongelezen

Eén aanroep voor het getal op de badge, per werkruimte of voor allemaal samen.

Antwoorden vanuit code

Beantwoord een reactie of bericht en het antwoord gaat terug naar het netwerk.

Lezen

Stuur binnenkomende gesprekken naar de juiste plek

Vraag de inbox periodiek of op aanvraag op, filter op type, account of status, en stuur elk item door naar je helpdesk, je chatkanaal of een collega. Elk item linkt terug naar de post waar het bij hoort, als die er is.

Inbox-documentatie lezen
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 }

Filteren

Op type, account, platform of leesstatus, met paginering.

Gekoppeld aan de post

Reacties bevatten de post waar ze bij horen, zodat je ze aan analyses kunt koppelen.

Inboxaccounts

GET /v1/inbox/accounts toont welke gekoppelde accounts de inbox vullen.

Antwoorden

Antwoord daar waar de klant het vroeg

POST een antwoord op een inboxitem en het wordt geplaatst als antwoord op een reactie of als direct bericht op het oorspronkelijke netwerk, vanaf het gekoppelde account. Markeer items met PATCH als read, resolved of snoozed, zodat twee systemen nooit hetzelfde item afhandelen.

Reply-endpoint bekijken
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" }'

Native antwoord

Antwoorden op reacties en DM's gaan via de eigen API van het netwerk.

Statusupdates

read, resolved of snoozed, zodat afgehandelde items uit de wachtrij verdwijnen.

Expliciet verzenden

Niets antwoordt vanzelf. Elk uitgaand bericht is een verzoek dat jij doet.

Synchronisatie

Actueel als het moet, stil als het niet hoeft

De inbox synchroniseert periodiek voor elk gekoppeld account. Heb je nu meteen het nieuwste nodig, roep dan het refresh-endpoint voor de werkruimte aan en lees opnieuw. Doordat alles per werkruimte is afgeschermd, ziet een bureausleutel alleen de gesprekken van de eigen klant.

Begin met bouwen
Gekoppelde accounts op elk netwerk in één werkruimte

Verversen op aanvraag

POST /v1/inbox/refresh haalt het nieuwste op voor elk account in de werkruimte.

Periodieke synchronisatie

Synchronisatie op de achtergrond houdt de lijst actueel zonder aanroep van jouw kant.

Geïsoleerd per werkruimte

De identiteit van de auteur en de berichttekst verlaten nooit de werkruimte waar ze bij horen.

Vragen over API voor reacties en inbox, beantwoord

Welke netwerken vullen de inbox?

Elk gekoppeld account op een netwerk dat reacties of berichten via zijn API beschikbaar stelt. GET /v1/inbox/accounts laat precies zien welke van je accounts zijn opgenomen.

Kan ik directe berichten beantwoorden?

Ja, waar het netwerk dat toestaat en het account toestemming voor berichten heeft gegeven. Staat een netwerk het niet toe, dan geeft het reply-endpoint een fout terug met de reden.

Hoe snel verschijnen nieuwe reacties?

Synchronisatie op de achtergrond draait periodiek per account. Roep het refresh-endpoint aan voordat je leest als je nu meteen de nieuwste items nodig hebt.

Kan de API automatisch antwoorden?

Nee. De API verstuurt nooit een antwoord zonder verzoek van jou. Bouw je automatische antwoorden, dan zit de beslissing om te verzenden in jouw code.

Krijg ik het profiel van de auteur?

Je krijgt de weergavenaam en handle zoals het netwerk die aanbiedt, plus een link naar het oorspronkelijke item. Gegevens blijven in de werkruimte waar het account bij hoort.

Is er een rate limit?

Ja, 100 verzoeken per minuut per sleutel. Gebruik het aantal ongelezen om te pollen en haal de volledige lijst alleen op als die verandert.

Bouw vandaag nog op de API voor reacties en inbox

Starten is gratis en de volledige API is inbegrepen. Maak een sleutel aan en doe binnen enkele minuten je eerste aanroep.

Haal je API-sleutel op