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

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

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

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

Команда сообщает о старте и окончании рассылки, после окончания работы формируется отчет в формате csv со списком получателей и статусом доставки сообщения.

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

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

Простое тестирование рассылок перед отправкой
Рассылка приватных сообщений пользователям или по чатам
Отправка одиночных сообщений любых типов и цепочек сообщений
Создание и использование шаблонов рассылок
Гибкая настройка времени отправки
Разные варианты задания списка получателей
Детальный отчет о рассылке со статусами получателей
Текущая скорость рассылки около 1000 сообщений в минуту
В случае ошибки при выполнении рассылки, она автоматически стартует с места остановки через 2 минуты

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

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

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

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

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

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

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

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

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

Опция mark отправляет сообщение всем пользователям с указанной меткой.

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

Быстрая отправка уведомления¶

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

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

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

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

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

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

Рассылка по метке¶

Если нужно отправить сохраненный шаблон special_offer только клиентам с меткой vip:

/send mark vip template special_offer

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

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

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

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

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

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

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

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

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

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

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

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

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

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

/send test [now,delay,datetime] [instance_id]

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

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

Отправить пользователям из прикрепленного файла (список user_id может быть разделен запятыми, пробелами или новой строкой):

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

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

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

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

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

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

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

/send TEMPLATE_NAME [now,delay,datetime]

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

/send templates

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

/send sendings [instance_id]

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

/send TEMPLATE_NAME

Показать статус и отчет рассылки:

/send sidSENDING_ID

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

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

/send TEMPLATE_NAME name NEW_NAME

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

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

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

/send TEMPLATE_NAME del MESSAGE_ID

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

/send 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`
Задержка	Отложенная отправка	`5m 30s`, `5m`, `2h`, `1d`
Дата и время	Фиксированное время по UTC	`2024-12-27 14:25:55`

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

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

Параметр `instance_id`¶

При множественных подключениях в одну бекенд-группу можно указать instance_id для выполнения команды для конкретного подключения.

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

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

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

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

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