MeuPerfil

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

MeuPerfil 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 | Pitch | Product strategy | Campaign verticals | Deployment | Referral plan | Production readiness | Contributing | Security | Open-core model

Pitch

MeuPerfil is a content-to-conversion platform

We help creators, brands, and businesses turn attention into measurable action.

Instead of managing isolated tools for social posting, DM automation, and bio links, MeuPerfil connects the whole journey:

Content -> Engagement -> CTA -> Conversation -> Lead -> Conversion

We are not a generic social media manager, and we are not trying to be a direct clone of mature tools like Buffer or Manychat.

Our focus is to help every post become a campaign:

• publish content
• capture engagement
• trigger automated conversations
• send tracked links
• collect leads
• measure conversion and ROI

Positioning

MeuPerfil = campaign OS for content-driven growth.

The product should be sold as:

• Content-to-Conversion Platform
• Campaign OS
• Turn every post into a campaign

The core promise

Transform followers into clients automatically.

---

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
MeuPerfil 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. MeuPerfil is intentionally narrower: a focused campaign operating system for Instagram comment-triggered DMs.

Current Product

• Email magic-link signup with workspace tenancy.
• Bio-link profiles with themes, ordered blocks, visits, and click analytics.
• Instagram post scheduling with automatic campaign attachment and delivery recovery.
• Persisted campaign leads with search, campaign filters, and qualification status.
• Database-backed beta waitlist with duplicate registration protection.
• 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.

Rodar localmente (atalho)

Com Node 24 e Docker Desktop instalados:

./iniciar-local.sh          # Docker, .env, dependências, migrations, app e worker
./iniciar-local.sh parar    # desliga Postgres e Redis

O script usa a primeira porta livre a partir de 3000 e mostra o link de login no terminal. Ambientes DS/HM/PD: docs/environments.md.

Self-Host Quick Start

Requirements

• Node.js 24
• 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/patricknasc/meuperfil.git
cd meuperfil
npm install

Start Services

npm run services:up

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.

Latest database changes

Run npm run db:migrate before starting the updated web app and worker. Production and staging must deploy both processes after applying migrations. Instagram accounts need to reconnect to grant the new publishing permission.

If a previous installation used .data/beta-waitlist.jsonl, run npm run beta:import to import it without deleting the original file.

See integration checks and implementation notes.

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.