> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reach.raysium.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Warmup accounts

# Warmup Accounts

The Warmup Accounts module helps new Telegram accounts build reputation safely through gradual activity increases.

## Overview

Account warming is essential for new Telegram accounts to avoid detection as bots. The warmup system gradually increases account activity over time to establish a natural usage pattern.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/raysium/accounts/placeholder-warmup-dashboard.png" alt="Warmup Dashboard" />

## How It Works

### Warmup Roadmaps

Two warmup strategies available:

| Roadmap  | Duration | Description                                    |
| -------- | -------- | ---------------------------------------------- |
| Standard | 30 days  | Gradual activity increase for long-term health |
| Fast     | 15 days  | Aggressive warmup for quicker readiness        |

### Warmup Phases (Standard 30-Day)

| Phase          | Days       | Daily Limit | Activities                      |
| -------------- | ---------- | ----------- | ------------------------------- |
| Onboarding     | Day 0      | 0           | AI generates bio & username     |
| Ghost Mode     | Days 1-3   | 0           | Passive activity, join channels |
| Incubation     | Days 4-7   | 15          | Internal org chat               |
| Socializing    | Days 8-14  | 35          | Org + global pool chats         |
| Trust Building | Days 15-21 | 60          | Deep conversations              |
| Normalization  | Days 22-30 | 100         | Full activity mode              |

## Starting Warmup

### Onboarding Process

1. Navigate to **Accounts** → **Warmup**
2. Click **Start Warmup** for an account
3. Complete the onboarding wizard:

#### Step 1: Persona

* Define account persona (e.g., "SDR at tech company")
* This helps AI generate appropriate messages

#### Step 2: Settings

* Choose roadmap (Standard/Fast)
* Set timezone (for sleep scheduling)
* Enable/disable global pool
* Configure auto-delete history
* Enable/disable night mode

#### Step 3: Review

* Review warmup plan
* Confirm start

<img src="https://mintlify.s3.us-west-1.amazonaws.com/raysium/accounts/placeholder-warmup-onboarding.png" alt="Warmup Onboarding" />

## Warmup Pools

### Organization Pool

Accounts chat with other accounts in your organization:

* Automatically enabled when warmup starts
* Safe, controlled environment
* Build internal communication

### Global Pool

Accounts chat with verified external accounts:

* Opt-in during onboarding or later
* Broader conversation diversity
* Partner accounts from other organizations

### Pool Configuration

Toggle pools per account:

```http theme={null}
POST /warmup/global-pool/{account_id}
```

## Bidirectional Interactions

### How It Works

The warmup system ensures natural two-way conversations:

1. **When Account A sends to Account B**:
   * Creates pending response for Account B
   * Account B gets priority in worker queue
   * Must respond within 1-5 minutes

2. **Response Delays** (Human-like):
   * **Fast (60%)**: 10 seconds - 3 minutes
   * **Slow (30%)**: 10 minutes - 1 hour
   * **Ghosting (10%)**: 4-8 hours

3. **Turn Alternation**:
   * No double-sending without response
   * Tracks pending responders
   * Conversation depth targets

### Credit System

Both sender and receiver get warmup credit:

* Sender: Message sent credit
* Receiver: Response credit
* Encourages bidirectional engagement

## Warmup Status

### Status Types

| Status    | Description           |
| --------- | --------------------- |
| Inactive  | Not in warmup         |
| Queued    | Waiting to start      |
| Warming   | Currently in warmup   |
| Paused    | Temporarily paused    |
| Cooldown  | Between warmup cycles |
| Graduated | Completed warmup      |
| Failed    | Warmup failed         |

### Status Indicators

Visual indicators show current status:

* **Active**: Green indicator
* **Sleeping**: Blue indicator
* **Cooldown**: Yellow indicator
* **Paused**: Gray indicator

## Managing Warmup

### Pause Warmup

Emergency pause if issues detected:

1. Click pause on account card
2. Warmup pauses immediately
3. Can resume when ready

### Resume Warmup

Resume paused warmup:

1. Click resume on account card
2. Warmup continues from paused state

### Stop Warmup

Stop warmup completely:

1. Navigate to account warmup
2. Click stop/delete
3. Warmup data is cleaned up

## Night Mode

### Configuration

Night mode respects local sleep hours:

* Activity pauses during local midnight to 7 AM
* Resumes automatically after sleep hours
* More natural account behavior

### Timezone Settings

Set account timezone during onboarding:

* Determines sleep hours
* Activity scheduled around timezone

## AI Message Generation

### How It Works

AI generates human-like messages:

* Uses persona context
* Avoids spam/crypto keywords
* Generates contextual responses
* Supports burst messaging

### Safety Filters

Messages are filtered for:

* No spam content
* No crypto/scams
* No prohibited topics
* Natural language patterns

## Statistics

### Tracked Metrics

| Metric              | Description                   |
| ------------------- | ----------------------------- |
| Total Messages Sent | Cumulative messages           |
| Total Conversations | Conversations started         |
| Average Depth       | Avg messages per conversation |
| Daily Limits        | Current phase limits          |
| Error Count         | Errors encountered            |

### Daily Logs

Track daily progress:

* Messages per day
* Conversations started
* Phase progress
* Errors/failures

## Best Practices

1. **Start Early**: Begin warmup for new accounts immediately
2. **Be Patient**: Follow the full roadmap for best results
3. **Use Both Pools**: Enable both org and global pools
4. **Monitor Status**: Watch for errors or issues
5. **Enable Night Mode**: Respect natural sleep patterns
6. **Graduated = Ready**: Only use accounts after graduation