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
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| customer | string | No | Filtro: el uuid de un customer del merchant. |
| customer_integration | string | No | Filtro: el uuid de una conexión de un customer del merchant. |
| status | string | No | Filtro: created, publishing, published o failed. |
| external_reference | string | No | Filtro: el id del post en tu sistema (hasta 100 caracteres). |
| per_page | integer | No | Elementos por página, de 1 a 100. Por defecto 15. |
| customer_uuid | string | No | En 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}.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
