Руководство

Базы данных в Telegram Expert — это организованная система хранения информации, которая позволяет упорядочивать и быстро находить нужные данные. База данных представляет собой совокупность структурированных данных, организованных по определенным правилам. Она хранит данные в виде таблиц с колонками (атрибутами) и строками (записями), что упрощает доступ к информации и ее обработку.

Что нужно, чтобы начать работу с базами данных?

Чтобы начать работу с базами данных, вам потребуется установить SQLite Studio. Это бесплатное ПО, которое позволяет работать с базами данных SQLite. Найти ее можно в папке софта под названием «sqlite».

В программе пользователи могут без проблем управлять любыми базами или редактировать их. Основные моменты в настройке:

Отображение базы

Можно изменить отображение базы на странице программы. Для этого откройте меню настроек и выберите нужное значение. На странице можно отображать любое количество строк — например, 1000 или 10000 — зависит от вашего удобства.

Если вы только начинаете работать с базами, рекомендуем сразу при просмотре настроить отображение, чтобы не ошибиться. Например, вы можете получить базу с 20000 строк, но из-за дефолтных настроек увидеть всего 1000 и подумать, что софт отработал неправильно. Проверьте сначала отображение количества строк, прежде чем делать выводы.

Редактирование данных

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

Вы можете вручную менять статусы по необходимости — например, со статуса «Done» поменять на «Ready». И тогда после применения этой базы для рассылки софт повторно пройдется по всем пользователям, указанным в ней, чтобы совершить рассылку, даже если она уже осуществлялась. Главное в процессе внесения изменений не забыть кликнуть на значок галочки, чтобы сохранить изменения. Если этого не сделать, данные не обновятся.

Более детальные обозначения кнопок в ПО:

1. Добавить строку.


2. Удалить строку.


3. Подтвердить изменение.


4. Отменить изменения.


5. Переместиться на следующий лист базы и перейти в самый последний лист базы.


6. Поле ввода для фильтра.


7. Кнопка применения фильтра.

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

Управление данными

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

Базы генератора параметров

Такие базы содержат столбцы, которые соответствуют параметрам, указанным в генераторе:

• APP ID: это числовой идентификатор, присваиваемый каждому приложению, которое регистрируется для работы с API Telegram. Это уникальное значение помогает серверу Telegram понять, через какое конкретное приложение осуществляется запрос. У каждого типа приложения (например, Android, Telegram X, Desktop) может быть свой App ID. Например, для Android это может выглядеть как 4, а для Desktop — 2040.


• APP Hash: это уникальный код (или хеш), который подтверждает подлинность App ID и привязывает его к определенному приложению. По сути, это комбинация букв и цифр, которая служит своего рода паролем. Например, для Android это может быть строка вида 014b35b6184100b085b0d0572f9b5103.


• SDK: версия системы в формате SDK.


• Device: отображает модель устройства, с которого якобы происходит регистрация.


• APP Version: указывается версия приложения Telegram.


• Lang_Code: язык приложения.


• System_Lang: язык системы.


• Lang_Pack: код устройства.


• TZ_Ofset: часовой пояс.


• Perf_Cat: класс устройства.

Базы сбора аудитории

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

• User_ID: указывается ID пользователя.


• Group_ID: включает ID группы, из которой спарсили пользователя.


• MESSAGE_ID: указывается ID сообщения, если сбор происходил по сообщениям в чате.


• COMMENT_ID: включает ID комментария, если сбор происходил по комментариям в канале.


• Phone: отображается номер телефона пользователя, если он открыт.


• Username: указывается юзернейм пользователя.


• First_Name: имя пользователя.


• Last_Name: фамилия пользователя.


• BIO: данные био профиля, если они есть или доступны.


• Gender: пол (указывается M для мужчин, F для женщин).


• Photo: наличие или отсутствие фото (0 — нет, 1 — да).


• Premium: есть или нет статус Premium в Telegram у пользователя (1 — да, 0 — нет).


• Status: отображается статус в сети пользователя.


• Time: отображается время последнего посещения, если статус оффлайн.


• Invite_Status: показывается статус пользователя для инвайта: Ready означает готов, а Done — что инвайт отправлен.


• Send_Status: отображается статус для рассылки сообщений: Ready — готов, Done — смс отправлено.

Если пользователь делает проверку ссылок, то в итоговой базе будут содержаться данные о группах:

• ID: указывается ID группы.


• Username: юзернейм группы, может содержать ссылку на группу, если она была указана.


• Count: здесь указывается количество участников в группе.


• Title: название чата или канала.


• Photo: наличие или отсутствие фото в группе (0, если нет, а 1, если есть).


• Invite: доступны ли инвайты.


• Send_Message: доступна ли отправка сообщений.


• Send_Media: доступна ли отправка медиа-файлов.


• Send_Stickers: доступна ли отправка стикеров.


• Send_Polls: доступна ли отправка опросов.


• Slow_Mode: доступен ли медленный режим отправки сообщений.


• Scam: ????


• Type: тип группы (например, супергруппа).


• Status: указывается статус обработки группы: Ready для готовых к действию, Done, если действие с группой уже совершилось.

Базы данных при инвайте

Telegram Expert формирует удобные для управления базы данных. В основном, все значения в столбцах понятные, если перевести их на русский. Единственное, важно запомнить, что если в столбце не прописывается информация, а есть значение 0 или 1, это означает наличие или отсутствие: 1 — да, 0 — нет.

Какие базы данных формирует софт?

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

• Действия с аккаунтом — [code]additives/accounts[/code] (при каждой проверке аккаунтов на бан или ограничения в панели аккаунтов, софт создаёт базу данных с результатами. Это позволяет удобно просматривать и сортировать данные при необходимости).


• Генерация параметров — [code]additives/registrator_generator[/code].


• Авто-регистрация — [code]additives/registrator[/code].


• Дубликатор сессий — [code]additives/registrator_dublicator[/code].


• Инвайт — папка отмечена названием [code]invite[/code], а в конце — какой именно инструмент использовался: [i]id[/i], [i]admin[/i], [i]admin_auto[/i] и пр.


• Отправка смс — отмечена названием [code]send[/code], в конце — какой инструмент использовался: [i]channels[/i], [i]group[/i], [i]id[/i] и пр.


• Парсинг — отмечена названием [code]parsing[/code], в конце — какой инструмент использовался: [i]account[/i], [i]comment[/i] и пр.


• Работа с базами — [code]db_clean[/code], [code]db_exclude[/code], [code]db_gender[/code], [code]db_union[/code].


• Проверка номеров, проверка ссылок — [code]additives/check_phones[/code], [code]additives/check_links[/code].


• Создание чатов — [code]additives/create_channels[/code].


• Накрутка (реакции) — [code]additives/reactions[/code].


• Массовая отписка — [code]additives/unsubscribe[/code].


• Статистика — базы данных статистики отмечены [code]stat[/code], а в конце указано конкретное назначение: [i]calc[/i], [i]generator[/i] и пр.


• Массовые подписки — [code]additives/subscribe[/code].


• Подписки на бота — [code]additives/subscribe_bot[/code].


• Репортер — [code]additives/reporter[/code].


• Автоответчик — [code]additives/answering_machine[/code].

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

Если говорить про базы, которые находятся в папках на вашем ПК, то они будут отличаться. Например, если вы совершите рассылку и зайдете в нужную папку для просмотра базы, то увидите два вида баз — BaseParsing и ResultStat.

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

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

ResultStat содержит базы статистики — это значит, что по итогам совершения определенного действия софт покажет в базе, кому или куда были отправлены инвайт или рассылка. В зависимости от результата статусы будут отличаться — либо покажет «Done», либо выдаст ошибку.

Наименование базы ResultStat может отличаться в зависимости от того, с каким модулем ведется работа. Например, база инвайта будет иметь наименование [code]Invite[/code], а база рассылок: [code]Send[/code].

Давайте рассмотрим подробнее возможные статусы в работе с базами ResultStat в разных модулях:

Регистрация:

• CodeSendInApp — при регистрации активирована опция «Отклонить номер, если код отправлен в приложение», что означает, что код был отправлен непосредственно в приложение, и программа отклонила номер.


• Done — на данный номер телефона успешно зарегистрирован аккаунт.


• PhoneNumberBannedError — номер телефона заблокирован в Telegram, регистрация на него невозможна, и программа автоматически отменяет такой номер.


• PhoneCodeInvalidError — сервис SMS прислал неверный код, что приводит к отмене номера, хотя оплата за него будет списана. Некоторые SMS-сервисы компенсируют такие случаи, поэтому стоит обратиться в их поддержку.


• CodeNotSend — код не был отправлен на указанный номер телефона по неизвестной причине. Программа отменяет данный номер.


• CodeNotRecived — код не пришёл на данный номер телефона за установленное время ожидания. Это может быть связано с настройками или прокси.


• UnboundLocalError — возникла проблема с прокси, попробуйте заменить их.


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


• PhoneNumberWithTwoFa — код пришёл на номер телефона, но на нём уже зарегистрирован аккаунт с двухфакторной аутентификацией (2FA). Некоторые сервисы автоматически возвращают средства за такие номера.


• OperationalError — проблема с прокси; рекомендуется их проверить или заменить.

Инвайт:

• Done — пользователь успешно добавлен в чат.


• UserPrivacyRestrictedError — настройки приватности пользователя запрещают его приглашение в группы или чаты.


• UserChannelsTooMuchError — у пользователя слишком много активных чатов или каналов, поэтому приглашение не удалось.


• NotInGroup — пользователь был приглашён, но программа не нашла его в чате после инвайта.


• BadRequestError — ошибка запроса при попытке приглашения. Проверьте корректность настроек и данных.


• NotInvited — пригласить пользователя не удалось, чаще всего из-за его настроек приватности.


• UserIdInvalidError — не удалось добавить пользователя, так как его ID недействителен.


• UserBannedInChannelError — пользователь ранее был в группе, но вышел или был заблокирован, поэтому добавить его не удалось.


• UserNotMutualContactError — пользователь позволяет приглашать себя только взаимным контактам, либо аккаунт попал под временный или постоянный спам-блок.


• NotFoundInGroup — пользователь не найден в исходном чате при инвайте по ID.

Рассылка:

• Done — сообщение успешно отправлено.


• ForbiddenError — у пользователя закрыта возможность получения сообщений от всех, кроме премиум-аккаунтов и контактов. Сообщение не отправлено.

Прочие статусы:

• ValueError — неверные значения. Проверьте настройки модуля и корректность введённых данных.


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


• InviteHashExpiredError — часто возникает, когда указана недействительная или устаревшая ссылка на чат. Проверьте её или создайте новую.


• ScheduleTooMuchError — превышен лимит отложенных сообщений для одного диалога или канала (лимит — 100).


• ChatAdminRequiredError — требуется статус администратора для выполнения действия. Проверьте права аккаунта.


• ChatWriteForbiddenError (Рассылка) — в данном чате отключена возможность отправки сообщений.


• ChatWriteForbiddenError (Инвайт) — проверьте настройки чата, если ошибка возникает на каждом добавляемом пользователе.


• UserRestrictedError — запрос на добавление прошёл успешно, но Telegram не нашёл пользователя в чате, вероятно, из-за повышенных лимитов.


• ConnectionError — ошибка соединения. Проверьте настройки прокси.


• Ready — строки с этим статусом готовы к обработке.


• Taken — строки взяты в работу.


• ChatWriteForbiddenError (повтор) — при рассылке в чате закрыта возможность отправки сообщений; при инвайте — проблема с настройками чата.

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

• UsernameInvalidError — указанный юзернейм не существует.


• PeerFloodError — ошибка флуда. Рекомендуется ознакомиться с обучающими материалами по антиспам-правилам.

Для работы с базами статистики используется модуль «Отчеты». Для изменения и работы с базами, которые вы получили после использования модуля «Сбор аудитории», используются разделы в этом же модуле: «Очистка баз», «Объединение баз», «Исключение баз».

Как используются базы данных в модулях Telegram Expert?

В разных модулях используются базы данных для управления и обработки информации об аккаунтах, пользователях и аудитории, а также для автоматизации процесса регистрации и инвайта в Telegram. Вот как это работает в каждом модуле:

Модуль «Действия с аккаунтом»

В этом модуле пункт «Добавить аккаунт» требует базу данных с параметрами, необходимыми для создания аккаунтов Telegram. Эта база данных содержит заранее сгенерированные данные, такие как информация об устройстве, версия приложения и прочие параметры, которые позволяют создать новый аккаунт с нужными характеристиками. Это помогает автоматизировать процесс создания и управления аккаунтами, используя подготовленные данные.

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

Модуль «Авто-регистрация»

Здесь, чтобы зарегистрировать аккаунты автоматически, используется база данных параметров, созданная в «Генераторе параметров». В пункте «Ручная регистрация» требуется такая же база данных, чтобы применить параметры к конкретному аккаунту, загружая в него нужные данные.

Для регистрации с использованием виртуальных номеров от SMS-сервисов, а также для регистрации через «Универсальный регистратор», также необходима база параметров, так как она содержит все данные, нужные для регистрации аккаунта в разных сценариях, автоматизируя процесс и повышая его гибкость.

Модуль «Сбор аудитории»

Модуль позволяет пользователям создавать базы данных аудитории на основе различных критериев парсинга, таких как активность в чате, комментарии в канале, язык аудитории и т. д. Результат работы — база данных, содержащая аудиторию, отобранную по указанным критериям.

Кроме того, в папках сбора аудитории будет отображаться и база данных Base, которая содержит списки групп или каналов для парсинга (ваши входные данные). Впоследствии такие базы можно применять повторно, чтобы отбирать новую аудиторию, которая появилась со временем. Чтобы не играться долго, можно исключить по итогам парсинга одну базу из второй.

Например, у вас есть первая база, содержащая пользователей, которую вы собрали месяц назад, и есть новая, которую собрали сегодня. Чтобы отсеять «старые» аккаунты, можно исключить старую базу из новой — тогда в итоговой отобразятся только те пользователи, которые появились или начали комментировать посты за прошедший период, а все дубликаты исчезнут.

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

То есть тут два варианта — либо вводим списком данные для парсинга (юзернеймы пользователей или каналов, ссылки на вступление и т.д), либо подтягиваем базу Base, которая создалась автоматически на основе списка. В последнем варианте это полезно, когда нужно продолжить парсинг, если он оборвался и отработались не все пользователи или чаты/каналы. Сверяйте это по статусам — «Ready» сообщает о том, что работа не началась.
Пример базы BaseParsing

Модуль «Инвайт»

В этом модуле пользователи формируют базы данных по исходам инвайта — в них также отмечаются все статусы обработки задачи или ошибки, если они возникли. Эта база данных используется для отслеживания процесса инвайтов и поддержания порядка.

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

Модуль «Отправка СМС»

Для отправки смс или рассылки по комментариям нужны разные данные:

• Комментарии в канале — либо вводится список каналов (юзернейм, ссылка-приглашение), либо добавляется база данных, которая создавалась по итогам отправки комментариев (Base). Это полезно в случае, если операция обрывается, или для повторной рассылки, но тогда нужно поменять статусы с «Done» на «Ready».


• Отправка смс — указывается список юзернеймов пользователей списком. Если есть база данных со «Сбора аудитории» или Base, которую вы получили при работе в разделе в прошлый раз, можно добавить ее.


• Отправка по ID — в этом случае база необходима, так как нужны данные о группе, с которой спарсили пользователей. Без этих данных рассылка не может осуществиться, так как аккаунту нужно вступить в группу и найти нужных пользователей по их ID. Поэтому список указать здесь не получится.


• Автопостинг в чаты V1 — вставляется либо список групп, либо база данных с группами, которая была сформирована в этом разделе (Base) для повторной рассылки или продолжения той, которая по определенным причинам была остановлена.

Модуль «Номера телефонов»

Для работы с этим модулем, а точнее с «Инвайтом по номерам» и «Отправкой по номерам», нужен либо список номеров, либо база данных с номерами. Такую базу можно сформировать в «Чекере номеров» — по итогам проверки получится база Result/Stat с номерами. Также по аналогии с предыдущими модулями здесь можно вставлять базы данных, которые вы получили по итогам инвайта (Base) для продолжения операции или для повторных приглашений.

Модуль «Накрутка»

База данных нужна только в разделе «Массовые подписки» — вставляете готовую базу (Base), содержащую данные о группах. Ее можно сформировать прямо здесь, если в поле со списком указать юзернеймы или ссылки на группы. Однако можно воспользоваться и базами от работы с «Отправка СМС» — это базы (Base), которые вы получили после автопостинга по чатам.

Также база может пригодиться и для работы с разделом «Рефералы в бота» — туда можно вставить базу (Base), сформированную по итогам работы с инструментом, чтобы продолжить операцию или начать ее заново (только при смене статусов).

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

Модуль «Отчеты»

В модуле с отчетами происходит работа с базами статистики (результата).

• Для «Генератора отчетов» — добавляете любую базу результата (инвайт, рассылка) и получаете возможность на основе нее собрать отчет по работе. Если нужно, можно исключить для каждого из действий строки со статусом «Done», чтобы получить на выходе базу с необработанными пользователями или каналами или чатами.


• Для «Объединения баз» — добавляете до 5 баз статистики, чтобы собрать их в одну большую базу. Например, чисто по инвайту по ID.


• Для «Калькулятора» — добавляете базу результата по инвайту или рассылке. В итоговой базе софт подсчитает, сколько рассылок или инвайтов отправлено с конкретного аккаунта, а также сколько было успешных и неуспешных операций.

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

9. Специальные модули

В специальных модулях нужны базы для работы с дубликатором. Добавляется база данных, содержащая параметры для аккаунта. Но это возможно только в том случае, если вы не выбрали «Использовать параметры из аккаунта».

В остальных модулях база данных не нужна. Однако по итогам работы можно получить базу данных из «Репортера» — она хранится в одноименной папке на устройстве.

В остальных случаях следите за процессом работы модуля через лог. Например, вот пример лога при работе с «Дубликатором сессий».