Kommentare- und Inbox-APIAPI

Jeder Kommentar und jede Nachricht in einer Warteschlange, gegen die du programmieren kannst

FoPost holt Kommentare und Direktnachrichten von jedem verbundenen Konto in eine Inbox. Liste sie auf, zähle Ungelesenes, markiere Einträge als erledigt und antworte, alles über dieselbe API, die dein Dashboard nutzt.

API-Schlüssel holen Doku lesen

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

Eine Liste

Kommentare und Nachrichten aller Konten, neueste zuerst, mit denselben Feldern.

Ungelesen-Zähler

Ein einziger Aufruf für die Badge-Zahl, pro Workspace oder über alle hinweg.

Per Code antworten

Beantworte einen Kommentar oder eine Nachricht, und die Antwort geht zurück ans Netzwerk.

Lesen

Leite eingehende Unterhaltungen an die richtige Stelle

Frage die Inbox regelmäßig oder bei Bedarf ab, filtere nach Typ, Konto oder Status und leite jeden Eintrag an deinen Helpdesk, deinen Chat-Kanal oder einen Menschen weiter. Jeder Eintrag verlinkt auf den zugehörigen Beitrag, falls es einen gibt.

Inbox-Referenz lesen

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 }

Filtern

Nach Typ, Konto, Plattform oder Lesestatus, mit seitenweiser Paginierung.

Mit dem Beitrag verknüpft

Kommentare enthalten den zugehörigen Beitrag, sodass du sie mit Analysen verknüpfen kannst.

Inbox-Konten

GET /v1/inbox/accounts listet auf, welche verbundenen Konten die Inbox speisen.

Antworten

Antworte dort, wo der Kunde gefragt hat

Sende per POST eine Antwort auf einen Inbox-Eintrag, und sie erscheint als Kommentarantwort oder Direktnachricht im Ursprungsnetzwerk, vom verbundenen Konto aus. Markiere Einträge per PATCH als read, resolved oder snoozed, damit nie zwei Systeme denselben bearbeiten.

Reply-Endpunkt ansehen

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 Antwort

Kommentarantworten und DMs gehen über die eigene API des Netzwerks raus.

Statusänderungen

read, resolved oder snoozed, damit erledigte Einträge aus der Warteschlange fallen.

Ausdrückliches Senden

Nichts antwortet von selbst. Jede ausgehende Nachricht ist eine Anfrage von dir.

Sync

Aktuell, wenn du es brauchst, still, wenn nicht

Die Inbox wird für jedes verbundene Konto regelmäßig synchronisiert. Wenn du sofort den neuesten Stand brauchst, rufe den Refresh-Endpunkt für den Workspace auf und lies erneut. Durch die Begrenzung auf Workspaces sieht ein Agenturschlüssel immer nur die Unterhaltungen des eigenen Kunden.

Jetzt bauen

Verbundene Konten aller Netzwerke in einem Workspace

Aktualisierung auf Abruf

POST /v1/inbox/refresh holt den neuesten Stand für jedes Konto im Workspace.

Geplanter Sync

Der Sync im Hintergrund hält die Liste aktuell, ganz ohne Aufruf von dir.

Workspace-isoliert

Autorenidentität und Nachrichtentext verlassen nie den Workspace, zu dem sie gehören.

Fragen zu Kommentare- und Inbox-API, beantwortet

Welche Netzwerke speisen die Inbox?

Jedes verbundene Konto in einem Netzwerk, das Kommentare oder Nachrichten über seine API bereitstellt. GET /v1/inbox/accounts zeigt dir genau, welche deiner Konten enthalten sind.

Kann ich auf Direktnachrichten antworten?

Ja, sofern das Netzwerk es erlaubt und das Konto die Berechtigung für Nachrichten erteilt hat. Der Reply-Endpunkt liefert einen Fehler mit dem Grund, wenn ein Netzwerk es nicht zulässt.

Wie schnell erscheinen neue Kommentare?

Der Sync im Hintergrund läuft regelmäßig pro Konto. Rufe vor dem Lesen den Refresh-Endpunkt auf, wenn du sofort die neuesten Einträge brauchst.

Kann die API automatisch antworten?

Nein. Die API sendet nie eine Antwort ohne eine Anfrage von dir. Wenn du automatische Antworten baust, liegt die Entscheidung zum Senden in deinem Code.

Bekomme ich das Profil des Autors?

Du bekommst Anzeigenamen und Handle, wie das Netzwerk sie bereitstellt, plus einen Link zum ursprünglichen Eintrag. Die Daten bleiben in dem Workspace, zu dem das Konto gehört.

Gibt es ein Rate Limit?

Ja, 100 Anfragen pro Minute und Schlüssel. Nutze für das Polling den Ungelesen-Zähler und hole die vollständige Liste nur, wenn er sich ändert.

Baue noch heute auf Kommentare- und Inbox-API

Der Start ist kostenlos und die vollständige API inklusive. Erstelle einen Schlüssel und mach in wenigen Minuten deinen ersten Aufruf.

API-Schlüssel holen