AI-Powered Features

TeleSender integrates artificial intelligence to help you score leads, generate compelling messages, and optimize your outreach for maximum effectiveness.

Overview

Our AI tools analyze Telegram user profiles and messages to provide actionable insights:

• Lead Scoring — Automatically rank and segment leads
• Message Generation — Create engaging message variations
• Message Optimization — Improve existing messages

Accessing AI Tools

1. Open TeleSender Options page
2. Navigate to the AI tab
3. Select your tool:
   • Lead Scorer
   • Message Generator
   • Message Optimizer
   • Usage Dashboard

AI Lead Scoring

How It Works

The Lead Scorer analyzes Telegram user profiles to determine their potential value as leads.

User Profile → AI Analysis → Score (0-100) → Segment → Insights

Scoring Inputs

The AI considers:

Input	Description	Weight
Username	Quality and professionalism	Medium
First/Last Name	Completeness and format	Low
Bio	Content and relevance	High
Premium Status	Telegram Premium subscriber	Medium
Activity Indicators	Profile completeness	Medium

Scoring Output

{
  user: {
    id: "123456789",
    username: "marketing_pro",
    firstName: "John",
    lastName: "Smith",
    bio: "Digital marketing consultant | 10+ years experience"
  },
  score: {
    value: 87,
    segment: "hot_lead",
    reasoning: "Professional username, complete profile, industry-relevant bio indicating decision-maker status"
  }
}

Lead Segments

Segment	Score Range	Description	Recommended Action
Hot Lead	80-100	High potential, engage immediately	Priority outreach
Warm Lead	50-79	Good potential, worth pursuing	Standard campaign
Cold Lead	0-49	Low potential or unclear	Nurture or skip

Using Lead Scorer

Step 1: Select Contacts

Choose contacts to score:

• From scrape history
• From contact database
• Individual selection

Step 2: Run Scoring

1. Click "Score Leads"
2. Wait for AI processing
3. Review results

Step 3: Apply Results

Scores are saved to contacts:

{
  contact: {
    // ... existing data
    aiScore: 87,
    aiSegment: "hot_lead",
    aiReasoning: "Professional profile...",
    aiScoredAt: 1704067200000,
  }
}

Filtering by Score

After scoring, filter contacts:

All Contacts → Filter: Hot Leads (80+) → 47 contacts
                Filter: Warm Leads (50-79) → 124 contacts
                Filter: Cold Leads (0-49) → 329 contacts

AI Message Generator

How It Works

Generate multiple message variations optimized for your campaign goals.

Campaign Goal + Tone + Audience → AI Generation → 3 Variations → Select Best

Configuration Options

Campaign Goal

Goal	Description	Example Use
Generate Interest	Spark curiosity	Product launches
Offer Product	Direct sales pitch	Promotions
Invite Community	Group invitations	Community building
Schedule Meeting	Request calls/meetings	B2B outreach
Request Feedback	Ask for opinions	Product research

Message Tone

Tone	Description	Best For
Professional	Formal, business-like	B2B, enterprises
Casual	Relaxed, friendly	Communities
Direct	Clear, to the point	Time-sensitive offers
Enthusiastic	Energetic, excited	Product launches
Friendly	Warm, personable	Relationship building

Additional Options

{
  audience: "Marketing professionals aged 25-45",
  context: "Launching new analytics tool for marketers",
  includeEmojis: true,
}

Generated Output

Each variation includes:

{
  variation: 1,
  text: "Hey! 👋 I noticed you're in marketing...",
  hook: "Hey! 👋",
  metrics: {
    engagementScore: 78,
    spamRisk: "low",
    estimatedReadTime: "12 seconds"
  }
}

Using Message Generator

Step 1: Configure Parameters

1. Select campaign goal
2. Choose tone
3. Describe target audience
4. Add context (optional)

Step 2: Generate

1. Click "Generate Messages"
2. Wait for AI processing (5-10 seconds)
3. Review 3 variations

Step 3: Select and Use

1. Compare engagement scores
2. Check spam risk levels
3. Copy preferred variation
4. Use in campaign

Message Quality Metrics

Metric	Description	Good Value
Engagement Score	Likely response rate	70+
Spam Risk	Chance of being flagged	Low
Clarity Score	Message readability	80+

AI Message Optimizer

How It Works

Analyze and improve your existing messages.

Your Message → AI Analysis → Suggestions → Improved Version

Analysis Provided

{
  originalMessage: "Hi, I sell marketing tools...",
  analysis: {
    engagementScore: 45,
    spamRisk: "medium",
    clarityScore: 62,
    issues: [
      "Starts with sales pitch (spam trigger)",
      "Lacks personalization",
      "No clear call-to-action"
    ],
    suggestions: [
      "Open with value proposition, not sales",
      "Add personalized element",
      "Include specific call-to-action"
    ]
  },
  improvedVersion: "I noticed you're in digital marketing..."
}

Using Message Optimizer

1. Enter your message
2. Click "Analyze"
3. Review issues and suggestions
4. Get improved version
5. Copy or modify further

AI Usage & Limits

Usage Limits

Each AI feature has its own daily limit based on your plan:

Plan	Lead Scoring	Message Generation	Message Optimization
Free	5/day	5/day	5/day
Starter	50/day	50/day	50/day
Pro	200/day	200/day	200/day
Business	1,000/day	1,000/day	1,000/day

Lead scoring counts per lead processed. Message generation and optimization count per request.

Usage Dashboard

Track your AI usage:

┌─────────────────────────────────────────┐
│ AI Usage Dashboard                       │
├─────────────────────────────────────────┤
│ Your Plan: Pro                          │
│                                         │
│ Today's Usage                           │
│ Lead Scoring:  ████████░░░░ 80/200     │
│ Message Gen:   ███░░░░░░░░░ 30/200     │
│ Optimization:  █░░░░░░░░░░░ 12/200     │
│                                         │
│ Resets in: 14 hours                     │
└─────────────────────────────────────────┘

Managing Usage

• Lead Scoring: Score in batches, not individually
• Message Gen: Generate once, modify manually
• Optimization: Optimize final drafts only

Best Practices

Lead Scoring Strategy

1. Score all contacts after initial scrape
2. Prioritize hot leads for immediate outreach
3. Batch cold leads for later nurturing
4. Re-score periodically as profiles update

Day 1: Scrape 500 → Score all → 45 hot, 180 warm, 275 cold
Day 2: Campaign to hot leads
Day 3-5: Campaign to warm leads
Future: Nurture cold leads

Message Generation Tips

1. Be specific in audience description
2. Provide context about your offer
3. Test variations with small groups
4. Combine AI + personal touch

Optimization Workflow

Draft Message → AI Optimize → Manual Review → Final Edit → Test Send

Integration with Campaigns

AI-Enhanced Campaign Flow

1. Scrape members from target group
2. Score all leads with AI
3. Filter for hot and warm leads
4. Generate message variations
5. Optimize your final message
6. Send to prioritized list

Example Campaign

Source: Marketing Professionals Group (2,000 members)
↓
Scrape: 500 members extracted
↓
AI Score: 45 hot, 180 warm, 275 cold
↓
Target: 45 hot leads
↓
AI Message: 3 variations generated
↓
Selection: Variation 2 (engagement: 82)
↓
Campaign: Send to 45 hot leads
↓
Result: 38% response rate

Error Handling

Rate Limit Errors

{
  error: "RateLimitError",
  message: "Daily limit reached",
  limit: 200,
  used: 200,
  resetIn: "14 hours"
}

Solution: Wait for reset or upgrade plan

API Errors

{
  error: "APIError",
  message: "Service temporarily unavailable",
  retry: true
}

Solution: Wait and retry

Technical Details

API Integration

AI features connect to TeleSender backend:

// Endpoint structure
POST /api/ai/score-leads
POST /api/ai/generate-messages
POST /api/ai/optimize-message
GET  /api/ai/usage

Request Format

// Score leads request
{
  users: [
    {
      id: "123456789",
      username: "john_doe",
      firstName: "John",
      bio: "Marketing professional"
    }
  ]
}

Response Format

// Score leads response
{
  results: [
    {
      userId: "123456789",
      score: 85,
      segment: "hot_lead",
      reasoning: "..."
    }
  ],
  usage: {
    used: 1,
    remaining: 199
  }
}

---

Quick Reference

Feature	Use For	Requests Used
Lead Scorer	Prioritizing contacts	1 per batch
Message Gen	Creating content	1 per generation
Optimizer	Improving messages	1 per analysis

---

Next: Learn about Integrations →