For the complete documentation index, see llms.txt. This page is also available as Markdown.

DM Automations

A DM automation sends a direct message on your behalf when someone comments on your post or sends you a message. Set it up once, and Blotato replies for you.

DM Automations are available on every paid plan. You manage them in the Blotato web app or through ChatGPT, Claude, Hermes, or another AI tool connected to Blotato MCP.

DM automations work on Instagram and Facebook Pages. Twitter/X, TikTok, LinkedIn, Pinterest, Threads, Bluesky, and YouTube are not supported at this time.

Each automation has three parts:

  • A trigger. The event Blotato listens for: a comment on your post, or a direct message someone sends you.

  • Keywords. Optional words or phrases the comment or message must contain.

  • A message. The text Blotato sends back, plus up to 3 link buttons.

Three optional steps extend an automation:

  • A follow gate. Holds your message back until the person follows your Instagram account.

  • An email gate. Holds your message back until the person replies with an email address.

  • A webhook. Calls your own endpoint once your message goes out.

Blotato runs the steps in a fixed order: follow gate, email gate, your message, webhook.

Before You Start

Blotato needs permission to read comments and read/send messages on your account.

If you connected your account before messaging, comments, or (for Instagram) follow gating launched, reconnect it so Blotato has the new permissions.

For Instagram comment triggers, the connected Instagram account must own the post. DM automations do not run on posts where your account appears only as a collaborator. If you co-authored a post, create the automation from the Instagram account that originally published the post.

Reconnect before you use a follow gate. Blotato subscribes your account to button-tap events at connect time. An account connected before DM automations and follow gating landed carries no such subscription, so taps on the follow-gate button do not reliably reach Blotato. Reconnecting the account fixes it. Reconnect in Settings > Social Accounts.

Create a DM Automation

  1. Click New automation.

  2. Pick the connected Instagram account or Facebook Page the automation runs on.

  3. Name the flow, for example "Auto-DM links from comments".

  4. Click Create flow.

The connected account is locked for the flow after creation. To use a different account, create a new flow.

Set the Trigger

  1. Open the automation from Automations.

  2. Pick the trigger: Someone comments or Someone sends a message.

  3. For a comment trigger, pick On a specific post or reel or On any post or reel.

  4. For a specific post, search your published posts and select one.

  5. Add keywords in the And the comment has field. Press Enter after each keyword.

  6. Leave the keyword field empty to fire on every comment or message.

How Keywords Match

  • Matching ignores upper and lower case. PRICE matches price.

  • A keyword matches as a whole word. price matches "what is the price?" and skips "pricey".

  • A multi-word keyword tolerates line breaks. lead magnet matches a comment with "lead" and "magnet" on separate lines.

  • An automation fires when the comment or message contains any one of your keywords.

Targeting a Specific Post

The post picker lists posts you published through Blotato. Target a post published outside Blotato with the On any post or reel option plus a keyword.

Instagram collaborator posts do not trigger DM automations for the collaborator account. Use the Instagram account that owns the post.

Write the Message

  1. Type the message in the Message field. The limit is 640 characters.

  2. To give recipients a link to open, click Add a button. Skip this step when your message does not need a link.

  3. Enter the Button label, up to 20 characters.

  4. Enter the Web URL the button opens.

  5. Repeat for up to 3 buttons.

  6. Click Remove beside any link button you do not want to send.

Link buttons are optional. The Button label is the text a recipient sees. The Web URL is the page the button opens. This Web URL is separate from the Webhook URL, which sends automation data to your endpoint after the message goes out. For a flow that only collects an email address and sends it to n8n, Zapier, Make.com, or a CRM, remove every link button and turn on Ask for an email address and Call a webhook.

Link buttons are the only button type you author on your message. To send tappable reply chips or capture-the-tap buttons, use the Messages API. A follow gate adds a confirm button Blotato manages, and you set its label only.

Buttons show in the Instagram mobile app only. Someone reading your DM on instagram.com in a desktop browser sees the message text with no buttons under it. Instagram sets this behavior, and no Blotato setting changes it.

For Instagram, use a button or a plain-text URL, not both. A message carrying both leaves the URL unclickable on desktop, so a desktop reader ends up with no working link at all. Pick one based on your audience:

  • Mostly mobile. Keep the link button and leave the URL out of the message text.

  • Mostly desktop. Remove the button and put the URL in the message text instead.

Ask for a Follow (Instagram Only)

A follow gate holds your message back until the person follows your Instagram account.

  1. Open the automation from Automations.

  2. Turn on Ask for a follow.

  3. Type the message in the Message field, up to 640 characters. Ask them to follow you.

  4. Type the Button label, up to 20 characters. The default is "I'm following".

  5. Click Save and Publish.

Here is what the person sees:

  1. They comment or message with your keyword.

  2. Blotato sends the follow-gate message with a button under it.

  3. They follow your account and tap the button.

  4. Blotato checks whether they follow you.

  5. Following, they get your message. Not following, they get the follow-gate message again.

The follow gate runs on Instagram only. A Facebook automation rejects it.

Follow Gate Rules

  • The gate message always goes first. Instagram grants Blotato access to follower status once the person opens a DM thread with your account, so Blotato asks them first and checks second.

  • The person has 1 hour to respond. With no reply inside the window, the run ends as expired and nothing else sends.

  • An unknown follower status sends your message. Instagram withholds follower status for someone who never granted profile access. Blotato sends your message rather than blocking them.

  • A confirmed follow lasts 30 days. Blotato reuses the result for 30 days, so a repeat contact skips the check. A "not following" result is never reused.

  • Any reply moves the gate forward. Blotato runs the follower check on the person's next DM, whatever it says. The button is a shortcut, not a requirement.

Write the Gate Message for Desktop Readers

Instagram renders DM buttons in the Instagram mobile app only. Someone reading on instagram.com in a desktop browser sees your gate message with no button under it, and with nothing to tap they stall until the window closes.

Write the gate message so it works either way:

  1. Ask them to follow the account.

  2. Ask them to reply with a word, for example "Reply FOLLOWING once you have."

  3. Leave the button label as it is for the mobile readers.

Blotato runs the follower check on any reply, so a desktop reader who types the word moves forward exactly like a mobile reader who taps the button.

An audience reading mostly on desktop needs the reply instruction. Leaving the message to say "tap the button below" alone strands them.

Ask for an Email Address

An email gate holds your message back until the person replies with an email address.

  1. Open the automation from Automations.

  2. Turn on Ask for an email address.

  3. Type the message in the Message field, up to 640 characters. Ask them to reply with their email.

  4. Click Save and Publish.

Here is what the person sees:

  1. They comment or message with your keyword.

  2. Blotato sends the email-gate message.

  3. They reply with their email address.

  4. Blotato reads the first email address in the reply and saves it to the contact.

  5. They get your message.

A reply with no email address in it returns the email-gate message, and Blotato waits again.

The email gate runs on Instagram and Facebook Pages.

Email Gate Rules

  • The person has 1 hour to reply. With no reply inside the window, the run ends as expired.

  • Blotato reads the first email address in the reply. A reply holding two addresses saves the first one.

  • Blotato saves the address to the contact record. Add a webhook to receive it.

  • A nonexistent address still passes. Blotato checks the shape of the address, not whether the mailbox exists.

Call a Webhook

A webhook tells your own system a DM went out. Blotato calls your endpoint after your message sends.

  1. Open the automation from Automations.

  2. Turn on Call a webhook.

  3. Pick the Method: GET, POST, PUT, PATCH, or DELETE.

  4. Enter the URL, up to 2048 characters.

  5. Click Add a header to send an API key or another header your endpoint needs.

  6. Click Save and Publish.

What Blotato Sends

Every method except GET carries a JSON body. GET carries no body.

With an email gate on the automation:

With no email gate:

Webhook Rules

  • The URL needs a public address. Blotato rejects private, loopback, link-local, and cloud metadata addresses. A localhost endpoint or an internal 10.x address fails.

  • Blotato waits 10 seconds. A slower endpoint fails the run.

  • Blotato does not follow redirects. Point the automation at the final URL.

  • An error response does not stop the automation. Your endpoint answering 500 gets logged with its status, and the run still completes. A blocked address, a DNS failure, or a timeout fails the run with error code 20304.

  • Blotato reads the first 16 KB of your response. Longer responses get cut.

  • Your headers stay out of the logs. Blotato redacts them, so an API key never lands in a log entry.

This webhook is separate from the webhook publish target, which sends post content to your endpoint at publish time.

Publish

  1. Click Publish to take the automation live.

  2. The status badge switches from Draft to Live.

An automation needs a trigger, a message of 1 to 640 characters, and valid button URLs before it goes live. A gate you turned on needs its own message, and a webhook you turned on needs a valid http(s) URL.

Edits to a live automation publish as soon as you click Save and Publish. Edits to a draft stay saved until you publish.

Click Move to Draft to stop an automation. It stops responding to new comments and messages. Runs already in flight finish.

Test a Comment Trigger

Your own comments do not trigger a DM automation. Blotato skips comments posted by the same Instagram account or Facebook Page connected to the automation.

  1. Publish the automation.

  2. Sign in to a different Instagram or Facebook account.

  3. Comment on the target post using one of the automation's keywords.

  4. Confirm the other account receives the direct message.

  5. Open the automation and review its runs and logs.

Read the Stats

The Stats card on an automation shows all-time totals:

Stat
Meaning

Triggered

Times a comment or message matched the trigger.

Completed

Times the DM reached the recipient.

Failed

Times the DM did not send.

A run stays open until the message settles, so Completed plus Failed is sometimes lower than Triggered. A run where someone never answered a follow gate or an email gate ends as expired, and expired runs count under Triggered alone.

Reuse an Automation on Another Account

Duplicate an automation to run the same message on a second account.

  1. Open the menu on the automation you want to copy.

  2. Click Duplicate.

  3. Pick the account to copy it to.

  4. Click Duplicate flow.

The copy takes the name of the original with (copy) on the end, and it carries over the trigger, the message, the buttons, the follow gate, the email gate, and the webhook.

Three things to check after duplicating:

  • Review the trigger and update it to watch your targeted post on the new account.

  • Review the webhook. The copy calls the same endpoint as the original, so your endpoint starts receiving runs from a second account.

  • The copy lands as a Draft. Open it and click Publish to take it live.

You may only duplicate to accounts on the same platform. An Instagram automation copies to another Instagram account, never to a Facebook Page.

Platform Rules

Instagram and Facebook set the rules below, not Blotato. A message outside an allowed window fails.

  • Comment trigger. Blotato answers with a private reply to the comment. Instagram and Facebook allow one private reply per comment, within 7 days of the comment. A comment you already replied to privately, through Blotato or another tool, rejects the second reply.

  • Message trigger. Blotato replies within 24 hours of the person's last message.

  • No cold outreach. An automation answers people who comment or message first. Blotato does not message people who never contacted you.

  • Your own activity never triggers. Comments you post and messages you send do not start a run.

  • A reply during a gate continues the run. While an automation waits on someone's answer, their next DM resumes the waiting run instead of starting a new one.

  • Button taps never start a run. Tapping the follow-gate button continues the run it belongs to.

Limits

Limit
Value

Message length

640 characters

Follow gate or email gate message length

640 characters

Link buttons per message

3

Button label

20 characters

Follow gate button label

20 characters

Automation name

60 characters

Reply window on a gate

1 hour

Webhook URL length

2048 characters

Webhook timeout

10 seconds

Active contacts

Every DM an automation sends counts toward your plan's monthly active-contacts limit, the same as a message you send yourself. Reaching the same person twice in a month counts once.

For more information, see Active Contacts.

Troubleshooting

The automation shows Live but never fires.

  1. Confirm the comment or message contains one of your keywords as a whole word.

  2. For a specific-post trigger, confirm the comment landed on the post you selected.

  3. Confirm the comment came from a different account. Your own comments never trigger the automation.

  4. If you connected your account before messages and comments were released, reconnect the account in Settings > Social Accounts and confirm the account has access.

Runs show as Failed.

Open the automation and read the run error and error logs. Common causes: the 24-hour messaging window closed, the comment already received a private reply, or the connected account expired. See Messaging Errors.

The follow-gate button does nothing when tapped.

  1. Reconnect the Instagram account in Settings > Social Accounts. Blotato subscribes your account to button-tap events at connect time, and an account connected before DM automations and follow gating landed never receives them.

  2. Republish the automation and test it again.

  3. Ask the person to reply with any message instead. Blotato runs the follower check on any reply, so a typed reply advances the run the same way.

Nobody gets past the follow gate on desktop.

Instagram shows DM buttons in the Instagram mobile app only, so a desktop reader sees no button to tap. Edit the gate message to ask them to reply with a word, for example "Reply FOLLOWING once you have." Blotato runs the follower check on any reply.

Someone keeps getting the follow-gate message.

Blotato re-sends the gate message every time the check returns "not following". Ask the person to follow the account first, then tap the button. Someone who taps the button without following stays in the loop until the 1-hour window closes.

The email gate keeps asking for an email.

Blotato reads an email address out of the reply text. A reply with a typo in the address, or with the address written as "name at example dot com", returns the gate message again.

The webhook never fires.

  1. Confirm the DM sent. Blotato calls the webhook after your message goes out, so a failed DM stops the run first.

  2. Open the run logs and read the Sending request and Received response entries.

  3. Confirm the URL points at a public address. Blotato rejects private and loopback addresses.

  4. Confirm your endpoint answers inside 10 seconds.

The DM arrives, but the buttons are missing.

  1. Ask the recipient which device they used. Instagram shows DM buttons in the mobile app only, so buttons stay hidden on instagram.com in a desktop browser.

  2. For a desktop audience, remove the button and put the URL in the message text instead. Keeping both leaves the URL unclickable on desktop.

  3. Confirm every button has a valid http(s) URL.

Build Automations with ChatGPT, Claude, Hermes, OpenClaw, or Another MCP Client

  1. Complete the Blotato MCP setup.

  2. Start a new chat in your AI tool.

  3. Ask: "Walk me through how to set up Blotato DM Automations."

  4. Provide the account, trigger, optional keywords, message, and up to three link buttons.

  5. Add the optional steps you want: a follow gate for Instagram, an email gate, and a webhook URL with its method.

  6. Review the automation before activating it.

Your AI tool works with Blotato MCP to create, edit, list, activate, deactivate, and archive automations. Ask for automation analytics to review triggered, completed, and failed totals.

Example: Turn One Comment Into a CRM Lead

Use this workflow in ChatGPT, Claude, Hermes, OpenClaw, Codex, or another AI tool connected to Blotato MCP.

Someone comments GUIDE on Facebook or Instagram. Blotato asks for an email address, sends the guide, and posts the captured email to your CRM webhook.

Comment → DM → Email → CRM

1. Connect Blotato

  1. Complete the Blotato MCP setup for your AI tool.

  2. Start a new chat in your AI tool.

  3. Ask: List my connected Blotato social accounts.

  4. Confirm the response includes your Facebook Page and Instagram account.

Blotato MCP connector configured in Claude
This example shows Blotato MCP connected in Claude. The same workflow applies to other MCP clients.

2. Create the Facebook and Instagram Automations

Each DM Automation targets one connected account. Create one automation for your Facebook Page and one for your Instagram account.

  1. Replace GUIDE, [GUIDE URL], and [CRM WEBHOOK URL] in this prompt:

    Create separate Facebook and Instagram comment-to-DM automations in Blotato. Use my connected Facebook Page and Instagram account. When someone comments GUIDE on any post, ask, "Where should I send the guide?" and wait for an email address. After Blotato captures the email, send, "Here is your free guide: [GUIDE URL]." Then send a POST request containing the captured email to my CRM webhook at [CRM WEBHOOK URL]. Create both automations as inactive drafts. Show me the configuration for each automation before activation.

  2. Send the completed prompt to your AI tool.

  3. Ask: List my DM Automations and show the account, trigger, keyword, email gate, message, webhook, and status for each one.

  4. Confirm one draft targets Facebook and one draft targets Instagram.

  5. Review the account, GUIDE keyword, email question, guide link, and CRM webhook on both drafts.

Blotato DM Automation builder showing a comment keyword and automatic direct message
Review each draft in the Blotato DM Automation builder before activation.

3. Activate the Automations

  1. Ask: Activate the Facebook and Instagram GUIDE automations.

  2. Ask: List both automations and confirm their status is active.

4. Test the Full Flow

  1. Comment GUIDE on your Facebook post from another Facebook account.

  2. Confirm the Facebook account receives the email question in a private message.

  3. Reply with a test email address.

  4. Confirm the Facebook account receives the guide message.

  5. Confirm your CRM receives the test contact.

  6. Repeat the test on Instagram from another Instagram account.

  7. Ask: Show the latest runs and logs for both GUIDE automations.

  8. Confirm each test run completed.

Flow diagram showing a Facebook or Instagram comment becoming a CRM lead
The automation turns a comment into a direct-message conversation, captured email, and CRM contact.

To review performance later, ask: Show the triggered, completed, and failed totals for my GUIDE automations.

Build Automations with the API

Every setting on this page is available through the API and the MCP server.

Last updated