> ## 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.

# Leads beta

# Leads Beta

The Leads Beta module provides an enhanced lead management experience with advanced filtering, bulk operations, and improved performance.

## Overview

Leads Beta is the modern interface for managing your Telegram contacts and leads. It offers enhanced performance, advanced filtering capabilities, and a streamlined user experience.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/raysium/leads/placeholder-leads-beta.png" alt="Leads Beta Interface" />

## Key Features

### Advanced Filtering System

The Beta interface provides powerful filtering options:

* **Status Filter**: Filter by lead status (New, Contacted, Qualified, Lost, etc.)
* **Source Filter**: Filter by lead source (Manual, Crawling, File Upload)
* **Priority Filter**: Filter by priority (Low, Normal, High, Urgent)
* **Custom Fields**: Filter by any custom field
* **Segment Filter**: Filter by segment membership

### Saved Views

Save your filter configurations for quick access:

* Create custom views with specific filters
* Name views for easy identification
* Toggle between saved views instantly
* Share views with organization members

### Bulk Operations

Perform actions on multiple leads at once:

* **Bulk Delete**: Remove multiple leads
* **Bulk Update**: Update status, priority, group, country, language
* **Bulk Tag**: Add or remove tags
* **Export**: Export selected leads to CSV

### Column Customization

Customize your table view:

* Resizable columns
* Reorder columns via drag-and-drop
* Show/hide columns
* Save column configurations

### Pagination Options

Configure your view preferences:

* 50 leads per page
* 100 leads per page
* 500 leads per page
* 1000 leads per page

## Lead Management

### Adding Leads

Add leads through multiple methods:

* **Manual Entry**: Add leads one by one
* **CSV Import**: Import leads from CSV/Excel files
* **Group Crawling**: Extract leads from Telegram groups
* **API Integration**: Programmatic lead addition

### Lead Fields

Standard lead fields include:

| Field         | Description                                   |
| ------------- | --------------------------------------------- |
| Username      | Telegram username (without @)                 |
| Phone Number  | Contact phone number                          |
| First Name    | Lead's first name                             |
| Last Name     | Lead's last name                              |
| Email         | Email address                                 |
| Status        | Lead status (new, contacted, qualified, etc.) |
| Priority      | Lead priority (low, normal, high, urgent)     |
| Source        | Lead source (manual, crawling, file\_upload)  |
| Country       | Country location                              |
| Language      | Preferred language                            |
| Tags          | Custom tags for organization                  |
| Custom Fields | User-defined custom fields                    |

### Quick Actions

From the leads table, perform quick actions:

* Open Telegram chat directly
* Refresh lead data
* Edit lead information
* Delete leads

## Custom Fields Integration

Leads Beta fully supports custom fields:

* Text fields
* Email fields
* URL fields
* Phone fields
* Dropdown fields
* Multi-select fields
* Boolean/checkbox fields
* Number fields
* Date fields
* DateTime fields

## Segments Integration

Leads Beta integrates with the Segments module:

* View which segments a lead belongs to
* Filter leads by segment
* Dynamic segment membership updates

## API Endpoints

```http theme={null}
GET    /leads-beta/query          - Query leads with filters
POST   /leads-beta/bulk/delete    - Bulk delete leads
POST   /leads-beta/bulk/update    - Bulk update leads
GET    /leads-beta/config/views   - Get saved views
POST   /leads-beta/config/views   - Save view configuration
```

## Lead Statuses

| Status       | Description              |
| ------------ | ------------------------ |
| New          | Newly added lead         |
| Contacted    | Lead has been contacted  |
| Qualified    | Lead is qualified        |
| Lost         | Lead is lost             |
| Bad Data     | Lead has invalid data    |
| Blocked      | Lead blocked the account |
| Unsubscribed | Lead opted out           |

## Best Practices

1. **Regular Cleanup**: Periodically clean up bad data leads
2. **Use Tags**: Organize leads with consistent tagging
3. **Segment Strategically**: Create segments for different audience groups
4. **Monitor Sources**: Track which sources generate the best leads
5. **Custom Fields**: Use custom fields to capture important lead data