Airgram Docs

Модули

Парсинг аудитории

Модуль собирает людей из групп и каналов Telegram и сохраняет их новой базой в «Базы» → «Пользователи». Эту базу можно использовать в инвайте и рассылках.

Источники аудитории#

Нажмите «Добавить источники» в карточке «Источники аудитории».

Кнопка «Добавить источники»

Вставьте ссылку на группу или канал — t.me/… или @username — и нажмите «Добавить». Несколько ссылок можно вставить списком или загрузить файлом .txt / .csv. Повторы не добавляются.

Окно «Добавить источники»

Чтобы изменить ссылку, нажмите на неё в списке. В меню «⋮» можно отредактировать весь список текстом или очистить его. Когда список готов, нажмите «Готово».

Группы и каналы, найденные Поиском групп и каналов, берутся целой базой: в меню «⋮» выберите «Из базы» и отметьте нужные базы. Базы можно сочетать между собой и со ссылками.

Базы источников в окне «Добавить источники»

Одну ссылку можно вписать и прямо в карточку: нажмите на её описание, вставьте ссылку и нажмите Enter. Источник, добавленный по ошибке, убирается крестиком на его пилюле.

Кого собираем#

Отметьте, кого брать из источников. Можно выбрать несколько вариантов сразу.

Кого собираем
  • Участники — весь список участников группы, без администраторов и ботов.
  • Авторы сообщений — кто писал в группе за выбранный период.
  • Комментаторы — кто комментировал посты канала за выбранный период. Если у канала нет обсуждения, он пропускается.
  • Администраторы — владелец и администраторы группы, без ботов.
  • Контакты из описания — логины из описания группы или канала. Фильтры профиля к ним не применяются.

Если среди источников нет подходящих чатов, например нет ни одного канала для «Комментаторов», вариант становится бледным: собирать его неоткуда.

Фильтры#

Фильтры профиля, активность и глубина сбора
  • Фильтры профиля — оставить только тех, у кого есть фото профиля («С аватаром»), подписка Telegram Premium или кому можно написать в личные сообщения («Можно написать в ЛС»).
  • Последняя активность — когда человек последний раз заходил в Telegram. Снимите лишнее, чтобы не собирать давно брошенные аккаунты.
  • Глубина сбора — за сколько дней читать сообщения для авторов, комментаторов, реакций и опросов. 0 — вся история. Участников и администраторов глубина не ограничивает.
  • Собирать дополнительно — поставивших реакции и голосовавших в опросах. Их находят в тех же сообщениях, поэтому нужны «Авторы сообщений» или «Комментаторы».

Аккаунты#

Нажмите «Выбрать аккаунты», отметьте нужные и нажмите «Сохранить».

Окно «Аккаунты для парсера»

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

Дополнительные настройки#

Дополнительные настройки
  • Количество потоков — сколько источников обрабатывается одновременно. 0 — значение из раздела Настройки.
  • Лимит ожидания FloodWait — максимальное время ожидания ограничения. Если оно превышено, аккаунт прекращает работу. Пустое поле использует общую настройку, 0 означает ожидание без ограничения.

Запуск и результаты#

Нажмите «Запустить задачу». Значок календаря рядом с ней — запланировать запуск на нужное время. Следить за ходом сбора можно в Диспетчере задач.

Кнопка «Запустить задачу»

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

Лог задачи парсинга

Каждый запуск создаёт новую базу в «Базы» → «Пользователи» с датой и временем в названии. База пополняется во время сбора. Откройте её через значок слева от кнопки «Запустить задачу».

Значок «Базы · Пользователи»

У каждого человека сохраняются Telegram ID и логин, если он есть. Люди без логина тоже попадают в базу — по ID. Один человек из нескольких источников записывается один раз, поэтому в базе бывает меньше людей, чем «Найдено» в задаче.

База собранных пользователей

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

Советы#

  • Большие группы собираются долго, а Telegram регулярно просит подождать. Если в логе появляются новые строки, сбор идёт.
  • Если список участников группы скрыт, включите «Авторы сообщений»: писавших можно собрать и в такой группе.
  • Активная аудитория отзывчивее: пара тысяч человек из профильной группы со свежим заходом лучше ста тысяч случайных.
  • Перед инвайтом или рассылкой проверьте базу и уберите лишних.