REST APIGET

Resumen de la bandeja

Consulta los comentarios, menciones, mensajes y reseñas sin leer de tus cuentas, qué canales de la bandeja puede usar cada cuenta, y pide una lectura nueva.

La bandeja reúne cuatro canales de las cuentas conectadas: comentarios en tus publicaciones, menciones de tus cuentas en publicaciones de otras personas, mensajes directos y reseñas de Google Business Profile. TikTok y X no tienen bandeja.

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

Devuelve el número de no leídos de cada canal y, por cada cuenta conectada, qué canales puede usar y cuándo se leyó por última vez.

Clave API (token Bearer)

Permiso:inbox.readRoles y permisos

Todos los roles tienen inbox.read, así que cualquier clave válida puede leer la bandeja.

Unos 10 minutos, no en tiempo real

AdaptlyPost lee cada cuenta conectada cada 10 minutos y guarda lo que encuentra. Las listas responden desde esa copia, así que un comentario, mención, mensaje o reseña nuevo aparece en unos 10 minutos. POST /api/v1/inbox/refresh pide una lectura ahora. Los eventos de webhook salen de las mismas lecturas.

Canales que necesitan una reconexión

Todos los canales están abiertos a la API. Cuando a una conexión le falta el permiso de la plataforma para un canal o una acción, incluidos los permisos que la plataforma aún está revisando para AdaptlyPost, GET /api/v1/inbox/summary muestra el canal como RECONNECT_REQUIRED y toda escritura en él responde 403 inbox_reconnect_required. Un token caducado responde lo mismo. Pide al usuario que reconecte la cuenta en AdaptlyPost; reintentar no sirve.

Plataformas compatibles

Qué canales tiene cada plataforma. Una cuenta solo recibe un canal para el que su conexión tiene permiso; el resumen te lo dice por cuenta.

Plataforma	Comentarios	Menciones	Mensajes	Reseñas
`FACEBOOK`	Sí	Sí	Sí	No
`INSTAGRAM`	Sí	Solo lectura, para cuentas conectadas a través de Facebook	Sí	No
`THREADS`	Sí	Sí	No	No
`YOUTUBE`	Sí	No	No	No
`LINKEDIN`	Solo páginas de organización	No	No	No
`BLUESKY`	Sí	Sí	Sí	No
`MASTODON`	Sí	Sí	Sí	No
`GOOGLE_BUSINESS`	No	No	No	Sí

Campos del resumen

Campo	Descripción
`unread`	Elementos UNREAD por canal: comments, mentions, conversations y reviews
`accounts[].accountId`	El id de la cuenta de GET /social-accounts, con su platform, accountName y avatarUrl
`accounts[].needsReconnect`	True cuando hay que reconectar la cuenta antes de poder leer sus comentarios
`accounts[].lastSyncedAt`	Cuándo leyó AdaptlyPost la cuenta por última vez, o null antes de la primera lectura
`accounts[].lastErrorCode`	Por qué falló la última lectura, o null
`accounts[].comments`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED para ese canal. Mira abajo
`accounts[].mentions`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED para ese canal. Mira abajo
`accounts[].messages`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED para ese canal. Mira abajo
`accounts[].reviews`	AVAILABLE, RECONNECT_REQUIRED o UNSUPPORTED para ese canal. Mira abajo

Acceso a los canales

Valor	Descripción
`AVAILABLE`	La cuenta puede usar este canal
`RECONNECT_REQUIRED`	La plataforma tiene el canal, pero a esta conexión le falta el permiso, o su token caducó. Las escrituras responden 403 inbox_reconnect_required hasta que el usuario reconecte la cuenta en AdaptlyPost
`UNSUPPORTED`	La plataforma no tiene ese canal

Leer las cuentas ahora

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

Pone en cola una lectura de todas las cuentas conectadas en lugar de esperar a la siguiente ronda de 10 minutos, y responde 202 { "queued": true }. Las listas cambian cuando termina la lectura.

Clave API (token Bearer)

Permiso:inbox.readRoles y permisos

Rechazos

Una llamada rechazada responde { statusCode, error, code, message }. Decide según code. message explica el rechazo con palabras.

Código	Estado	Cuándo, y qué hacer
`inbox_item_not_found`	404	El id no existe o pertenece a otro espacio de trabajo. Detente
`inbox_action_unsupported`	400	La plataforma, o este elemento, no permite ocultar, eliminar o dar me gusta. capabilities dice qué se aplica. Detente
`inbox_reconnect_required`	403	A la conexión le falta el permiso para este canal o acción, incluido uno aún en revisión de la plataforma, o su token caducó. Pide al usuario que reconecte la cuenta en AdaptlyPost. No reintentes
`inbox_reply_invalid`	400	El texto está vacío o supera el límite. El mensaje indica el límite. Corrige el texto
`inbox_messaging_window_closed`	400	Facebook o Instagram: pasó la ventana de respuesta de 24 horas. Detente
`inbox_rate_limited`	429	La plataforma limitó la frecuencia de AdaptlyPost. Reintenta pasado un rato
`inbox_platform_error`	503	La plataforma falló. Reintenta más tarde
`permission_denied`	403	Al rol de la clave le falta inbox.read o inbox.reply. No reintentes
`subscription_required`	403	Una escritura sin un plan de AdaptlyPost activo. No reintentes

Leer el resumen de la bandeja

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

Pedir una lectura ahora

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