Comment to DM
Self-hosted Instagram comment-to-DM automation.
Someone comments GUIDE on your reel and the link lands in their DMs about two seconds later. It runs on your own Cloudflare account, on the free plan, through Meta's official API.
Set it up with AI · Quick start · Docs · Dashboard · Troubleshooting · Contributing
Why
Hosted "comment for the link" tools cost $15 to $99 a month. They keep an access token to your Instagram account on their servers, next to every other customer's, and your followers' messages pass through them. They also miss comments: Instagram quietly drops webhooks for collapsed and low-signal comments, and a tool that relies on webhooks alone never sees those.
This project runs the same automation in your Cloudflare account instead. It uses no scraping, no browser automation and no password, and it costs nothing.
Features
- Keyword rules per reel, or for all posts. Match whole words or anywhere in a comment (good for hashtags like
#launch2026). Any script works, and case, emoji, punctuation and Latin accents are ignored, so preco matches PREÇO.
- Exclusions per rule. "How much is the guide?" won't use up that comment's one DM.
- Reply to every comment on a post, no keyword needed, for giveaways and waitlists.
{username} in messages, and random public replies, so the thread doesn't look automated.- Never misses a comment. Meta webhooks give instant delivery. A five-minute backup sweep re-reads the last 72 hours and catches whatever Instagram didn't send.
- Never DMs anyone twice. Each comment is claimed in the database before anything is sent, and Instagram allows only one private reply per comment.
- Rate-limit aware. When Meta's hourly app allowance runs out, the queue pauses and resumes on its own. The newest commenters go first, comments close to Instagram's 7-day cutoff jump the line, and nobody is dropped because of a limit.
- Exact reasons, not "failed". Every comment that didn't get a DM shows Meta's real answer in plain English: already answered, user can't be found, comment deleted, limit hit and so on. Each one says what to do next and gives Meta's error code.
- A real dashboard (below), installable on your phone.
- Both Meta logins. Works with Unified login (Facebook Login for Business, the only option for Meta apps created since late October 2026) and with classic Instagram Login.
- Several Instagram accounts per deployment.
The dashboard
A fast React app served by the same Worker, behind your secret admin URL and password.
| Page | What it does |
|---|
| Overview | A single status line (live, catching up or paused), today's numbers, a 24-hour chart, an on/off switch per automation and the latest comments. |
| Activity | Every keyword comment and what happened to it, with filters, search and counts. Open one to see the exact reason, what to do, and a Check again now button that can never send twice. |
| Automations | A card per reel with its thumbnail and stats. The editor has a post picker with thumbnails, keyword chips, a DM editor with link detection, public replies, a live phone preview and a "try a comment" box that runs the same matcher the Worker uses. |
| Settings | Your Instagram connection, health for each of the three ways comments arrive, Meta's hourly allowance meter, a live feed of what Instagram is sending, and the theme. |
It has light and dark themes, a phone layout with bottom tabs, a ⌘K command palette, and the shortcuts N (new automation) and G A (Activity). The classic server-rendered admin pages are still there too.
How it works
someone comments "guide"
│
▼
Meta webhook (signed) ───▶ your Worker ◀─── backup sweep every 5 minutes
│
claim the comment in D1, match your rules
│
▼
one private DM, now or from the queue (newest first)
│
▼
an optional public reply
This is the beginning of the README. Read the rest at the original. Read the full README ↗
