API des commentaires et de la boîte de réceptionAPI

Chaque commentaire et message, dans une seule file programmable

FoPost rassemble les commentaires et messages directs de chaque compte connecté dans une seule boîte de réception. Listez-les, comptez les non-lus, marquez-les comme traités et répondez, le tout via la même API que votre tableau de bord.

Obtenir votre clé APILire la documentation
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 }
}

Une seule liste

Les commentaires et messages de tous les comptes, du plus récent au plus ancien, avec les mêmes champs.

Compteur de non-lus

Un seul appel pour le chiffre du badge, par espace de travail ou pour tous à la fois.

Répondez depuis votre code

Répondez à un commentaire ou à un message, et la réponse repart sur le réseau.

Lecture

Dirigez les conversations entrantes au bon endroit

Interrogez la boîte de réception à intervalles réguliers ou à la demande, filtrez par type, compte ou statut, et transférez chaque élément vers votre helpdesk, votre canal de discussion ou une personne. Chaque élément renvoie à la publication dont il dépend, le cas échéant.

Lire la référence de la boîte de réception
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 }

Filtrer

Par type, compte, plateforme ou état de lecture, avec pagination.

Lié à la publication

Les commentaires indiquent leur publication, pour les croiser avec les statistiques.

Comptes de la boîte de réception

GET /v1/inbox/accounts liste les comptes connectés qui alimentent la boîte de réception.

Réponse

Répondez là où le client a posé sa question

Envoyez une réponse à un élément de la boîte de réception en POST : elle est publiée comme réponse au commentaire ou message direct sur le réseau d'origine, depuis le compte connecté. Marquez les éléments comme lus, résolus ou reportés avec PATCH pour que deux systèmes ne traitent jamais le même.

Voir l'endpoint de réponse
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" }'

Réponse native

Les réponses aux commentaires et les DM passent par l'API du réseau lui-même.

Mises à jour de statut

read, resolved ou snoozed : les éléments traités sortent de la file.

Envois explicites

Rien ne répond tout seul. Chaque message sortant est une requête que vous effectuez.

Synchronisation

À jour quand il le faut, discret le reste du temps

La boîte de réception se synchronise à intervalles réguliers pour chaque compte connecté. Si vous avez besoin des dernières données tout de suite, appelez l'endpoint d'actualisation de l'espace de travail et relisez. Grâce au cloisonnement par espace de travail, une clé d'agence ne voit jamais que les conversations de son propre client.

Commencer à développer
Comptes connectés sur tous les réseaux dans un seul espace de travail

Actualisation à la demande

POST /v1/inbox/refresh récupère les dernières données de tous les comptes de l'espace de travail.

Synchronisation planifiée

La synchronisation en arrière-plan tient la liste à jour sans aucun appel de votre part.

Isolé par espace de travail

L'identité des auteurs et le texte des messages ne quittent jamais leur espace de travail.

API des commentaires et de la boîte de réception : vos questions, nos réponses

Quels réseaux alimentent la boîte de réception ?

Tout compte connecté sur un réseau qui expose les commentaires ou les messages via son API. GET /v1/inbox/accounts vous indique précisément quels comptes sont inclus.

Puis-je répondre aux messages directs ?

Oui, lorsque le réseau l'autorise et que le compte a accordé l'autorisation de messagerie. L'endpoint de réponse renvoie une erreur indiquant la raison lorsqu'un réseau ne le permet pas.

À quelle vitesse les nouveaux commentaires apparaissent-ils ?

La synchronisation en arrière-plan s'exécute à intervalles réguliers pour chaque compte. Appelez l'endpoint d'actualisation avant de lire si vous avez besoin des éléments les plus récents tout de suite.

L'API peut-elle répondre automatiquement ?

Non. L'API n'envoie jamais de réponse sans une requête de votre part. Si vous créez des réponses automatiques, la décision d'envoyer se trouve dans votre code.

Ai-je accès au profil de l'auteur ?

Vous obtenez le nom affiché et l'identifiant tels que le réseau les expose, ainsi qu'un lien vers l'élément d'origine. Les données restent dans l'espace de travail auquel appartient le compte.

Y a-t-il une limite de débit ?

Oui, 100 requêtes par minute et par clé. Utilisez le compteur de non-lus pour interroger l'API et ne récupérez la liste complète que lorsqu'il change.

Développez avec API des commentaires et de la boîte de réception dès aujourd'hui

Le démarrage est gratuit et l'API complète est incluse. Créez une clé et faites votre premier appel en quelques minutes.

Obtenir votre clé API