Automate Instagram DMs, WhatsApp messages, and comment moderation using AI agents.
SocialSync AI helps businesses automate social media customer support across Instagram, WhatsApp, and Messenger using AI-powered agents with knowledge base integration.
Project.SocialsyncAI.video.mp4
Social media messages and comments require constant monitoring and quick responses.
SocialSync AI automates this workflow: AI agents respond to customer inquiries 24/7 using your knowledge base, while escalating complex cases to human support.
Key benefits:
- Unified Inbox: Manage Instagram DMs, WhatsApp chats, and Messenger conversations in one place
- AI Automation: Train AI agents on your business knowledge base for accurate, context-aware responses
- Smart Escalation: Automatically routes complex queries to human agents when confidence is low
- Real-time: Webhooks deliver messages instantly, with responses sent in under 2 seconds
- RAG-based responses: AI agents use retrieval-augmented generation to answer questions from your knowledge base
- Multi-model support: Works with OpenAI, Anthropic, Google Gemini, and OpenRouter
- Confidence scoring: Automatically escalates low-confidence responses to human review
- Cross-platform messaging: Instagram DMs, WhatsApp Business API, and Messenger in one interface
- Real-time sync: Webhooks deliver new messages instantly
- Conversation history: Full message history with metadata and analytics
- Document ingestion: Upload PDFs, text files, or paste content directly
- Vector search: Fast semantic search using PostgreSQL pgvector
- FAQ management: Create and manage frequently asked questions
- Auto-moderation: Automatically monitor and respond to Instagram comments
- Smart triage: AI determines which comments need responses
- Import posts: Import existing Instagram posts for monitoring
- Response metrics: Track AI response rate, escalation rate, and response time
- Conversation insights: Monitor message volume, sentiment, and engagement
- Performance tracking: Daily, weekly, and monthly analytics reports
Prerequisites: Docker and Docker Compose installed on your machine.
# Clone the repository
git clone https://github.com/YOUR_USERNAME/SocialSyncAI.git
cd SocialSyncAI
# Copy environment files
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
# Start all services (backend, frontend, Redis, Celery workers)
docker-compose up --buildSet up the database:
# Install Supabase CLI
npm install -g supabase
# Link to your Supabase project (create one at supabase.com first)
npx supabase link --project-ref <your-project-id>
# Apply all database migrations
npx supabase db pushOpen your browser:
- Frontend: http://localhost:3000
- Backend API: http://localhost:8000
- API Documentation: http://localhost:8000/docs
Next steps: See Getting Started Guide for detailed setup including Supabase credentials, Meta platforms, and AI provider configuration.
Full documentation is available in the docs/ directory.
- Getting Started - Complete setup guide (15 minutes)
- Environment Variables - All configuration options explained
- Supabase Setup - Database and authentication configuration
- Meta Platforms Setup - Instagram, WhatsApp, Messenger OAuth
- Webhooks Configuration - Real-time event delivery setup
- System Overview - High-level architecture and data flow
- Database Schema - Complete PostgreSQL table structure
Frontend
- Next.js 14 (App Router) - React framework with server components
- TypeScript - Type-safe JavaScript
- Tailwind CSS + shadcn/ui - Styling and component library
- Supabase Auth - JWT-based authentication
Backend
- FastAPI - Python async web framework
- Celery - Distributed task queue for background jobs
- Redis - Message broker and caching layer
- LangChain + LangGraph - AI agent orchestration
Database
- PostgreSQL (via Supabase) - Primary database
- pgvector - Vector similarity search for embeddings
Infrastructure
- Docker + Docker Compose - Containerization
- Meta Graph API - Instagram, WhatsApp, Messenger integration
- Stripe - Payment processing (optional)
We welcome contributions from the community!
Before contributing:
- Read the Contributing Guide
- Check open issues
- Fork the repository and create a feature branch
Areas where we need help:
- Additional social platform integrations (Twitter/X, LinkedIn, TikTok)
- Multi-language support (currently English-only)
- Advanced analytics features
- Documentation improvements
Real-time chat interface with AI-powered responses
Connect Instagram, WhatsApp, and Messenger accounts
Test your AI agent before deployment
This project is licensed under the MIT License.
You are free to use, modify, and distribute this software for commercial or non-commercial purposes. See the LICENSE file for full details.
Need help?
- π Read the full documentation
- π Report bugs via GitHub Issues
- π¬ Join discussions in GitHub Discussions