Comment to DM

A comment automation watches one post (or every post on an account) for a keyword and answers each matching comment automatically: a private DM to the commenter, a public reply under the comment, or both. It is the classic "comment GUIDE and I'll send it to you" funnel, without a graph to build.

X accounts are refused with 400 platform_not_supported.

#Create one

This automation answers anyone who comments "guide" under one reel with a DM and a button, then thanks them publicly.

curl -X POST https://api.pozy.ai/v1/comment-automations \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "6650c1e2a3b4c5d6e7f80911",
    "accountId": "6650c1e2a3b4c5d6e7f80a22",
    "name": "Guide giveaway",
    "platformPostId": "17912345678901234",
    "keywords": ["guide"],
    "matchMode": "word",
    "dmMessage": "Hey {{first_name}}! Here is the guide you asked for.",
    "buttons": [{ "type": "url", "title": "Get the guide", "url": "https://acme.example/guide.pdf" }],
    "commentReply": "Sent it to your DMs, {{first_name}}!",
    "commentReplyVariations": ["Check your inbox!", "On its way to your DMs."],
    "actions": { "likeComment": true }
  }'

const res = await fetch("https://api.pozy.ai/v1/comment-automations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    profileId: "6650c1e2a3b4c5d6e7f80911",
    accountId: "6650c1e2a3b4c5d6e7f80a22",
    name: "Guide giveaway",
    platformPostId: "17912345678901234",
    keywords: ["guide"],
    matchMode: "word",
    dmMessage: "Hey {{first_name}}! Here is the guide you asked for.",
    buttons: [{ type: "url", title: "Get the guide", url: "https://acme.example/guide.pdf" }],
    commentReply: "Sent it to your DMs, {{first_name}}!",
    commentReplyVariations: ["Check your inbox!", "On its way to your DMs."],
    actions: { likeComment: true },
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.automation.id);

import os
import requests

resp = requests.post(
    "https://api.pozy.ai/v1/comment-automations",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "profileId": "6650c1e2a3b4c5d6e7f80911",
        "accountId": "6650c1e2a3b4c5d6e7f80a22",
        "name": "Guide giveaway",
        "platformPostId": "17912345678901234",
        "keywords": ["guide"],
        "matchMode": "word",
        "dmMessage": "Hey {{first_name}}! Here is the guide you asked for.",
        "buttons": [{"type": "url", "title": "Get the guide", "url": "https://acme.example/guide.pdf"}],
        "commentReply": "Sent it to your DMs, {{first_name}}!",
        "actions": {"likeComment": True},
    },
    timeout=30,
)
print(resp.json()["automation"]["id"])

The automation is active as soon as it is created. Send isActive: false to create it paused, and PATCH /v1/comment-automations/{id} to change it later.

#Choose what triggers it

Which post. Pass platformPostId for one live post, or leave it out to watch every post on the account. To prepare an automation for a post you have scheduled but not published, pass the Pozy postId instead: the automation waits and arms itself when the post goes live.

Which comments.

Use word mode for short keywords. contains with a short keyword fires on far more comments than you expect.

#What the commenter gets

Personalise any text with {{first_name}}, {{name}} and {{username}}. Missing values become an empty string, so write copy that still reads well without them.

Link tracking. URL buttons are wrapped in a tracked redirect by default, so you can count clicks in the logs. Add clickTag to tag every contact who clicks. Send linkTracking: false to keep links exactly as written.

Continue into a workflow. A postback button with payload pozy:workflow:<workflowId> starts that workflow on tap, skipping its keyword condition. The workflow must be active on the same account and profile. The DM alone does not start it; the person has to tap. See Workflows.

#Timing and the public reply

• dmDelaySeconds (up to 86,400) waits before sending the DM. The comment is still matched and deduplicated the moment it arrives.
• commentReplyDelaySeconds waits before the public reply. The public reply never goes out before the DM.
• publicReplyPolicy: after_dm (default) posts the public reply only after a successful DM. always posts it whatever happens to the DM.
• actions.likeComment and actions.hideComment like or hide the matched comment. They never block the DM, and when one cannot run, the log says why. Liking on Instagram is in limited release; see Comments.

#Follower rules (Instagram)

audience limits who gets the DM:

Instagram only reveals whether someone follows you after they have messaged your account, and commenting does not count. So for most first-time commenters the answer is unknown, and whenUnknown decides:

• send delivers the DM anyway, so no real customer is silently dropped.
• skip stays silent.
• verify sends followGate.message with a confirm button. The tap is itself a message, which lets Pozy check the follow, then send the real DM or followGate.notFollowingMessage.

followGate sets the copy: message, buttonLabel, an optional profileButtonLabel that opens your profile, and notFollowingMessage.

#Repeat rules and pacing

Platforms watch for accounts that send the same message to many people in a burst. Variations, deduplication and a small dmDelaySeconds all make an automation look less like spam and keep the account in good standing.

#How comments are caught

Comments reach Pozy by webhook in real time. As a safety net, Pozy also reads the latest comments every 10 minutes (the bound post, or the 5 newest posts for an account-wide automation) and answers any the webhook missed. Each comment is answered at most once, whichever path sees it first.

On Threads, LinkedIn and YouTube, comments are read by that poll only, so replies follow within about 10 minutes on posts from the last day, and less often on older posts. TikTok comments arrive by webhook for business accounts.

#Check what happened

GET /v1/comment-automations/{id}/logs lists every comment that triggered the automation, with the send status and the commenter. Filter by status:

Each row also shows the public reply status, likeSkipped and hideSkipped reasons, and link clickCount.

#Errors

#Endpoints