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_URLREDIS_URLNEXTAUTH_URLNEXTAUTH_SECRETCRON_SECRETENCRYPTION_KEYRESEND_API_KEYEMAIL_FROMSTRIPE_SECRET_KEYSTRIPE_WEBHOOK_SECRETSTRIPE_PRICE_PROSTRIPE_PRICE_AGENCYMETA_GRAPH_API_VERSIONINSTAGRAM_APP_IDINSTAGRAM_APP_SECRETFACEBOOK_APP_SECRETWEBHOOK_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:
See ROADMAP.md for the grouped plan.
Good First Issues
Want to help? Start with the public issue list:
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.
