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.

The command reports the start and end of the mailing, and after completion generates a report in CSV format with a list of recipients and message delivery status.

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
  • Detailed mailing report with recipient statuses
  • 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 message to all users with specified label.

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 onboarding (creates template and places first message in it)
  3. Send another message in General: "Within an hour we will send you detailed information."
  4. Reply to it: /send onboarding 5m (add second message to template, which will automatically be sent 5 minutes after the first)
  5. Send PDF with catalog and note in General
  6. Reply to it: /send onboarding 1h (add third message to template, which will automatically be sent 1 hour after the second)

Now template onboarding contains three messages with specified intervals, and can be used in user topics with /send onboarding command or sent to all users in General topic with /send all onboarding command

Mailing by Label

If you need to send saved template special_offer only to customers with label vip: 

/send mark vip template special_offer

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_id]

Send to all users with whom there was dialog: 

/send all [now,delay,datetime] [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_id]

Send to users from list separated by commas: 

/send list [now,delay,datetime] [instance_id] USER_ID1,USER_ID2

Send to all users with specified label: 

/send mark MARK_NAME [now,delay,datetime] [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_NAME [now,delay,datetime]

Creating message chain

  1. Send first message and reply to it: /send welcome
  2. Send second message and reply to it: /send welcome 5m
  3. Send third message and reply to it: /send welcome 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_NAME [now,delay,datetime] [instance_id]

Send template to all users: 

/send all TEMPLATE_NAME [now,delay,datetime] [instance_id]

Send template to users from file: 

/send file TEMPLATE_NAME [now,delay,datetime] [instance_id]

Send template to users from list: 

/send list TEMPLATE_NAME [now,delay,datetime] [instance_id] USER_IDS

Send template to all users with label: 

/send mark MARK_NAME template TEMPLATE_NAME [now,delay,datetime] [instance_id]

Viewing information

Show all created templates: 

/send templates

Show recent mailings: 

/send sendings [instance_id]

Show template properties: 

/send TEMPLATE_NAME

Show mailing status and report: 

/send sidSENDING_ID

Editing and deleting

Rename template: 

/send TEMPLATE_NAME name NEW_NAME

Change message sending time in template: 

/send TEMPLATE_NAME for MESSAGE_ID [now,delay,datetime]

Delete message from template: 

/send TEMPLATE_NAME del MESSAGE_ID

Delete template completely: 

/send 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 sending time in parameter [now,delay,datetime]:

Format Description Example
now Send immediately (default) now
Delay Delayed sending 5m 30s, 5m, 2h, 1d
Date and time Fixed time in UTC 2024-12-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_id

With multiple connections in one backend group, you can specify instance_id to execute command for specific connection.

Default behavior

Without specifying instance_id, command is executed independently for each connection in backend group.

Quick Help

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