Social Content Agent

Welcome to Social Content Agent

Social Content Agent is a WhatsApp-based AI assistant designed to help small Indian creators turn their content ideas into ready-to-film reels without installing another app or creating an account.

Creators can message the agent directly on WhatsApp, describe what they want to create, and have a conversation with the AI until an idea is confirmed. The agent then generates a complete reel with a hook, setup, 30-second script, caption, hashtags, and a relevant YouTube search reference.

The system also maintains creator profiles, conversation history, follower information, and conversation state to provide context across interactions.

WhatsApp in. AI-powered reel content out.

How It Works

The complete interaction is handled through a simple conversational pipeline:

    ┌──────────────┐
    │   Creator    │
    └──────┬───────┘
           ↓
    ┌──────────────┐
    │   WhatsApp   │
    └──────┬───────┘
           ↓
    ┌──────────────┐
    │ Twilio       │
    │ Webhook      │
    └──────┬───────┘
           ↓
┌──────────────────────┐
│ User + Conversation  │
│ Context from Supabase│
└──────────┬───────────┘
           ↓
     ┌────────────┐
     │   Groq     │
     │Conversation│
     └─────┬──────┘
           ↓
    Idea Confirmation
           ↓
    ┌──────────────┐
    │   Claude     │
    │ Reel Content │
    └──────┬───────┘
           ↓
    WhatsApp Response

1. Creator Onboarding

When a creator messages the agent for the first time, it collects four pieces of information:

Name
 ↓
Niche
 ↓
Language
 ↓
Platforms
 ↓
Active Creator

This information becomes the creator's profile and is later used to personalize the generated content.

2. Conversational Idea Discovery

Once onboarding is complete, Groq with Llama 3.3 70B handles the conversation.

Instead of immediately generating an expensive full script, the agent first understands what the creator wants to make and proposes an idea.

Creator's Message
       ↓
Understand Topic
       ↓
Propose Reel Idea
       ↓
"बनाएं? हाँ बोलो 👇"
       ↓
Creator Confirmation

The conversation layer is intentionally separated from script generation, so Claude is only called after the creator confirms the idea.

3. Reel Teaser

After confirmation, the confirmed idea is stored as the pending idea and Claude Sonnet 4.6 generates a short teaser.

Confirmed Idea
      ↓
Claude
      ↓
🎬 Title
🎤 3-Second Hook
      ↓
"Script do"

The creator gets enough information to understand the idea before requesting the complete script.

4. Full Reel Generation

When the creator asks for the script, Claude generates the complete reel using the creator's profile and confirmed idea.

Creator Context
      +
Confirmed Idea
      ↓
Claude
      ↓
┌─────────────────────┐
│ Reel Title          │
│ Setup               │
│ Hook                │
│ 30-sec Script       │
│ Editing Tip         │
│ Reference Videos    │
│ Caption             │
│ Hashtags            │
└─────────────────────┘

The generated reel is designed around a phone, natural light, and zero additional equipment.

5. Personalization

Every reel generation receives the creator's context:

Name
Niche
Language
Platforms
Follower Stage
Past Session Context

The follower count is converted into a growth stage, allowing the generated idea to consider where the creator currently is in their growth journey.

The system also keeps a small history of previous sessions to avoid repeating recent content contexts.

6. Weekly Growth Check-in

The agent doesn't only generate content. It also checks in with creators every seven days.

Weekly Check-in
      ↓
Follower Counts
      ↓
Claude extracts numbers
      ↓
Previous vs Current
      ↓
Growth Insight
      ↓
Actionable Tip

The creator can provide follower counts in free-form text. Claude extracts the numbers, compares them with the previous counts, and generates a short growth insight in the creator's preferred language.

7. Conversation State

The interaction is maintained through a small state machine:

     ┌──────────┐
     │   idle   │
     └────┬─────┘
          ↓
   Groq conversation
          ↓
  ┌──────────────┐
  │  confirming  │
  └──────┬───────┘
         ↓
    User confirms
         ↓
┌──────────────────┐
│ script_requested │
└────────┬─────────┘
         ↓
  Claude generates
    full script
         ↓
     ┌───────┐
     │ idle  │
     └───────┘

This keeps the conversation flow deterministic while allowing the AI to handle the natural-language interaction.

Key Features

• WhatsApp AI Agent: Create and refine reel ideas directly through WhatsApp.
• AI-Powered Conversations: Groq handles topic discovery and idea confirmation.
• Personalized Reel Generation: Claude generates content based on niche, platform, language, and growth stage.
• Multilingual: Supports Hindi, Marathi, and English.
• Weekly Growth Insights: Tracks follower counts and provides personalized weekly feedback.
• Conversation Memory: Stores creator profiles and conversation history in Supabase.
• Welcome Back: Recognizes creators returning after seven days of inactivity.

Technologies Used

• Backend: Node.js, Express.js, TypeScript
• AI: Claude Sonnet 4.6, Groq, Llama 3.3 70B
• Messaging: Twilio WhatsApp API
• Database: Supabase