Hilos

Un hilo es un comentario raíz y sus respuestas. Su id es el id del comentario raíz en Meta.

Listar hilos

GET https://api.platica.mx/v1/posts/{postId}/threads

Parámetros de consulta

ParámetroTipoDescripciónRequerido
workspacestringID del workspace. Requerido si tu API key es multi-workspace—
limitintegerHilos por página, de 1 a 100. Por defecto: 25—
pageTokenstringnextPageToken de la respuesta anterior—
sortBystringrootCreatedAt (por defecto, fecha del comentario raíz) o lastCommentAt—
sortDirectionstringdesc (por defecto) o asc. asc solo con rootCreatedAt y sin status—
statusstringopen o resolved—
needsReplybooleantrue: el último comentario es de la persona y nadie ha contestado—
operationstringautomatic, supervised o assistance. Solo hilos con valor propio; los que heredan de la publicación no entran—
ownerstringEmail del responsable—

Respuesta

{
  "workspaceId": "ws_001",
  "postId": "conv_post_001",
  "threads": [
    {
      "id": "17890000000000001",
      "postId": "conv_post_001",
      "status": "open",
      "needsReply": true,
      "commentCount": 2,
      "topic": "Tallas",
      "tags": ["Interés de compra"],
      "operation": null,
      "effectiveOperation": "automatic",
      "owners": [],
      "clientId": "cli_123",
      "authorName": "Ana",
      "authorPhotoUrl": null,
      "authorType": null,
      "authorRole": "user",
      "root": { "text": "¿Tienen talla M?", "isSpam": false, "moderationAction": "none" },
      "replyState": null,
      "resolvedAt": null,
      "resolvedReason": null,
      "privateReplies": {},
      "rootCreatedAt": "2026-10-21T18:20:00.000Z",
      "lastCommentAt": "2026-10-21T18:22:00.000Z"
    }
  ],
  "nextPageToken": null
}
CampoDescripción
statusopen o resolved. Un comentario nuevo de la persona reabre el hilo
needsReplyEl último comentario es de la persona y nadie ha contestado
operationValor propio del hilo. null = hereda de la publicación
effectiveOperationLo que aplica: automatic, supervised o assistance
ownersEmails de los responsables
rootTexto y moderación del comentario raíz
replyStateprocessing mientras el agente contesta; failed si no pudo
resolvedReasonPor qué se resolvió sin respuesta (por ejemplo spam), o null
privateRepliesPor commentId, la respuesta privada que se mandó: status, sentAt, conversationId del DM

Obtener un hilo

Devuelve el hilo con sus comentarios en orden (hasta 500). Cada comentario tiene la forma de comment en el payload de comment.created .

GET https://api.platica.mx/v1/posts/{postId}/threads/{threadId}
{
  "thread": {
    "id": "17890000000000001",
    "status": "open",
    "needsReply": true,
    "comments": [
      {
        "id": "17890000000000001",
        "postId": "17912345678901234",
        "parentCommentId": null,
        "rootCommentId": "17890000000000001",
        "platform": "instagram",
        "channelId": "igc-17841400000000000",
        "content": "¿Tienen talla M?",
        "contentType": "text",
        "attachments": [],
        "direction": "incoming",
        "role": "user",
        "clientId": "cli_123",
        "authorName": "Ana",
        "isSpam": false,
        "moderation": { "action": "none", "synced": false, "moderatedAt": null },
        "creationDate": "2026-10-21T18:20:00.000Z"
      }
    ],
    "commentsTruncated": false
  }
}

Actualizar un hilo

PATCH https://api.platica.mx/v1/posts/{postId}/threads/{threadId}

Cuerpo de la solicitud

Envía al menos un campo.

CampoTipoDescripción
statusstringresolved lo marca resuelto; open lo reabre
operationstring | nullsupervised pausa al agente solo en este hilo; automatic lo reanuda; null vuelve a heredar de la publicación. En un hilo en assistance, supervised acepta la asistencia
ownersarrayEmails de los responsables (máximo 25). Reemplaza la lista
{
  "status": "resolved"
}

Responde { "thread": { … } } ya actualizado, con sus comentarios.