Answer comments

Everything the brand publishes is public and immediate on Meta. Send Idempotency-Key on these calls (see Safe retries ).

Publish a comment

A new brand comment on the post that does not reply to anyone.

POST https://api.platica.mx/v1/posts/{postId}/comments

Request body

FieldTypeDescriptionRequired
messagestringText. Up to 2,200 characters on Instagram and 8,000 on Facebook✓ unless there is an image
attachmentUrlstringFacebook only: a JPG, PNG, or GIF image over https, up to 10 MB—
{
  "message": "Thanks for all your comments! We're answering here 👇"
}

Response

201 Created

{
  "commentId": "17890000000000099",
  "clientToken": "6f1c7a9e-3b4d-4f8a-9c2e-1a5b7d9e0f12",
  "mode": "root",
  "parentCommentId": null,
  "commentPersistencePending": false
}

The comment shows up in the thread and in the comment.created webhooks once Meta confirms it, within seconds.

Reply publicly

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

Request body

FieldTypeDescriptionRequired
messagestringReply text✓
parentCommentIdstringThread comment you reply to. Defaults to the root comment—
{
  "message": "Hi Ana! Yes, size M is available in every color."
}

201 Created with commentId, mode: "reply", and the thread state, which ends up resolved.

Reply privately

Sends a direct message to the person who commented. Meta allows one private reply per comment and only within 7 days of the comment. The direct-message conversation is created on the account's messaging channel and you see it in /v1/conversations .

POST https://api.platica.mx/v1/posts/{postId}/threads/{threadId}/private-replies

Request body

FieldTypeDescriptionRequired
messagestringPrivate message text, up to 1,000 characters✓
commentIdstringComment you answer. Defaults to the thread's root comment—
publicNoticestringPublic comment letting people know you sent a private message—
{
  "message": "Hi Ana! Here are the prices.",
  "publicNotice": "We sent you a private message! 📩"
}

Response

201 Created

{
  "clientToken": "0d6e…",
  "commentId": "17890000000000001",
  "rootCommentId": "17890000000000001",
  "providerMessageId": "aWdfZAG…",
  "conversationDocId": "conv_dm_045",
  "clientId": "cli_123",
  "persistedConversation": true,
  "publicNoticeCommentId": "17890000000000100"
}

The message is billed as a comment reply (free during the beta) and emits conversation.created (if the conversation is new) and message.created with source: "api.comment.private_reply".

Send to the agent

Sends whatever was left unanswered in a supervised thread to the agent and sets the thread to automatic. The post cannot be paused and the channel must have auto-reply turned on.

POST https://api.platica.mx/v1/posts/{postId}/threads/{threadId}/send-to-agent

Request body

FieldTypeDescriptionRequired
dryRunbooleantrue only computes what would be sent, without sending—
{
  "dryRun": false
}

The response says which threads were sent (threads), which were skipped and why (skipped), and how many were queued (enqueued).