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

CampoTipoDescripciónRequerido
messagestringTexto. Hasta 2,200 caracteres en Instagram y 8,000 en Facebook✓ si no hay imagen
attachmentUrlstringSolo 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

CampoTipoDescripciónRequerido
messagestringTexto de la respuesta✓
parentCommentIdstringComentario 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.

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

CampoTipoDescripciónRequerido
messagestringTexto del mensaje privado, hasta 1,000 caracteres✓
commentIdstringComentario que respondes. Por defecto, el comentario raíz del hilo—
publicNoticestringComentario 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

CampoTipoDescripciónRequerido
dryRunbooleantrue 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).