CampaignCue

Open-source Instagram comment-to-DM campaign OS for businesses, creators, and agencies.

CampaignCue turns comments like LINK, PRICE, or GUIDE into Meta-compliant private replies. The core engine is MIT licensed and self-hostable. The hosted SaaS layer is being built for agencies that want campaign templates, analytics, client reports, and managed reliability.

Templates | Roadmap | Deployment | Referral plan | Production readiness | Contributing | Security | Open-core model

Why This Exists

Instagram comment-to-DM is one of the clearest social-commerce loops:

Customer comments "LINK" on a post or reel
Meta sends a webhook
CampaignCue matches the keyword
The worker sends a private reply using the comment ID
The business gets a warm conversation

Most tools in this market are broad chatbot platforms. CampaignCue is intentionally narrower: a focused campaign operating system for Instagram comment-triggered DMs.

Current Product

• Email magic-link signup with workspace tenancy.
• Instagram professional account connection as an integration.
• Keyword campaigns for posts and reels.
• Meta webhook verification and event storage.
• BullMQ worker for private reply delivery.
• Idempotent DM logs per campaign/comment.
• Atomic monthly usage reservations and Redis-backed hourly DM reservations.
• Stripe Checkout, Customer Portal, and subscription webhooks.
• Plan limits for campaigns and monthly DMs.
• Vercel cron for token refresh and usage maintenance.
• Health checks and authenticated production diagnostics.
• Public Privacy, Terms, Data Deletion, and Meta App Review support pages.
• Public campaign template library.
• Tracked redirect links with click, CTR, and keyword analytics.
• Shareable read-only client report pages.
• Agency-ready multi-account workspaces with member roles and invite links.
• Production deployment docs for Vercel, Railway, Postgres, and Redis.

Demo

The landing page is available locally at:

npm run dev

Then open:

http://localhost:3000

Screenshots and GIFs are planned in issue #17. Good launch assets to add:

• Landing page hero screenshot.
• Dashboard overview screenshot.
• Campaign builder screenshot.
• Logs page screenshot.
• 30 second "comment LINK -> private reply" demo GIF using a Meta test account.

Hosted SaaS

The hosted product will focus on agencies and campaign teams:

• Managed Vercel/Railway infrastructure.
• Public campaign templates.
• Tracked links and click analytics.
• Shareable client reports.
• Multi-account agency workspaces.
• Founding agency offer and referral-program plan.
• SEO landing pages for high-intent Instagram DM automation searches.
• Priority support and onboarding.

The core remains public so builders can self-host, audit, fork, and contribute.

Self-Host Quick Start

Requirements

• Node.js 20+
• PostgreSQL
• Redis
• Meta Developer App
• Instagram Business or Creator account
• Resend account for magic-link email
• Stripe account for subscriptions

Install

git clone https://github.com/im-anishraj/instagram-comment-to-dm.git
cd instagram-comment-to-dm
npm install

Start Services

docker-compose up -d

Configure Environment

cp .env.example .env

Fill in all required values:

• DATABASE_URL
• REDIS_URL
• NEXTAUTH_URL
• NEXTAUTH_SECRET
• CRON_SECRET
• ENCRYPTION_KEY
• RESEND_API_KEY
• EMAIL_FROM
• STRIPE_SECRET_KEY
• STRIPE_WEBHOOK_SECRET
• STRIPE_PRICE_PRO
• STRIPE_PRICE_AGENCY
• META_GRAPH_API_VERSION
• INSTAGRAM_APP_ID
• INSTAGRAM_APP_SECRET
• FACEBOOK_APP_SECRET
• WEBHOOK_VERIFY_TOKEN

Generate ENCRYPTION_KEY with:

openssl rand -hex 32

Database

npm run db:generate
npm run db:migrate

Run Web And Worker

npm run dev
npm run worker

For production deployment, see DEPLOYMENT.md.

Roadmap

The public launch roadmap is tracked in GitHub issues:

• #7 Production readiness - done
• #8 Campaign OS repositioning - done
• #9 Public campaign templates - done
• #10 Tracked links and analytics - done
• #11 Shareable client reports - done
• #12 Agency multi-account support - done
• #13 Founding agency offer and referrals - done
• #14 SEO landing pages - done

See ROADMAP.md for the grouped plan.

Good First Issues

Want to help? Start with the public issue list:

• Good first issues
• Documentation issues
• Template issues

If you build a campaign template that works for your niche, open an issue or pull request.

Development Checks

Every pull request should pass:

npm run typecheck
npm run lint
npm test
npm run build

Community

• Use GitHub Issues for bugs, roadmap tasks, and feature requests.
• Use GitHub Discussions for launch ideas, self-hosting questions, and campaign templates.
• Please read CONTRIBUTING.md before opening a pull request.

License

MIT. See LICENSE.

The open-source core is MIT licensed. The hosted SaaS, managed infrastructure, support, and future agency features are monetized separately. See docs/open-core.md.