Документация / Рассылки
Рассылки и сегменты
Рассылка отправляет одно сообщение сразу многим подписчикам — по желанию с фильтром по сегменту, по желанию в будущий момент времени. Откройте бота в консоли и выберите Рассылки.
Сегменты
Сегмент — это сохранённый фильтр по аудитории бота, построенный на основе атрибутов, собираемых вашими сценариями (через узлы «Установить атрибут» и «Вопрос»), дат подписки и активности. Сегменты можно использовать повторно: создайте один раз, применяйте в каждой кампании, а состав автоматически пересчитывается по мере изменения подписчиков.
Сегменты также лежат в основе узла «Сегмент» в сценариях, поэтому подписчик, попадающий в сегмент, может запустить автоматизацию — приветственную серию для новых подписчиков или сценарий возврата для неактивных.
Ещё нет сегментов? Рассылка без сегмента просто отправляется всей аудитории этого бота.
Создание и планирование
Рассылка состоит из названия, сообщения (текст с необязательными кнопками — кнопка со ссылкой отлично подходит как призыв к действию) и необязательного сегмента. Отправьте её немедленно или запланируйте на конкретное время — это полезно для часовых поясов и запусков. Запланированные рассылки остаются в списке с указанием времени отправки, пока не наступит нужный момент.
Каждая линейка включает месячный лимит рассылок (указан на странице тарифов и в индикаторах использования на странице оплаты); отправки сверх лимита отклоняются с понятным сообщением, а не проваливаются молча.
Как регулируется скорость доставки
Telegram ограничивает массовую отправку примерно 30 сообщениями в секунду. Meshwire ставит по одной строке доставки на каждого получателя в очередь и обрабатывает её фоновыми проходами со скоростью 25 сообщений в секунду — с запасом ниже предела — обрабатывая не более 200 получателей на кампанию за один проход, чтобы одна гигантская кампания не забирала ресурсы у остальных. Когда Telegram отвечает «сбавьте скорость», проход немедленно останавливается и возобновляется на следующем такте точно с того места, где остановился: никто не пропускается, никому не отправляется дважды.
Как читать результаты
| Результат | Значение |
|---|---|
| Доставлено | Telegram принял сообщение для этого подписчика. |
| Заблокировано | Подписчик заблокировал бота, удалил свой аккаунт, или чат больше не существует. Он автоматически исключается из будущих рассылок. |
| Ошибка | Временная ошибка — будет повторена в последующих проходах. Если Telegram сообщает, что кампания идёт слишком быстро, отправка приостанавливается и возобновляется в безопасном темпе, вместо того чтобы кого-то пропустить. |
Статус рассылки переходит из состояния в очереди в отправляется и далее в завершено (или ошибка , если ничего не удалось доставить). Счётчики по каждому проходу обновляются по мере доставки, и событие broadcast.completed отправляется на ваши вебхуки с итоговой статистикой.