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
| Field | Type | Description | Required |
|---|---|---|---|
message | string | Text. Up to 2,200 characters on Instagram and 8,000 on Facebook | ✓ unless there is an image |
attachmentUrl | string | Facebook 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
| Field | Type | Description | Required |
|---|---|---|---|
message | string | Reply text | ✓ |
parentCommentId | string | Thread 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.
A thread in assistance does not accept replies until someone accepts it: send PATCH /v1/posts/{postId}/threads/{threadId} with "operation": "supervised".
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
| Field | Type | Description | Required |
|---|---|---|---|
message | string | Private message text, up to 1,000 characters | ✓ |
commentId | string | Comment you answer. Defaults to the thread's root comment | — |
publicNotice | string | Public 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
| Field | Type | Description | Required |
|---|---|---|---|
dryRun | boolean | true 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).