Responder comentarios
Todo lo que publica la marca es público e inmediato en Meta. Usa Idempotency-Key en estas llamadas
(ver Reintentos seguros ).
Publicar un comentario
Un comentario nuevo de la marca en la publicación, que no responde a nadie.
POST https://api.platica.mx/v1/posts/{postId}/comments Cuerpo de la solicitud
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
message | string | Texto. Hasta 2,200 caracteres en Instagram y 8,000 en Facebook | ✓ si no hay imagen |
attachmentUrl | string | Solo Facebook: imagen JPG, PNG o GIF por https, hasta 10 MB | — |
{
"message": "¡Gracias por todos sus comentarios! Les respondemos por aquí 👇"
} Respuesta
201 Created
{
"commentId": "17890000000000099",
"clientToken": "6f1c7a9e-3b4d-4f8a-9c2e-1a5b7d9e0f12",
"mode": "root",
"parentCommentId": null,
"commentPersistencePending": false
} El comentario aparece en el hilo y en los webhooks comment.created cuando Meta lo confirma, en
segundos.
Responder en público
POST https://api.platica.mx/v1/posts/{postId}/threads/{threadId}/replies Cuerpo de la solicitud
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
message | string | Texto de la respuesta | ✓ |
parentCommentId | string | Comentario del hilo al que respondes. Por defecto, el comentario raíz | — |
{
"message": "¡Hola Ana! Sí, tenemos talla M en todos los colores."
} 201 Created con commentId, mode: "reply" y el estado del hilo, que queda resuelto.
Un hilo en asistencia no acepta respuestas hasta que alguien la acepta: manda PATCH /v1/posts/{postId}/threads/{threadId} con "operation": "supervised".
Responder por privado
Manda un mensaje directo a quien comentó. Meta permite una respuesta privada por comentario y
solo dentro de los 7 días siguientes al comentario. La conversación del mensaje directo se crea
en el canal de mensajes de la cuenta y la ves en /v1/conversations .
POST https://api.platica.mx/v1/posts/{postId}/threads/{threadId}/private-replies Cuerpo de la solicitud
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
message | string | Texto del mensaje privado, hasta 1,000 caracteres | ✓ |
commentId | string | Comentario que respondes. Por defecto, el comentario raíz del hilo | — |
publicNotice | string | Comentario público que avisa que mandaste un mensaje privado | — |
{
"message": "¡Hola Ana! Te paso los precios por aquí.",
"publicNotice": "¡Te escribimos por mensaje privado! 📩"
} Respuesta
201 Created
{
"clientToken": "0d6e…",
"commentId": "17890000000000001",
"rootCommentId": "17890000000000001",
"providerMessageId": "aWdfZAG…",
"conversationDocId": "conv_dm_045",
"clientId": "cli_123",
"persistedConversation": true,
"publicNoticeCommentId": "17890000000000100"
} El mensaje se cobra como respuesta a comentario (gratis durante el beta) y emite conversation.created (si la conversación es nueva) y message.created con source: "api.comment.private_reply".
Mandar a responder al agente
Manda al agente lo que quedó sin contestar en un hilo supervisado y deja el hilo en automatic. La
publicación no puede estar pausada y el canal debe tener la respuesta automática activada.
POST https://api.platica.mx/v1/posts/{postId}/threads/{threadId}/send-to-agent Cuerpo de la solicitud
| Campo | Tipo | Descripción | Requerido |
|---|---|---|---|
dryRun | boolean | true solo calcula qué se mandaría, sin mandar nada | — |
{
"dryRun": false
} La respuesta dice qué hilos se mandaron (threads), cuáles se saltaron y por qué (skipped) y
cuántos se encolaron (enqueued).