BotManager
February 28, 2024

Получатели

  1. Прикрепление БД. Варианты
  2. Теги
  3. Лимиты и отступы

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

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

Для рассылки требуется прикрепить базу получателей из базы данных вашего бота. Файл получателей должен 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 ваших пользователей.