📧 Auto Code (Multi-Mail) для Starvell — коды подтверждения с почты прямо в чат заказа

Auto Code (Multi-Mail) — модуль StarvellBot для продавцов общих аккаунтов и доступов: Steam, ChatGPT / OpenAI, Epic Games, Discord, Supercell ID, EA, Ubisoft, Telegram и любых других сервисов, которые присылают код входа на почту. Покупатель пишет в чат заказа Starvell команду (по умолчанию !cd) — бот подключается к вашему почтовому ящику по IMAP, находит свежее письмо, достаёт код и отправляет его покупателю. Вам не нужно быть онлайн.

Главное:

• 📬 Несколько почт (Gmail, Mail.ru, Яндекс, Outlook, iCloud, Rambler и другие), у каждой — свои лоты и фильтры.
• 🔗 Привязка по ID лота Starvell — вводом ID/ссылки или выбором из списка ваших лотов.
• 🎓 Обучение по образцу — отправьте боту код из письма, и он сам подберёт фильтры.
• 🤖🎮 Готовые профили ChatGPT и Steam Guard.
• 🧪 Тест почты с подробной диагностикой.
• 🎫 Лимиты: сколько кодов на заказ, сколько часов доступна выдача, максимальный возраст письма.
• 🔄 Пул почт (Round-Robin) — несколько почт на один лот, заказы распределяются по кругу.
• ✉️ Сообщение после оплаты с инструкцией для покупателя.
• ✅ Автоподтверждение выполнения на Starvell.
• 🎭 Скрытие адреса почты в чате.
• 🔗 Интеграция с Auto Rent Steam — коды Steam Guard для арендаторов.
• 🧾 Журнал последних выдач и уведомления о каждой выдаче.

⚠️ 1. Включение

1. /menu → 🧩 Функции → Auto Code (Multi-Mail) → 🚀 Включить.
2. Меню модуля — команда /autocode (или ⚙️ Настройки → 📧 Настройки AutoCode).

Кнопка «Переключить (🟢 ON / 🔴 OFF)» в меню /autocode — это тот же переключатель, что и в списке функций. Все остальные настройки применяются сразу, перезапуск бота не нужен.

🚀 2. Быстрый старт

1. Включите модуль.
2. Создайте пароль приложения для почты и включите в ней IMAP (часть 3).
3. /autocode → 👥 Управление аккаунтами → ➕ Добавить аккаунт → пройдите мастер из 4 шагов.
4. Откройте карточку почты и настройте фильтры: 🤖 Профиль ChatGPT, 🎮 Профиль Steam или 🎓 Обучить по образцу.
5. Нажмите 🧪 Тест почты — код должен находиться.
6. Задайте ограничения: 🎫 Лимит кодов на заказ, ⏳ Окно выдачи, 🕓 Макс. возраст, 🎭 Скрытие почты.
7. Проверьте 🛒 Покупатель и заказы (команда, сообщение после оплаты) и режим ✅ Автоподтверждение.

⚠️ Проверить !cd со своего аккаунта продавца нельзя — модуль игнорирует ваши сообщения. Используйте 🧪 Тест почты или покупку с другого аккаунта.

🔐 3. Пароль приложения и IMAP

Модуль читает письма по протоколу IMAP. Обычный пароль от почты не подойдёт — нужен пароль приложения:

• Gmail: аккаунт Google → «Безопасность» → включите двухэтапную аутентификацию → «Пароли приложений» → создайте пароль (16 букв, пробелы можно не вводить).
• Mail.ru: «Пароль и безопасность» → «Пароли для внешних приложений» → «Добавить».
• Яндекс: Яндекс ID → «Безопасность» → «Пароли приложений» → тип «Почта».

В настройках самой почты должен быть включён доступ по IMAP.

IMAP-сервер модуль подставляет сам по домену адреса: Gmail → imap.gmail.com, Mail.ru/BK/Inbox/List → imap.mail.ru, Яндекс → imap.yandex.ru, Rambler → imap.rambler.ru, Outlook/Hotmail/Live → outlook.office365.com, iCloud → imap.mail.me.com, Yahoo → imap.mail.yahoo.com, GMX. Для других почт укажите сервер вручную; нестандартный порт — через двоеточие: imap.example.com:993 (по умолчанию 993).

🔒 Сообщение с паролем бот удаляет из чата сразу. В карточке пароль всегда скрыт.

🏠 4. Меню /autocode

Вверху — статус, число почт и привязанных лотов, сколько заказов модуль принял при оплате и по скольким ведёт счётчик выдач, текущая команда покупателя и режим автоподтверждения.

🛒 Покупатель и заказы

• ⌨️ Изменить команду — своя команда вместо !cd, можно несколько через | (например !cd | !code). Покупатель может указать почту: !cd почта@пример.ру. Не используйте !код, если включён Auto Rent Steam, — это его команда для Guard-кода.
• ✉️ Сообщение после оплаты (🟢 по умолчанию) — сразу после оплаты бот пишет покупателю, как получить код. ✏️ Изменить текст / ↩️ По умолчанию. Переменные: {command}, {lot}, {email}, {order_id}.
• 🔎 Страниц продаж (по умолчанию 2, можно 0–10; рекомендуется 1–3 — каждая страница это отдельный запрос к Starvell) и 🗄 Архив продаж (🟢) — где искать заказы, оформленные до включения модуля. Заказы, принятые модулем при оплате, находятся всегда.
• ⏳ Антиспам — пауза между запросами одного покупателя (по умолчанию 15 секунд, можно 0–600).

👥 5. Почты

Список

/autocode → 👥 Управление аккаунтами — почты с числом лотов, кнопки ✏️ Ред. адрес и ➕ Добавить аккаунт.

Мастер добавления

Стартовые настройки: фильтры пусты; длина кода 6; пробелы — да; тип — буквы+цифры; окно выдачи и лимит — без ограничений; макс. возраст — 15 минут; скрытие почты — нет.

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

⚙️ 6. Карточка почты

Вверху — пароль (скрыт), IMAP, лоты, фильтры отправителя/темы/текста (с пометкой «мягкий»), длина, пробелы, тип кода, окно выдачи, лимит, макс. возраст, скрытие почты и «обучен по образцу».

📌 Правила ввода: ответьте на подсказку бота обычным сообщением. В текстовом фильтре - очищает его. Несколько вариантов — через | (подойдёт любой), сравнение — по вхождению без учёта регистра.

🤖 Профиль ChatGPT — отправитель openai.com, тема ChatGPT | код | code | OpenAI, ключевое слово очищается, длина 6, цифры, пробелы да.

🎮 Профиль Steam — отправитель steampowered.com | steam.com, тема Steam | Стим | аккаунт Steam, ключевые слова доступа | код | access | code | Steam Guard в мягком режиме, длина 5, буквы+цифры, пробелы да (Steam часто разбивает код: K 7 B 2 Q).

Профили заменяют фильтры, длину, тип и пробелы; лоты, лимиты, окно, возраст и привязки Steam не трогают. После профиля нажмите 🧪 Тест почты.

🎓 Обучить по образцу — для любых сервисов:

1. Убедитесь, что код приходил на эту почту за последние 3 дня.
2. Нажмите кнопку и отправьте этот код (можно с пробелом или дефисом).
3. Бот найдёт письмо среди последних 40 писем за 3 дня во «Входящих» и определит отправителя, 1–2 устойчивых слова темы, длину и тип кода и ключевое слово рядом с кодом (мягкий режим). Учебное письмо модуль запоминает и никогда не выдаст покупателю.

Обучение дополняет настройки: варианты складываются через |, длины объединяются (6|5). Так почту можно обучить на русском, а затем на английском письме.

🧪 Тест почты — проверка с текущими настройками: сколько писем прочитано, какие фильтры действуют, вердикт по каждому письму, найденные варианты с оценкой уверенности и итоговый код. Покупателю ничего не отправляется, счётчики не меняются. Во время теста ограничение по возрасту письма временно отключено; если оно включено, в конце отчёта будет строка — получит ли покупатель этот код с учётом лимита.

🔗 Привязать Steam — видна, если включён модуль Auto Rent Steam (часть 10).

📦 Управление лотами — лоты этой почты (ID — название):

• 📋 Выбрать из моих лотов — отметьте лоты кнопками из списка вашего профиля Starvell;
• ➕ Добавить лот по ID/ссылке — одно или несколько значений через запятую;
• 🔄 Обновить названия лотов — после переименования лота на Starvell;
• 🗑️ ID — название — удалить лот из почты.

⏳ Окно выдачи — сколько часов покупателю доступны коды (24, 0.5, 1,5; 0 — без ограничения). Таймер стартует с первого запроса кода по заказу (для аренды Steam — с начала аренды).

🎫 Лимит кодов на заказ — сколько кодов максимум по одному заказу (0 — без ограничения).

🕓 Макс. возраст — письма старше N минут не рассматриваются (по умолчанию 15, рекомендуется 10–30, 0 — отключить). Защищает от выдачи старого кода предыдущего клиента.

📏 Длина — от 3 до 32 символов; несколько через |: 5|6.

👾 Пробелы — Да (рекомендуется): находит 123 456, 123-456, K 7 B 2 Q и слитные коды; Нет — только слитные.

🔣 Тип кода — по кругу: Буквы+Цифры → Цифры → Буквы.

🎭 Скрытие почты — покупатель видит адрес частично скрытым: e*a*p*e@gmail.com.

📝 Ключ. слово (Body) — слово в тексте письма. Один вариант — жёсткий режим (письмо без слова отбрасывается); несколько через |, а также после обучения и профилей — мягкий (слово только повышает уверенность).

🔍 Отправитель / 🔍 Тема — фильтры по полю «От» и теме. Указывайте варианты на разных языках: тема письма зависит от языка аккаунта покупателя.

🧹 Сбросить фильтры — очищает отправителя, тему, ключевое слово и учебное письмо. Длина, тип, лоты и лимиты не меняются.

🔑 Пароль / 🌐 IMAP — смена пароля приложения и сервера без удаления почты.

♻️ Сбросить счётчики этой почты — обнулить счётчики выданных кодов по всем заказам этой почты.

🗑️ Удалить аккаунт — с подтверждением; удаляет почту и её настройки из модуля.

🔎 7. Как модуль ищет код

1. Подключается к почте, берёт последние 25 писем за 2 суток из «Входящих» (спам и другие папки не читаются; письма не удаляются и не помечаются прочитанными).
2. Пропускает учебное письмо, письма старше лимита возраста, не подошедшие по отправителю/теме и без ключевого слова (в жёстком режиме).
3. В тексте письма ищет код нужной длины и типа, отбрасывая годы 2023–2035, служебные слова и цвета из оформления.
4. Выбирает самый вероятный вариант: рядом со словами «код», «code», «verification», «подтверждение», «guard» уверенность выше.

Ограничения: код ищется только в тексте (не в теме); подтверждения ссылкой/кнопкой и коды на картинках не поддерживаются; 4-значные коды от 2023 до 2035 не выдаются.

🛡 8. Лимиты

• 🎫 Лимит на заказ списывается только при выдаче нового кода. Ошибка почты, «код не найден» и повтор того же кода попытку не тратят. Покупатель видит остаток: «🎫 Осталось запросов по заказу: 1 из 2».
• ⏳ Окно выдачи — по окончании покупатель получает «⌛ Время доступа к кодам по вашему заказу истекло».
• 🕓 Макс. возраст — гарантирует, что код свежий.

Защиты действуют одновременно. Счётчики по заказам без запросов дольше 90 дней очищаются автоматически.

🔄 9. Пул почт (Round-Robin)

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

🔗 10. Интеграция с Auto Rent Steam

Если модуль Auto Rent Steam включён, в карточке почты появится 🔗 Привязать Steam: отметьте Steam-аккаунты из базы аренды (🎮 — не привязан, ✅ — привязан, ❌ Отвязать все). Привязывайте каждый Steam-аккаунт только к одной почте.

Арендатор пишет !cd в чате аренды → модуль находит его активную аренду и почту арендованного аккаунта → присылает свежий код Steam Guard. После окончания аренды выдача прекращается. Лоты к почте привязывать не нужно; окно выдачи отсчитывается от начала аренды, лимит кодов тоже действует. Для такой почты примените 🎮 Профиль Steam.

💬 11. Что видит покупатель

После оплаты (если включено): инструкция с командой.

По команде !cd:

⏳ Ищу код (проверяю почт: 1)...
📧 m*m*i*@gmail.com: 59302
🎫 Осталось запросов по заказу: 1 из 2.

Модуль учитывает все заказы покупателя, включая завершённые (заказы с возвратом — нет), и его активные аренды Steam. Запросы от покупателей из чёрного списка и ваши собственные сообщения игнорируются.

🎯 12. Рекомендуемые настройки

• ChatGPT / OpenAI: 🤖 Профиль ChatGPT → 🧪 Тест.
• Steam Guard: 🎮 Профиль Steam → 🧪 Тест.
• Другие сервисы: запросите код → 🎓 Обучить по образцу → 🧪 Тест. Для писем на другом языке обучите ещё раз.
• Одна почта — несколько сервисов: профиль первого сервиса + варианты второго через | в отправителе и теме, длины через | (5|6), тип «Буквы+Цифры», обязательно 🧪 Тест.

Держите 🕓 Макс. возраст включённым (10–30 минут), задавайте 🎫 Лимит и при необходимости 🎭 Скрытие почты.

❓ 13. Частые вопросы

Покупатель получает «Код не найден». Запустите 🧪 Тест почты. Причины: письмо ещё не дошло (5–20 секунд); сработал лимит возраста; не совпали отправитель/тема (другой язык) — добавьте вариант или переобучите; неверная длина/тип; письмо в «Спаме»; письмо старше 2 суток или не входит в последние 25.

«У вас нет заказов, привязанных к авто-выдаче кодов». ID купленного лота не добавлен ни в одну почту. Добавьте его в 📦 Управление лотами (если лот пересоздан — новый ID).

Бот не отвечает на !cd. Модуль выключен; покупатель в чёрном списке; команда отправлена с вашего аккаунта; вы изменили команду в 🛒 Покупатель и заказы.

Ошибка IMAP / AUTHENTICATIONFAILED. Включите IMAP в почте, используйте пароль приложения, проверьте сервер. Сменить пароль можно кнопкой 🔑 Пароль в карточке.

Покупатель получил старый код. Проверьте, что 🕓 Макс. возраст не равен 0.

Как выдать покупателю ещё код сверх лимита? ♻️ Сбросить счётчики этой почты (затронет все заказы почты) или временно увеличьте лимит.