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ámetro | Tipo | Descripción | Requerido |
|---|---|---|---|
workspace | string | ID del workspace. Requerido si tu API key es multi-workspace | — |
limit | integer | Hilos por página, de 1 a 100. Por defecto: 25 | — |
pageToken | string | nextPageToken de la respuesta anterior | — |
sortBy | string | rootCreatedAt (por defecto, fecha del comentario raíz) o lastCommentAt | — |
sortDirection | string | desc (por defecto) o asc. asc solo con rootCreatedAt y sin status | — |
status | string | open o resolved | — |
needsReply | boolean | true: el último comentario es de la persona y nadie ha contestado | — |
operation | string | automatic, supervised o assistance. Solo hilos con valor propio; los que heredan de la publicación no entran | — |
owner | string | Email del responsable | — |
Nota
Usa un solo filtro a la vez entre status, needsReply, operation y owner. Para combinarlos,
filtra uno en la consulta y el resto en tu código.
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
} | Campo | Descripción |
|---|---|
status | open o resolved. Un comentario nuevo de la persona reabre el hilo |
needsReply | El último comentario es de la persona y nadie ha contestado |
operation | Valor propio del hilo. null = hereda de la publicación |
effectiveOperation | Lo que aplica: automatic, supervised o assistance |
owners | Emails de los responsables |
root | Texto y moderación del comentario raíz |
replyState | processing mientras el agente contesta; failed si no pudo |
resolvedReason | Por qué se resolvió sin respuesta (por ejemplo spam), o null |
privateReplies | Por 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.
| Campo | Tipo | Descripción |
|---|---|---|
status | string | resolved lo marca resuelto; open lo reabre |
operation | string | null | supervised 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 |
owners | array | Emails de los responsables (máximo 25). Reemplaza la lista |
{
"status": "resolved"
} Responde { "thread": { … } } ya actualizado, con sus comentarios.