Описание

BotManager - сервис позволяет выполнять рассылки по пользователям базы ваших собственных ботов.

Под этим мы подразумевает, что вы собрали собственную базу пользователей или чатов, которые запустили ваш бот: @examplebot

Бот позволяет создавать отложенные рассылки на аудиторию по множеству встроенных, а также сгруппированных вами параметров.

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

Сервис не ограничивает количество одновременно запускаемых рассылок;

История версий

Версия 2.0

• Полностью переработана архитектура проекта;
• Переработано главное меню, избавились от лишних кнопок;
• Локализация сервиса на английский язык;
• Добавлен мультипостинг позволяющий запускать до 10 постов автоматически распределяющихся между собой;
• Улучшена поддержка работы всех видов постов;
• Улучшена поддержка альбомов, для прикрепления альбомов больше не требуется переходить в раздел "Рекламный пост";
• Прием постов в любом форматирование: исходное, html, markdown;
• Посты с переменными больше не нужно преобразовывать в html для рассылки;
• Добавлен рандомайзер позволяющий создавать уникальные предложения или менять слова местами в предложение;
• Для переменных добавлена префикс _self при добавление данного префикса, переменная становиться кликабельной ссылкой на самого пользователя;
• В меню редактирования поста добавлена возможность заменить медиа, текст без замены всего поста;
• Добавлена возможность обновить ссылки в посте/клавиатуре;
• В клавиатуре допустимо использование | непосредственно в callback_data для этого экранируйте символ преобразовав его в || ;
• Добавлена возможность настройки размера и позиции превью в постах с предпросмотром;
• Добавлен раздел "Защита контента" при включение данного пункта: репост поста, захват экрана - запрещен;
• Добавлен раздел "Реакция" позволяющий установить одну из реакций на пост;
• Добавлена возможность рассылки репостом;
• Добавлена возможность выбора даты и времени из календаря, а также установки собственного времени;
• Добавлена возможность выбора получателей: пользователи/группы при использование API
• Добавлена возможность выбора сортировки БД: исходная, по ID, случайно, обратная сортировка;
• Возможность выбора рассылать на пользователей с telegram premium или нет;
• Возможность выбора рассылать на определенные языки;
• Возможность группировать пользователей на основе собственных тегов используемых в вашей бд или по удобному для вас ключу;
• Возможность ограничить количество получателей, а также отступить нужное количество;
• Возможность задать собственное значение скорости, а также использовать ли рекомендованный флудвейт и требуется ли автоматическая подстройка скорости;
• Переработана автоматическая подстройка скорости, теперь она работает как и должна - как в меньшую так и большую скорость при возможности расширения;
• Добавлена возможность задать собственное время на которое нужно закрепить рассылку, а также возможность не откреплять рассылку;
• Улучшено удаление рассылок в крупных ботах, а также добавлена возможность задать собственное время через которое нужно удалить рассылку;
• Удалить/открепить рассылку теперь можно в течение 48 часов после выполнения рассылки, для этого перейдите в задачу и задайте нужное значение;
• В разделах удаления/закрепления добавлен прогресс выполнения текущей операции;
• Буст-режим удален за ненадобностью;
• Возможность добавить список пользователей в оповещения, при начале рассылки получат уведомление и прогресс выполнения;
• Возможность добавить заметку у выбранного поста которую видите только вы;
• Возможность протестировать пост перед рассылкой;
• Раздел задачи переработан, теперь используется 4 раздела: в работе, запланированные, завершенные, остановленные;
• Добавлена возможность повторить выбранную задачу;
• Возможность посмотреть отчет рассылки у завершенной задачи из архива;
• Через календарь доступна возможность создавать рассылку на выбранную дату, напоминание, бронирование. Выбор времени для оповещения;
• Возможность синхронизировать данные календаря с botstat.io (пока недоступно на стороне сайта);
• Добавлена возможность группировать ботов по папкам для последующего пакетного выбора, включая определение папок по API;
• Возможность отсортировать боты/папки в нужной последовательности;
• Возможность задать параметры скорости по-умолчанию для определенного бота;
• База и токен, автоматически обновляются в рассылке при обновление ее в разделе "Мои боты" или по API, а также перед запуском самой задачи, за исключением случаев когда она добавлена вручную в разделе создания задачи;
• Добавлена история обновления БД по API;
• Добавлена поддержка Local Bot Api;
• Теперь требуется соглашения пользователя стать менеджером;
• Разграничение прав для менеджеров, вы можете сами определять разрешения вашего менеджера;
• Теперь менеджеры видят всех ботов в которых они назначены в разделе "Мои боты", соответствующая иконка указывает на то;
• При отсутствие рассылок на вашем балансе для запуска рассылки, менеджер может списать их со своего баланса;
• Возможность пополнить баланс на любое кол-во рассылок помимо основных пакетов;
• Переработан дизайн прогресса выполнения рассылки: добавлена кнопка для ручного обновление прогресса, кол-во флудов, время запроса;
• Добавлена возможность установить время для паузы, которая будет снята по истечению выбранного периода;
• Добавлена возможность выгрузить отчет в BotSafe по завершению рассылки, как публично, так и приватно;
• Возможность сформировать файл-отчет по различным параметрам, в форматах txt/json;
• Добавленно множество различных мелких улучшений и удобств;
• Пофиксили старые баги;
• Добавили новые баги 🤷‍♂️;

Внимание! Данные функции являются не прогнозируемыми и не гарантируют конечный результат удаления или открепления, ввиду того, что существует прямая зависимость от ответа предоставляемым самим Telegram. Используйте данные функции на свой страх и риск.

Суть проблемы заключается в том, что спустя время N-время, бот не видит отправленное сообщение и не может применить к нему данные операции, независимо есть ли допустимый лимит или нет. Особенно данная проблема заметка в крупных ботах, имеющий большой актив и получающих большое количество обновлений.

Максимально допустимое значение для данных действий 48 часов, НО при использование максимального значения конечный результат может быть не достигнут. Не рекомендуется использовать значение более 36 часов.

Автоудаление

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

Закрепление поста

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

Задание значения

Вы можете выбрать из предложенных нами или прислать собственное значение в формате: минуты:часы

Например:
0:30 - удалить/открепить через 30 минут
22:15 - удалить/открепить через 22 часа 15 минут

Допустимый интервал от 1 минуты до 48 часов. Отсчет начинается с момента доставки сообщения пользователю.

Отслеживать прогресс выполнения операции можно непосредственно в выбранном разделе.

• BotAPI - интерфейс для взаимодействия вашего ПО (бота) с серверами Telegram посредством http-запросов;
• Флуды - при большом количестве запросов к BotAPI, Telegram может возвращать ошибку связанную со слишком частым/большим количеством запросов, в данном случае требуется выждать время перед повторной отправкой запросов. Также в данном случае уменьшается скорость. Данное явления особенно заметно в больших ботах с высокой активностью, обрабатывающих большое количество запросов, обойти этот параметр нельзя;
• Флудвейт - время возникающее при появление флудов, которое требуется выждать перед повторной отправкой запросов;
• DC - дата-центр, грубоговоря "местоположение" вашего бота, от расположения дс, зависит скорость обработки запросов, а также количество флудвейтов;
• Скорость - скорость отправки запросов к BotAPI в секунду;
• Средняя скорость - во время рассылки скорость варьируется может изменяться как в большую так и в меньшую скорость в зависимости от множества фактором основным из которых является кол-во флудов;
• Время запроса - время за которое было установлено соединение и отправлен запрос к BotAPI. При стабильной работе Telegram значение должно быть меньше 1 сек. Если есть тенденция увеличения времени запроса, значит есть проблемы на стороне Telegram или конкретного DC. Ввиду того, что боты регистрируются на разных DC, время запросов в разных ботах может различаться. Также увеличенное время запроса может свидетельствовать о том, что запросы от вашего бота игнорируются Telegram ввиду появления флудов.

Общая информация

Скорость рассылок - не простая вещь, нельзя поставить большие значения и надеется, что рассылка гарантировано выполниться с такой скоростью.

BotManager умеет подстраивать пропускную скорость как в большую сторону, так и в меньшую.

На общую скорость влияет множество параметров, такие как DC, время суток, использование переменных, выбор рассылки на конкретные языки или проверка наналичие telegram premium, а также размера вашей базы получателей.

Чем больше параметров вы выбрали, тем меньшую скорость рассылки вы получите в конечном итоге.

Связанно это с тем, что при использование основных запросов отправляемых к Telegram используются дополнительные запросы определяющие такие параметры как язык, premium, имя, юзерку и т.п.

Такие виды постов как альбомы выполняются медленее обычных постов ввиду того, что Telegram учитывает кол-во медиа в посте. Если при обычной рассылке поста с фото будет расцениваться как 1 запрос, то при отправке альбомов запрос будет умножен на количество медиа.

Сюда же стоит добавить работу вашего бота отвечающего на запросы ваших пользователей.

Больше запросов - больше вероятность получить от Telegram флуд.

Если у вас большая база и она не успевает разослаться до момента как вы запускаете новую рассылку, ждите появление флудов.

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

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

Вариативность скорости

Плавающая - подстраиваться автоматически под пропускные ограничения вашего бота, как в большую, так и меньшую сторону. (Рекомендуется)

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

Рекомендованный флудвейт - использование рекомендованной задержки при возникновенее floodwait ошибок. В противном случае используется минимальное значение.

Мы рекомендуем данные параметры по-умолчанию для всех ботов:

• Скорость не более 60/cек
• Плавающая
• Рекомендованный флудвейт: Да

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

Общая информация

В BotManager можно прикрепить до 10 постов одновременно, во время рассылки посты будут автоматически распределяться между получателями. Для этого необходимо в настройках активировать опцию "Мульти-посты"

Формат постов может быть любой, бот принимает как посты в исходном формате, так и посты с html / markdown разметкой.

Бот принимает любые популярные форматы поста. Некоторые виды постов получиться разослать только репостом.

Под такие форматы попадают:

• Посты с премиум-эмодзи;
• Розыгрыши;
• Премиум-стикеры;

Терминология

• Медиа-файл - фото, видео, документы, голосовое, кружок прикрепляемый к рекламному посту (1);
• Сообщение - текстовое содержимое поста, при наличие медиа размещается внизу (2);
• Клавиатура - Кнопка / кнопки используемые в посте (3);
• Репостом - Сообщение пересылается от имени канала, или имени пользователя. Позволяется отслеживать охват поста или разослать сообщение c premium-эмодзи. Пример
• Звук уведомления - получит ли пользователь пуш-уведомление со звуком или без;
• Спойлер - скрытие медиа-файла под спойлер, для отображения требуется нажать на медиа. Пример
• Защита контента - при включенном параметре, репост сообщения или захват экрана (скриншот, видеоряд) недоступен;
• Реакция - первичная реакция на сообщение, доступен выбор из ограниченных реакций. Пример

Переменные

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

$full_name - имя, фамилия
$first_name - имя
$last_name - фамилия
$username - @username
$bot - юзернейм бота (можно использовать в кнопках), отправляется без @
$id - chat id пользователя (можно использовать в кнопках)

Если отсутствует @username то используется $full_name, в остальных значениях будет использован пробел. В чатах будет пропуск значения.

↓

_self - добавьте к переменной, чтобы получить кликабельное значение ведущее на самого пользователя.
Например: $full_name_self

↓

Рандомайзер уникальных предложений

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

Возьмем данный текст для примера:

{{Привет|Здарова|Приветствую}}. как {{твои дела|ваше настроение|поживаешь}}?

↓

Перестановка слов или предложений

Для примера возьмем данное предложение:

Привет. [[Сегодня прекрасная погода.|Вчера весь день лил дождь.]]

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

Терминология

• Живые - пользователи / группы которым удалось доставить рассылку
• Блокировали - пользователи / группы которым не удалось доставить рассылку. Возможные причины: бот остановлен пользователем, исключен из группы, аккаунт получателя удален, запрещены получения определенных медиа используемых в рассылке;

Для рассылки требуется прикрепить базу получателей из базы данных вашего бота. Файл получателей должен cодержать только список chat_id юзеров и/или группу. Допустимо размещение списка юзеров и чатов в одном списке.

Бот принимает данные в формате: txt, json, csv, xlsx, xls.

Обратите внимание, для корректного определения списка получателей, используйте при формирование только chat_ids. Допустимо также использование тегов.

Пример БД без тегов

Пример БД с тегами

Прикрепление БД

В BotManager доступно три способа для прикрепления базы данных получателей.

1. Файл

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

2. Выгрузка при помощи REST API

Автоматическая отправка данных вами используя REST API, мы рекомендуем именно этот способ.

Документация по интеграции: http://api.botstat.io/

Рекомендуется настроить планировщик отправки БД на периодичность минимум 1/24.

3. Автоматическое скачивание по заданному URL

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

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

В разделе "Мои боты" - "БД" вы также можете ознакомиться с историей обновления базы.

Теги

Вы сможете сформировать файл БД с нужной вам группировкой используемой вами. Пример БД с тегами

При создание задачи в разделе "Получатели" - "Теги" вы сможете выбирать получателей согласно выбранной вами группировке. Рассылка будет выполнена только на этих пользователей.

Лимиты и отступы

При выполнение рассылки вы можете отступить нужное количество получателей при рассылке. К примеру общая база наших пользователей составляет 10.000.

Лимит

Ограничивает кол-во получателей рассылки. В процентном соотношение или целым числом. Меньше значение - меньше получателей.

Отправьте значение от 1% до 100% или целым числом например 1000

В таком случае, рассылку получит только 1000 человек от общего количества 10.000

Отступ

Задает кол-во пользователей которое нужно пропустить в рассылке. В процентном соотношение или целым числом. Меньше значение - меньше будет пропущено.

Отправьте значение от 1% до 100% или целым числом например 3000

В таком случае, 3000 получателей будет пропущено и рассылку получит только 7000 человек от общего количества 10.000

При комбинирование этих двух параметров будет сделан отступ в 3000 получателей и рассылку получит 1000 ваших пользователей.