Перейти к содержанию

Массовые рассылки /send

Команда /send позволяет отправлять отдельные сообщения или цепочки сообщений клиентам через систему рассылок. Поддерживаются все основные типы сообщений Telegram: текст, стикеры, голосовые, видео, изображения, файлы.

Принцип работы

Конфигурация и запуск массовых рассылок производится в топике General с помощью команды /send. В топиках с диалогами команда также может быть применена операторами, но только для отправки заранее заготовленого шаблона соответствующему пользователю или в чат.

После запуска команда сообщает о начале рассылки в топике General. По завершении там появляется краткая сводка, а подробный CSV-отчёт со списком получателей и статусами доставки отправляется вызвавшему команду оператору в личный чат с сетап-ботом.

Перед первой рассылкой запустите сетап-бота или отправьте ему любое сообщение. Если бот заблокирован или ещё не запущен, в General появится ошибка доставки отчёта. После запуска бота отчёт можно запросить повторно командой /send sidSENDING_ID report.

В топиках сообщения рассылки не отображаются, чтобы не сбивать хронологию топиков и не превышать доступные лимиты Телеграм на доставку сообщений в группы при большом числе получателей.

Основные возможности

  • Простое тестирование рассылок перед отправкой
  • Рассылка приватных сообщений пользователям или по чатам
  • Отправка одиночных сообщений любых типов и цепочек сообщений
  • Создание и использование шаблонов рассылок
  • Гибкая настройка времени отправки
  • Разные варианты задания списка получателей
  • Выбор получателей по нескольким меткам и исключение отдельных сегментов
  • Детальный CSV-отчёт со статусами получателей через сетап-бота
  • Автоматическая метка sid{SENDING_ID} для получателей после успешной доставки при включённом флаге automark
  • Текущая скорость рассылки около 1000 сообщений в минуту
  • В случае ошибки при выполнении рассылки, она автоматически стартует с места остановки через 2 минуты

Рассылки с аккаунтов могут привести к бану

При массовых рассылках с пользовательских аккаунтов есть большой риск получить временный бан от Телеграм, если кто-нибудь из получателей пометит ваше сообщение как спам. Проверить наличие ограничений на аккаунте можно через @spambot

При рассылках с ботов такого риска нет, но пользователи могут остановить получение сообщений от бота в любой момент.

Варианты получателей

  • Тестовая отправка

    Опция test отправляет сообщение только вам для проверки перед массовой рассылкой.

  • Все пользователи

    Опция all отправляет сообщение всем, с кем был диалог через Hotline.

  • Список из файла

    Опция file использует прикрепленный файл со списком user_id получателей.

  • Список в команде

    Опция list принимает список user_id прямо в команде через запятую.

  • По меткам

    Опция mark отправляет сообщение пользователям хотя бы с одной из указанных меток. Параметр exclude исключает пользователей с любой из перечисленных после него меток.

Примеры использования

Быстрая отправка сообщения всем контактам

  1. В топике General отправьте сообщение: "Уважаемые клиенты! У нас на сайте новая акция, не пропустите!"
  2. Ответьте на него командой: /send test (отправит тестовое ообщение оператору)
  3. Проверьте, как выглядит сообщение (оно придет от имени подключенного бота или аккаунта)
  4. Отправьте всем: /send all (ответом на то же сообщение)

Идея для использования

Подобным образом можно быстро отправлять аудитории бота кружки или голосовые, улучшая вовлечение пользователей.

Рассылка пользователям с указанными метками

Чтобы отправить сохранённый шаблон special_offer клиентам с меткой vip или lead, исключив клиентов с меткой blocked: 

/send mark vip,lead template special_offer exclude blocked

Несколько включающих меток работают по принципу ИЛИ: получатель попадёт в рассылку, если у него есть хотя бы одна из них. exclude всегда исключает диалог, если найдена хотя бы одна указанная после него метка.

Проверка удалённых топиков

Перед массовой рассылкой выполните /sync N deleted, где N — число проверяемых диалогов. Это исключит из активной базы уже удалённые топики и предотвратит попытки отправки в них.

Рассылка с автоматической меткой

Чтобы после успешной доставки каждому получателю автоматически поставилась метка sid{SENDING_ID} (удобно для сегментации, повторных рассылок и других операций с метками), добавьте флаг automark в любое место после подкоманды:

/send all automark

/send mark vip,lead automark

/send all template special_offer automark exclude blocked

Флаг работает с любыми режимами получателей (test, all, file, list, mark). В CSV-отчёте результат операции показывается в отдельной колонке automark.

Автоматически созданные и назначенные из рассылок метки не отображаются в названиях топиков (параметр ticker у этих меток по умолчанию пустой), но эти метки показываются при вызове команды /mark в топике.

Быстрая сегментация

Используйте automark, чтобы после рассылки быстро выделить аудиторию, которая точно получила сообщение, и обратиться к ней повторно — например, /send mark sid123456 template follow_up1.

Переименование автоматической метки

После окончания рассылки созданную автоматическую метку можно переименовать в более понятное и запоминаемое название командой /mark sid123456 name SOME_NEW_NAME в топике General.

Создание шаблона c цепочкой сообщений

  1. В топике General отправьте сообщение: "Здравствуйте! Спасибо за интерес к нашим услугам."
  2. Ответьте на него командой: /send template onboarding (создаёт шаблон и помещает в него первое сообщение)
  3. Отправьте в General еще одно сообщение: "В течение часа мы отправим вам подробную информацию."
  4. Ответьте на него: /send template onboarding delay 5m (добавляет к шаблону второе сообщение, которое автоматически отправится через 5 минут после первого)
  5. Отправьте в General PDF с каталогом и примечанием
  6. Ответьте на него: /send template onboarding delay 1h (добавляет к шаблону третье сообщение, которое автоматически отправится через 1 час после второго)

Теперь шаблон onboarding содержит три сообщения с заданными интервалами. Его можно использовать в топиках с пользователями командой /send onboarding или отправить всем пользователям в топике General командой /send all template onboarding.

Структура CSV-отчёта о рассылке

Подробный отчёт по рассылке приходит оператору вызвавшему команду в личный чат с сетап-ботом в формате CSV. В каждой строке — один получатель:

Колонка Описание
sending_id Идентификатор рассылки
user_id ID пользователя Telegram
chat_id ID чата/диалога
thread_id ID топика в бекенд-группе
message_id ID отправленного сообщения
status Статус доставки (sent, error, skipped и др.)
error_code Код ошибки, если доставка не удалась
attempts Количество попыток отправки
last_attempt_at Время последней попытки
automark При включённом флаге automark: added (метка поставлена), skipped (метка не поставлена — топик не найден или отправка не удалась) или краткая причина ошибки. Без automark колонка отсутствует.

Лимиты рассылок

Версия системы Лимит сообщений в месяц
Бесплатная 500
Платная от 4000 на минимальном тарифе (все тарифы)

Расширение лимитов

Для увеличения стандартных лимитов обратитесь в службу поддержки.

Ограничение доступа

По умолчанию функции конфигурации и запуска рассылок доступны только администраторам подключений. Расширить доступ можно через параметр EXTENSIONS_ALLOWED.

Команда /send в топиках

Операторы могут использовать команду /send в топиках даже без административного доступа.

Вызов команды

Команда /send работает по-разному в зависимости от места вызова!

В топике General (c reply на сообщение)

Используется для отправки конкретного сообщения или создания шаблона.

Отправка сообщения

Отправить себе для тестирования: 

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

Отправить всем пользователям, с которыми был диалог: 

/send all [automark] [now | delay ... | datetime ...] [instance INSTANCE_ID]
Отправить пользователям из прикрепленного файла (список user_id может быть разделен запятыми, пробелами или новой строкой): 
/send file [automark] [now | delay ... | datetime ...] [instance INSTANCE_ID]

Отправить пользователям из списка через запятую: 

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

Отправить пользователям с любой из указанных меток: 

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

Создание шаблона

Добавить сообщение в новый или существующий шаблон (имя шаблона должно начинаться с латинской буквы, может содержать цифры, дефис или подчеркивание):

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

Создание цепочки сообщений

  1. Отправьте первое сообщение и ответьте на него: /send template welcome
  2. Отправьте второе сообщение и ответьте на него: /send template welcome delay 5m
  3. Отправьте третье сообщение и ответьте на него: /send template welcome delay 1h

Результат: шаблон welcome будет содержать три сообщения. Первое отправится сразу, второе — через 5 минут после первого, третье — через 1 час после второго.

В топике General (без reply)

Используется для запуска массовых рассылок, управления шаблонами и рассылками.

Отправка шаблона

Отправить шаблон себе для тестирования: 

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

Отправить шаблон всем пользователям: 

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

Отправить шаблон пользователям из файла: 

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

Отправить шаблон пользователям из списка: 

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

Отправить шаблон пользователям с любой из указанных меток, кроме исключённых: 

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

Просмотр информации

Показать все созданные шаблоны: 

/send templates

Показать последние рассылки: 

/send sendings [instance INSTANCE_ID]

Показать свойства шаблона: 

/send template TEMPLATE_NAME

Показать статус и краткую сводку рассылки: 

/send sidSENDING_ID

Получить подробный CSV-отчёт в личном чате с сетап-ботом: 

/send sidSENDING_ID report

Редактирование и удаление

Переименовать шаблон: 

/send template TEMPLATE_NAME name NEW_NAME

Изменить время отправки сообщения в шаблоне: 

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

Удалить сообщение из шаблона: 

/send template TEMPLATE_NAME del MESSAGE_ID

Удалить шаблон полностью: 

/send template TEMPLATE_NAME del

Отменить рассылку (только если она в статусе awaits): 

/send sidSENDING_ID del

В топике с диалогом (без reply)

Используется для отправки шаблона конкретному пользователю или в чат.

Отправка шаблона

Отправить шаблон пользователю этого топика: 

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

Показать доступные шаблоны: 

/send templates

Показать отправки для этого топика: 

/send sendings

Показать статус отправки (без отчета): 

/send sidSENDING_ID

Настройка времени отправки

Для каждого сообщения можно указать время отправки в параметре [now | delay ... | datetime ...]:

Формат Описание Пример
now Отправка немедленно (по умолчанию) now
delay Отложенная отправка delay 5m 30s, delay 2h, delay 1d
datetime Фиксированное время по UTC datetime 2026-07-27 14:25:55

Цепочки сообщений

В шаблонах с несколькими сообщениями задержка отсчитывается от момента отправки предыдущего сообщения в цепочке.

Параметр instance

При множественных подключениях в одну бекенд-группу можно добавить instance INSTANCE_ID в конец команды, чтобы выполнить её только для конкретного подключения.

Поведение по умолчанию

Без параметра instance INSTANCE_ID команда выполняется независимо для каждого подключения в бекенд-группе.

Быстрая справка

Отправьте команду /send или /send help в любом контексте для получения краткой справки на английском языке.