Posts

Listar posts de todos los clientes con la API

GET /merchants/posts devuelve los posts de todos tus clientes a la vez, los más recientes primero, usando solo el token del merchant. Es la vista de monitoreo: dónde hay posts con fallo, qué se publicó y para qué cliente.

La llamada

GET /api/merchants/posts?status=failed&per_page=50
Authorization: Bearer <merchant token>

Qué puedes hacer

  • Listar los posts de todos los customers en una llamada, sin x-customer-token.
  • Filtrar por un customer con customer, o por una conexión con customer_integration.
  • Filtrar por status (created, publishing, published, failed) para encontrar fallos.
  • Encontrar un post por el id de tu sistema con external_reference.
  • Paginar con per_page, de 1 a 100.

Reglas y límites

  • Solo el Bearer del merchant, sin x-customer-token. Para los posts de un solo cliente, usa GET /posts con el x-customer-token.
  • customer y customer_integration son filtros, no credencial: el cliente y la conexión se verifican contra el merchant del Bearer.
  • Los filtros se combinan. La lista viene con los más recientes primero, 15 por página por defecto.
  • Cada post trae customer_uuid, para que sepas de qué cliente es.

Campos principales

CampoTipoObligatorioDescripción
customerstringNoFiltro: el uuid de un customer del merchant.
customer_integrationstringNoFiltro: el uuid de una conexión de un customer del merchant.
statusstringNoFiltro: created, publishing, published o failed.
external_referencestringNoFiltro: el id del post en tu sistema (hasta 100 caracteres).
per_pageintegerNoElementos por página, de 1 a 100. Por defecto 15.
customer_uuidstringNoEn cada post de la respuesta: el customer dueño del post.

Para quién

  • Panel de operaciones

    El equipo de soporte ve todos los posts con fallo de todos los clientes en una pantalla, sin consultar cliente por cliente.

  • Alertas de fallo

    Un job periódico lista status failed y avisa al responsable de cada cuenta.

  • Agente de IA de monitoreo

    El agente resume la semana de publicaciones por cliente y destaca los que más fallaron.

Funciona con

  • Instagram Business
  • Facebook
  • Threads
  • LinkedIn
  • Pinterest
  • YouTube

Preguntas frecuentes

¿Necesito el x-customer-token?

No. Esta ruta usa solo el Bearer del merchant. GET /posts, por cliente, exige el x-customer-token.

¿Cómo veo solo un cliente?

Pasa customer con el uuid del customer, o customer_integration con el uuid de la conexión.

¿Cómo encuentro los posts con fallo?

Filtra por status=failed. Para los detalles del error, consulta el post con GET /posts/{uuid}.

Relacionadas

Ver todo lo que puedes hacer con Posts

Mira Connect aplicado a tu producto.

Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.