REST APIGET

Résumé de la boîte de réception

Consultez les commentaires, mentions, messages et avis non lus de vos comptes, les canaux que chaque compte peut utiliser, et demandez une nouvelle lecture.

La boîte de réception réunit quatre canaux des comptes connectés : les commentaires sur vos publications, les mentions de vos comptes dans les publications d'autres personnes, les messages privés et les avis Google Business Profile. TikTok et X n'ont pas de boîte de réception.

GEThttps://post.adaptlypost.com/post/api/v1/inbox/summary

Renvoie le nombre d'éléments non lus de chaque canal et, pour chaque compte connecté, les canaux qu'il peut utiliser et la date de sa dernière lecture.

Clé API (jeton Bearer)

Permission:inbox.readRôles et permissions

Tous les rôles détiennent inbox.read, donc toute clé valide peut lire la boîte de réception.

Environ 10 minutes, pas en temps réel

AdaptlyPost lit chaque compte connecté toutes les 10 minutes et garde ce qu'il trouve. Les listes répondent à partir de cette copie, donc un nouveau commentaire, une mention, un message ou un avis apparaît en environ 10 minutes. POST /api/v1/inbox/refresh demande une lecture immédiate. Les événements de webhook viennent des mêmes lectures.

Canaux qui demandent une reconnexion

Tous les canaux sont ouverts à l'API. Quand une connexion n'a pas la permission de la plateforme pour un canal ou une action, y compris les permissions que la plateforme examine encore pour AdaptlyPost, GET /api/v1/inbox/summary affiche le canal en RECONNECT_REQUIRED et chaque écriture sur ce canal répond 403 inbox_reconnect_required. Un jeton expiré répond de la même façon. Demandez à l'utilisateur de reconnecter le compte dans AdaptlyPost ; réessayer ne sert à rien.

Plateformes prises en charge

Les canaux de chaque plateforme. Un compte n'obtient un canal que si sa connexion en a la permission ; le résumé vous l'indique pour chaque compte.

Plateforme	Commentaires	Mentions	Messages	Avis
`FACEBOOK`	Oui	Oui	Oui	Non
`INSTAGRAM`	Oui	Lecture seule, pour les comptes connectés via Facebook	Oui	Non
`THREADS`	Oui	Oui	Non	Non
`YOUTUBE`	Oui	Non	Non	Non
`LINKEDIN`	Pages d'organisation uniquement	Non	Non	Non
`BLUESKY`	Oui	Oui	Oui	Non
`MASTODON`	Oui	Oui	Oui	Non
`GOOGLE_BUSINESS`	Non	Non	Non	Oui

Champs du résumé

Champ	Description
`unread`	Éléments UNREAD par canal : comments, mentions, conversations et reviews
`accounts[].accountId`	L'id du compte de GET /social-accounts, avec sa platform, son accountName et son avatarUrl
`accounts[].needsReconnect`	true quand le compte doit être reconnecté avant que ses commentaires puissent être lus
`accounts[].lastSyncedAt`	Date de la dernière lecture du compte par AdaptlyPost, ou null avant la première lecture
`accounts[].lastErrorCode`	La raison de l'échec de la dernière lecture, ou null
`accounts[].comments`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED pour ce canal. Voir ci-dessous
`accounts[].mentions`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED pour ce canal. Voir ci-dessous
`accounts[].messages`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED pour ce canal. Voir ci-dessous
`accounts[].reviews`	AVAILABLE, RECONNECT_REQUIRED ou UNSUPPORTED pour ce canal. Voir ci-dessous

Accès aux canaux

Valeur	Description
`AVAILABLE`	Le compte peut utiliser ce canal
`RECONNECT_REQUIRED`	La plateforme a ce canal, mais cette connexion n'en a pas la permission, ou son jeton a expiré. Les écritures répondent 403 inbox_reconnect_required jusqu'à ce que l'utilisateur reconnecte le compte dans AdaptlyPost
`UNSUPPORTED`	La plateforme n'a pas ce canal

Lire les comptes maintenant

POSThttps://post.adaptlypost.com/post/api/v1/inbox/refresh

Met en file une lecture de tous les comptes connectés au lieu d'attendre le prochain passage de 10 minutes, et répond 202 { "queued": true }. Les listes changent une fois la lecture terminée.

Clé API (jeton Bearer)

Permission:inbox.readRôles et permissions

Refus

Un appel refusé répond { statusCode, error, code, message }. Basez-vous sur code. message explique le refus en clair.

Code	Statut	Quand, et que faire
`inbox_item_not_found`	404	L'id n'existe pas ou appartient à un autre espace de travail. Arrêtez
`inbox_action_unsupported`	400	La plateforme, ou cet élément, ne permet pas ce masquage, cette suppression ou ce j'aime. capabilities indique ce qui s'applique. Arrêtez
`inbox_reconnect_required`	403	La connexion n'a pas la permission pour ce canal ou cette action, y compris une permission encore en examen par la plateforme, ou son jeton a expiré. Demandez à l'utilisateur de reconnecter le compte dans AdaptlyPost. Ne réessayez pas
`inbox_reply_invalid`	400	Le texte est vide ou dépasse la limite. Le message indique la limite. Corrigez le texte
`inbox_messaging_window_closed`	400	Facebook ou Instagram : la fenêtre de réponse de 24 heures est passée. Arrêtez
`inbox_rate_limited`	429	La plateforme a limité le débit d'AdaptlyPost. Réessayez plus tard
`inbox_platform_error`	503	La plateforme a échoué. Réessayez plus tard
`permission_denied`	403	Le rôle de la clé n'a pas inbox.read ou inbox.reply. Ne réessayez pas
`subscription_required`	403	Une écriture sans abonnement AdaptlyPost actif. Ne réessayez pas

Lire le résumé de la boîte de réception

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/inbox/summary \
  --header 'Authorization: Bearer <api-key>'

Demander une lecture immédiate

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/refresh \
  --header 'Authorization: Bearer <api-key>'

202
{ "queued": true }

200

{
  "unread": {
    "comments": 12,
    "mentions": 3,
    "conversations": 2,
    "reviews": 1
  },
  "accounts": [
    {
      "accountId": "conn_ig_001",
      "platform": "INSTAGRAM",
      "accountName": "adaptlypost",
      "avatarUrl": "https://cdn.adaptlypost.com/avatars/ig_001.jpg",
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:40:12.000Z",
      "lastErrorCode": null,
      "comments": "AVAILABLE",
      "mentions": "AVAILABLE",
      "messages": "RECONNECT_REQUIRED",
      "reviews": "UNSUPPORTED"
    },
    {
      "accountId": "conn_gbp_001",
      "platform": "GOOGLE_BUSINESS",
      "accountName": "AdaptlyPost Kraków",
      "avatarUrl": null,
      "needsReconnect": false,
      "lastSyncedAt": "2026-11-08T09:38:55.000Z",
      "lastErrorCode": null,
      "comments": "UNSUPPORTED",
      "mentions": "UNSUPPORTED",
      "messages": "UNSUPPORTED",
      "reviews": "AVAILABLE"
    }
  ]
}