Skip to content

Mass Mailings /send

The /send command allows you to send individual messages or message chains to customers through the mailing system. All main Telegram message types are supported: text, stickers, voice, video, images, files.

How It Works

Configuration and launch of mass mailings is done in the General topic using the /send command. In dialog topics, the command can also be used by operators, but only to send a pre-prepared template to the corresponding user or chat.

After launch, the command reports the start of the mailing in the General topic. When it finishes, a brief summary appears there, while a detailed CSV report with the recipient list and delivery statuses is sent to the operator who ran the command in a private chat with the setup bot.

Before your first mailing, start the setup bot or send it any message. If the bot is blocked or has not been started, a report delivery error appears in General. After starting the bot, you can request the report again with /send sidSENDING_ID report.

Messages from mailings are not displayed in topics to avoid disrupting topic chronology and not exceed available Telegram limits for message delivery to groups with a large number of recipients.

Main Features

  • Easy testing of mailings before sending
  • Mailing private messages to users or to chats
  • Sending single messages of any types and message chains
  • Creating and using mailing templates
  • Flexible time settings
  • Different ways to specify recipient lists
  • Recipient selection by multiple labels and exclusion of specific segments
  • Detailed CSV report with recipient statuses via the setup bot
  • Current mailing speed about 1000 messages per minute
  • In case of error during mailing execution, it automatically restarts from the stopping point in 2 minutes

Mailings from accounts can lead to ban

With mass mailings from user accounts, there is a high risk of getting a temporary ban from Telegram if any of the recipients marks your message as spam. You can check for account restrictions via @spambot

There is no such risk with bot mailings, but users can stop receiving messages from the bot at any time.

Recipient Options

  • Test Sending

    Option test sends message only to you for checking before mass mailing.

  • All Users

    Option all sends message to everyone who had a dialog through Hotline.

  • List from File

    Option file uses attached file with list of recipient user_id.

  • List in Command

    Option list accepts list of user_id directly in command separated by commas.

  • By Labels

    Option mark sends the message to users with at least one of the specified labels. The exclude parameter excludes users with any label listed after it.

Usage Examples

Quick Notification Sending

  1. In General topic send message: "Dear customers! We have a new promotion on our website, don't miss it!"
  2. Reply to it with command: /send test (will send test message to operator)
  3. Check how the message looks (it will come from connected bot or account)
  4. Send to all: /send all (as reply to the same message)

Usage idea

This way you can quickly send video notes or voice messages to bot audience, improving user engagement.

Creating Template with Chain

  1. In General topic send message: "Hello! Thank you for your interest in our services."
  2. Reply to it with command: /send template onboarding (creates the template and adds the first message to it)
  3. Send another message in General: "Within an hour we will send you detailed information."
  4. Reply to it: /send template onboarding delay 5m (adds the second message to the template; it will be sent automatically 5 minutes after the first)
  5. Send PDF with catalog and note in General
  6. Reply to it: /send template onboarding delay 1h (adds the third message to the template; it will be sent automatically 1 hour after the second)

The onboarding template now contains three messages with the specified intervals. You can use it in user topics with /send onboarding or send it to all users from the General topic with /send all template onboarding.

Mailing by Label

To send the saved special_offer template to customers with the vip or lead label while excluding customers with the blocked label: 

/send mark vip,lead template special_offer exclude blocked

Multiple included labels use OR logic: a recipient is included if they have at least one of them. exclude always removes a dialog if it has at least one of the labels listed after it.

Checking deleted topics

Before a mass mailing, run /sync N deleted, where N is the number of dialogs to check. This removes already deleted topics from the active database and prevents attempts to send messages to them.

Mailing Limits

System Version Messages per Month Limit
Free 500
Paid from 4000 on minimum plan (all plans)

Expanding limits

To increase standard limits, contact support service.

Access Restriction

By default, functions for configuration and launch of mailings are only available to connections administrators. Access can be extended via EXTENSIONS_ALLOWED parameter.

Command /send in topics

Operators can use /send command in topics even without administrative access.

Calling the Command

Command /send works differently depending on where it's called!

In General Topic (with reply to message)

Used to send specific message or create template.

Sending message

Send to yourself for testing: 

/send test [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send to all users with whom there was dialog: 

/send all [now | delay ... | datetime ...] [instance INSTANCE_ID]
Send to users from attached file (list of user_id can be separated by commas, spaces or newline): 
/send file [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send to users from list separated by commas: 

/send list CHAT_ID1,CHAT_ID2 [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send to users with any of the specified labels: 

/send mark MARK1,MARK2 [now | delay ... | datetime ...] [instance INSTANCE_ID]

Creating template

Add message to new or existing template (template name must start with Latin letter, can contain numbers, hyphen or underscore):

/send template TEMPLATE_NAME [now | delay ... | datetime ...]

Creating message chain

  1. Send the first message and reply to it: /send template welcome
  2. Send the second message and reply to it: /send template welcome delay 5m
  3. Send the third message and reply to it: /send template welcome delay 1h

Result: template welcome will contain three messages. First will be sent immediately, second — 5 minutes after first, third — 1 hour after second.

In General Topic (without reply)

Used to launch mass mailings, manage templates and mailings.

Sending template

Send template to yourself for testing: 

/send test template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send template to all users: 

/send all template TEMPLATE_NAME [exclude MARK1,MARK2] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send template to users from file: 

/send file template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send template to users from list: 

/send list CHAT_ID1,CHAT_ID2 template TEMPLATE_NAME [now | delay ... | datetime ...] [instance INSTANCE_ID]

Send template to users with any of the specified labels except the excluded ones: 

/send mark MARK1,MARK2 template TEMPLATE_NAME [exclude MARK3,MARK4] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Viewing information

Show all created templates: 

/send templates

Show recent mailings: 

/send sendings [instance INSTANCE_ID]

Show template properties: 

/send template TEMPLATE_NAME

Show mailing status and brief summary: 

/send sidSENDING_ID

Receive the detailed CSV report in a private chat with the setup bot: 

/send sidSENDING_ID report

Editing and deleting

Rename template: 

/send template TEMPLATE_NAME name NEW_NAME

Change message sending time in template: 

/send template TEMPLATE_NAME for MESSAGE_ID [now | delay ... | datetime ...]

Delete message from template: 

/send template TEMPLATE_NAME del MESSAGE_ID

Delete template completely: 

/send template TEMPLATE_NAME del

Cancel mailing (only if it's in awaits status): 

/send sidSENDING_ID del

In Dialog Topic (without reply)

Used to send template to specific user or chat.

Sending template

Send template to user of this topic: 

/send TEMPLATE_NAME [now | delay ... | datetime ...]

Show available templates: 

/send templates

Show sendings for this topic: 

/send sendings

Show sending status (without report): 

/send sidSENDING_ID

Time Settings

For each message, you can specify the sending time with [now | delay ... | datetime ...]:

Format Description Example
now Send immediately (default) now
delay Delayed sending delay 5m 30s, delay 2h, delay 1d
datetime Fixed time in UTC datetime 2026-07-27 14:25:55

Message chains

In templates with multiple messages, delay is counted from the moment of sending the previous message in the chain.

Parameter instance

With multiple connections in one backend group, you can add instance INSTANCE_ID to the end of the command to execute it only for a specific connection.

Default behavior

Without the instance INSTANCE_ID parameter, the command is executed independently for each connection in the backend group.

Quick Help

Send command /send or /send help in any context to get brief help in English.