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ámetroTipoDescripciónRequerido
workspacestringID del workspace. Requerido si tu API key es multi-workspace—
limitintegerPublicaciones por página, de 1 a 100. Por defecto: 25—
pageTokenstringnextPageToken de la respuesta anterior—
channelIdstringCanal de comentarios (igc-… o fbc-…). No se combina con platform—
platformstringinstagram o facebook—
startDatestringActividad desde esta fecha (ISO 8601)—
endDatestringActividad hasta esta fecha (ISO 8601)—
sortDirectionstringdesc (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
}
CampoDescripción
idID de la publicación en Platica. Úsalo como postId
externalIdID del post en Meta
platforminstagram o facebook
channelIdCanal de comentarios de la cuenta
titleTexto del post
operationControl del agente: automatic (contesta) o supervised (no contesta)
pausedtrue cuando una persona pausó al agente en esta publicación
agentIdAgente propio de la publicación. null = contesta el agente del canal
openThreadsCountHilos que esperan respuesta
assistanceThreadsCountHilos en los que el agente pidió ayuda
unreadCommentsCountComentarios sin leer en la bandeja
statsReacciones, comentarios y compartidos según Meta
lastCommentEl 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.

CampoTipoDescripción
operationstringsupervised pausa al agente; automatic lo reanuda
agentIdstring | nullAgente que contesta en esta publicación. null vuelve al agente del canal
{
  "operation": "supervised"
}

Responde { "post": { … } } ya actualizada.