Publicaciones
Listar publicaciones
Devuelve las publicaciones con comentarios del workspace, desde la que tuvo actividad más reciente hasta la más antigua.
GET https://api.platica.mx/v1/posts Parámetros de consulta
| Parámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
workspace | string | ID del workspace. Requerido si tu API key es multi-workspace | — |
limit | integer | Publicaciones por página, de 1 a 100. Por defecto: 25 | — |
pageToken | string | nextPageToken de la respuesta anterior | — |
channelId | string | Canal de comentarios (igc-… o fbc-…). No se combina con platform | — |
platform | string | instagram o facebook | — |
startDate | string | Actividad desde esta fecha (ISO 8601) | — |
endDate | string | Actividad hasta esta fecha (ISO 8601) | — |
sortDirection | string | desc (por defecto) o asc, por última actividad | — |
Respuesta
{
"workspaceId": "ws_001",
"posts": [
{
"id": "conv_post_001",
"externalId": "17912345678901234",
"platform": "instagram",
"channelId": "igc-17841400000000000",
"title": "Nueva colección de otoño 🍂",
"permalink": "https://www.instagram.com/p/Cxyz/",
"contactName": "Mi Marca",
"media": {
"type": "IMAGE",
"productType": "FEED",
"url": "https://scontent.cdninstagram.com/…",
"thumbnailUrl": null
},
"publishedAt": "2026-10-20T15:00:00.000Z",
"operation": "automatic",
"paused": false,
"agentId": null,
"status": "active",
"topic": "Precios",
"tags": [],
"owners": [],
"openThreadsCount": 3,
"assistanceThreadsCount": 1,
"unreadCommentsCount": 5,
"participantsCount": 12,
"stats": { "reactions": 240, "comments": 31, "shares": 4 },
"lastComment": {
"commentId": "17890000000000001",
"text": "¿Tienen talla M?",
"authorName": "Ana",
"role": "user",
"at": "2026-10-21T18:22:00.000Z"
},
"creationDate": "2026-10-20T15:05:00.000Z",
"lastUpdate": "2026-10-21T18:22:00.000Z"
}
],
"nextPageToken": null
} | Campo | Descripción |
|---|---|
id | ID de la publicación en Platica. Úsalo como postId |
externalId | ID del post en Meta |
platform | instagram o facebook |
channelId | Canal de comentarios de la cuenta |
title | Texto del post |
operation | Control del agente: automatic (contesta) o supervised (no contesta) |
paused | true cuando una persona pausó al agente en esta publicación |
agentId | Agente propio de la publicación. null = contesta el agente del canal |
openThreadsCount | Hilos que esperan respuesta |
assistanceThreadsCount | Hilos en los que el agente pidió ayuda |
unreadCommentsCount | Comentarios sin leer en la bandeja |
stats | Reacciones, comentarios y compartidos según Meta |
lastComment | El comentario más reciente |
Obtener una publicación
GET https://api.platica.mx/v1/posts/{postId} Responde { "post": { … } } con la misma forma del listado, o 404 si el id no es de una
publicación.
Actualizar una publicación
Pausa o reanuda al agente en toda la publicación, o le asigna un agente distinto al del canal.
PATCH https://api.platica.mx/v1/posts/{postId} Cuerpo de la solicitud
Envía al menos uno de los dos campos.
| Campo | Tipo | Descripción |
|---|---|---|
operation | string | supervised pausa al agente; automatic lo reanuda |
agentId | string | null | Agente que contesta en esta publicación. null vuelve al agente del canal |
{
"operation": "supervised"
} Responde { "post": { … } } ya actualizada.
Nota
Reanudar solo aplica a comentarios nuevos. Lo que llegó mientras el agente estaba pausado queda sin
contestar hasta que lo mandes a responder con send-to-agent .