# Spammer

The Spammer module sends direct messages to Telegram users. It supports text, photo, voice, and video messages with spintax (random text variations). Recipients can be loaded from an Audience Parser XLSX file or entered manually.

![Spammer settings (top)](/files/tYV8P9GrKe3JTD1mrUlX)

![Spammer settings (bottom)](/files/zyuSrdnYbetbi2ghMcwc)

## Settings Reference

### Audience

| Setting              | Description                                                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Source**           | Where to get the list of recipients: **From Parser (XLSX)** = use an Excel file from the [Audience Parser](/mvs-docs/modules/audience-parser.md), or **Manual Input** = type recipients directly. |
| **Threads**          | How many accounts to use for sending at the same time. Default: 1. Max: 10.                                                                                                                       |
| **Msgs per Account** | Maximum number of messages each account will send before switching to the next account. Default: 50.                                                                                              |

### Parser Results

| Setting       | Description                                                                         |
| ------------- | ----------------------------------------------------------------------------------- |
| **XLSX File** | Path to the Audience Parser output file. Only visible when Source is "From Parser". |

### Recipients

| Setting        | Description                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Recipients** | Enter recipients manually, one per line. Accepts @usernames and phone numbers. Only visible when Source is "Manual Input". |

### Delays

| Setting             | Description                                                                                  |
| ------------------- | -------------------------------------------------------------------------------------------- |
| **Delay Min (sec)** | Minimum delay between messages. Default: 30.                                                 |
| **Delay Max (sec)** | Maximum delay between messages. Default: 60. The actual delay is random between min and max. |

{% hint style="warning" %}
**Use realistic delays** (30-60 seconds or more) to reduce the risk of spam restrictions on your accounts.
{% endhint %}

### Message

| Setting        | Description                                                                                                                                    |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| **Type**       | Message type: **Text**, **Photo**, **Voice**, or **Video**.                                                                                    |
| **Message**    | The message text. Supports Markdown formatting and spintax. Separate multiple message variants with `-----` (five dashes) on a line by itself. |
| **Media File** | Path to the media file (photo/voice/video). Only visible when type is not Text.                                                                |

#### Spintax Example

Spintax lets you create message variations automatically:

```
{Hello|Hi|Hey} {friend|there}! {Check out|Take a look at} our {channel|group}.
```

This will randomly produce messages like "Hello friend! Check out our channel." or "Hi there! Take a look at our group."

## How to Use

1. Go to **Spammer** in the sidebar
2. Choose the **Source** (Parser XLSX or Manual)
3. Provide recipients (XLSX path or manual list)
4. Set **Threads** and **Msgs per Account**
5. Configure **Delays** (higher = safer)
6. Write your **Message** with optional spintax
7. Select a **Proxy list**
8. In the **Accounts** section, select accounts to use for sending
9. Click **Start**

## Understanding the Results

The spammer creates a report Excel file in `data/results/spammer/` with three sheets:

| Sheet        | Content                                                              |
| ------------ | -------------------------------------------------------------------- |
| **Accounts** | Per-account stats: phone, sent count, failed count, status, duration |
| **Details**  | Per-recipient details: recipient, result, error                      |
| **Summary**  | Totals: total sent, total failed, accounts used                      |

If you used a Parser XLSX file, processed recipients are automatically marked as "sent" in the original XLSX.

{% hint style="info" %}
If an account dies or gets restricted mid-batch, the remaining recipients are automatically re-queued and sent from the next available account.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mvs-3.gitbook.io/mvs-docs/modules/spammer.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.