Messaging-APIAPI

Direktnachrichten in jedem Netzwerk, aus Ihrem eigenen Code

FoPost hält jeden DM-Thread Ihrer verbundenen Konten an einem Ort. Listen Sie Konversationen auf, starten Sie neue, schreiben Sie ein ganzes Kontaktsegment auf einmal an oder verteilen Sie eine Nachrichtenreihe über mehrere Tage, alles mit demselben API-Schlüssel.

GET /v1/inbox/conversations
curl "https://api.fopost.com/v1/inbox/conversations?workspace_id=9b2f6c1e-..." \
  -H "X-API-Key: $API_KEY"

{
  "data": [
    {
      "workspace_id": "9b2f6c1e-...",
      "account_id": "4a71d80b-...",
      "conversation_id": "t_1029384756",
      "message_count": 6,
      "unread_count": 2,
      "last_message_at": "2026-11-10T16:42:08Z",
      "last_message_text": "Is the large size back in stock?",
      "last_message_outbound": false,
      "participant": { "name": "Jordan P.", "handle": "jordanp", "avatar_url": "https://..." },
      "account": { "id": "4a71d80b-...", "platform": "instagram", "username": "yourbrand" }
    }
  ],
  "meta": { "page": 1, "per_page": 25, "total": 1, "total_pages": 1 }
}

Eine Thread-Liste

Jede DM-Konversation aus jedem verbundenen Konto, die neueste zuerst.

Broadcasts

Eine Nachricht in die bestehenden Threads einer gefilterten Kontaktgruppe.

Sequenzen

Eine Reihe von Nachrichten, jede eine festgelegte Anzahl Stunden nach der vorherigen gesendet.

Konversationen

Einen Thread lesen, beantworten oder einen neuen eröffnen

Antworten Sie in einem bestehenden Thread mit POST /v1/inbox/:id/reply. Starten Sie eine neue Konversation per Handle auf X, Mastodon, Reddit und Slack, oder übergeben Sie comment_id, um einen Instagram- oder Facebook-Kommentar privat zu beantworten. Auf Facebook und Instagram können Sie außerdem eine Tippanzeige einblenden, und auf Messenger einen Thread an eine andere App übergeben und wieder zurücknehmen.

Konversationen-Referenz lesen
POST /v1/inbox/conversations
curl -X POST https://api.fopost.com/v1/inbox/conversations \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "4a71d80b-...",
    "handle": "jordanp",
    "text": "Thanks for the order. Your tracking link is on its way."
  }'

{ "conversation_id": "t_1029384756", "item": { "id": "2c9d4e81-...", "type": "dm", ... } }

Text und Medien

Bis zu 10 Medien-IDs aus Ihrer Bibliothek werden mitgesendet, wo das Netzwerk es erlaubt.

Tippen und Übergabe

POST /v1/inbox/conversations/:id/typing und /handover für Meta-Konversationen.

X Chat

Verschlüsselte X-Konversationen laufen als Geheimtext durch; der Schlüssel bleibt im Browser.

Broadcasts

Ein Segment anschreiben, ohne Plattformregeln zu verletzen

Ein Broadcast landet in den Konversationen, die Ihr Konto bereits mit einer Kontaktgruppe hat, gefiltert nach Netzwerk, Label, Quelle oder benutzerdefiniertem Feld. Facebook, Instagram und WhatsApp erlauben eine Geschäftsnachricht nur innerhalb von 24 Stunden nach der letzten Nachricht des Kontakts. Empfänger außerhalb dieses Fensters werden mit Begründung übersprungen und nie angeschrieben. Auf WhatsApp kann eine genehmigte Vorlage darüber hinausreichen.

Broadcasts-Referenz ansehen
POST /v1/broadcasts/:id/send
curl -X POST https://api.fopost.com/v1/broadcasts \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "9b2f6c1e-...",
    "account_id": "4a71d80b-...",
    "name": "Restock, November",
    "text": "The large size is back in stock this week.",
    "audience": { "platforms": ["instagram"], "label_ids": ["d41e7a90-..."] }
  }'

curl -X POST https://api.fopost.com/v1/broadcasts/8e2a5c13-.../send -H "X-API-Key: $API_KEY"

{ "id": "8e2a5c13-...", "status": "sending", "recipients": 212 }

Jetzt oder später senden

Setzen Sie scheduled_at, um ihn einzureihen, oder brechen Sie ihn vor dem Versand ab.

Ergebnis pro Empfänger

GET /v1/broadcasts/:id/recipients zeigt gesendet, übersprungen oder fehlgeschlagen, und warum.

Nur einmal gesendet

Jeder Empfänger wird vor dem Senden reserviert, sodass ein erneuter Versuch nie doppelt schreibt.

Sequenzen

Automatisch über Tage nachfassen

Eine Sequenz ist eine Liste von bis zu 20 Schritten, jeweils eine Nachricht mit einer Verzögerung in Stunden nach dem vorherigen Schritt. Tragen Sie Kontakte per ID oder mit demselben Zielgruppenfilter wie bei einem Broadcast ein und tragen Sie sie jederzeit wieder aus. Ein Schritt außerhalb des Nachrichtenfensters wird übersprungen, und die Sequenz läuft weiter.

Sequenzen-Referenz ansehen
POST /v1/sequences/:id/enroll
curl -X POST https://api.fopost.com/v1/sequences/5b9c2e40-.../enroll \
  -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "contact_ids": ["a7f3c2d1-..."] }'

{ "id": "5b9c2e40-...", "enrolled": 1 }

Jederzeit pausieren

Setzen Sie status auf paused, dann wird bis zur Fortsetzung kein weiterer Schritt gesendet.

Austragen

POST /v1/sequences/:id/unenroll stoppt einen Kontakt sofort.

Anzahl der Einträge

Aktiv, abgeschlossen, gestoppt und fehlgeschlagen, pro Sequenz.

Kontakte

Wissen, mit wem Sie sprechen

Personen, die Ihren Konten schreiben, werden automatisch zu Kontakten. Fügen Sie weitere von Hand hinzu oder importieren Sie eine CSV mit bis zu 5.000 Zeilen und einer Spalte für Plattform und Handle. Definieren Sie bis zu 50 benutzerdefinierte Felder pro Workspace (Text, Zahl, Datum, Auswahl oder Ja/Nein) und filtern Sie Broadcasts und Sequenzen danach.

Jetzt loslegen
Verbundene Konten aller Netzwerke in einem Workspace

CSV-Import

POST /v1/contacts/import gibt erstellte, zusammengeführte und übersprungene Zeilen mit Begründung zurück.

Benutzerdefinierte Felder

Spalten, die zu einem Feldschlüssel passen, werden beim Import befüllt.

Vollständiger Verlauf

GET /v1/contacts/:id/conversations listet auf, was jeder Kontakt geschrieben hat.

Fragen zu Messaging-API, beantwortet

Welche Netzwerke kann ich anschreiben?

Konversationen werden von Bluesky, Facebook, Instagram, Mastodon, Reddit, Slack, Telegram, WhatsApp und X gelesen, wenn das Konto die Messaging-Berechtigung erteilt hat. Eine neue Konversation per Handle zu starten funktioniert auf X, Mastodon, Reddit und Slack.

Was ist das Nachrichtenfenster?

Facebook, Instagram und WhatsApp nehmen eine Geschäftsnachricht nur innerhalb von 24 Stunden nach der letzten Nachricht des Kontakts an. Broadcasts und Sequenzen prüfen das vor jedem Versand und überspringen alle außerhalb des Fensters, wobei der Grund festgehalten wird.

Welche API-Schlüssel-Scopes benötige ich?

Zum Lesen von Konversationen, Kontakten, Broadcasts und Sequenzen genügt der Scope inbox. Alles, was eine Nachricht in einem Netzwerk platziert, etwa das Senden eines Broadcasts oder das Eintragen eines Kontakts, erfordert zusätzlich publish.

Kann ein Broadcast Personen anschreiben, die uns nie geschrieben haben?

Nein. Ein Broadcast landet in einer Konversation, die das Konto bereits mit dem Kontakt hat. Kontakte ohne Konversation werden als nie angeschrieben übersprungen.

Wird etwas ohne meine Anfrage gesendet?

Ein Broadcast wird gesendet, wenn Sie send aufrufen oder zum geplanten Zeitpunkt. Eine Sequenz sendet ihre Schritte, nachdem Sie jemanden eingetragen haben. Es wird nichts versendet, was Sie nicht eingerichtet haben.

Gibt es ein Rate-Limit?

Ja, 100 Anfragen pro Minute und Schlüssel. Auch die Netzwerke setzen eigene Limits, und ein abgelehnter Versand kommt mit der Begründung des Netzwerks zurück.

Baue noch heute auf Messaging-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 erhalten