Руководство по плагину Email Code Fetcher

Email Code Fetcher нужен для аккаунтов, где вход подтверждается кодом из письма. Покупатель пишет в чат команду (например, !rck), а бот находит свежее письмо в привязанном ящике и присылает код. Ящик можно привязать к лоту — тогда код получит только покупатель этого лота и только пока заказ не возвращён.

🎯 Для чего это нужно

1. Покупатель входит сам: не нужно ждать, пока продавец проснётся и пришлёт код.
2. Безопасно: код получает только покупатель нужного лота, а после возврата — больше никто.
3. Много аккаунтов на одной почте: бот выдаст код именно для логина покупателя.

✨ Что умеет плагин

• Несколько ящиков: у каждого свой фильтр писем и своя команда.
• Протоколы: IMAP, POP3 и Gmail через OAuth.
• Ящик лота: /mail_opt N lot ID_лота — код только покупателю этого лота, в его чате; заказ возвращён — коды больше не выдаются.
• Доступ по списку чатов: для ящиков без лота команды работают только в разрешённых чатах (или во всех — переключателем).
• Префикс команд: !, /, ., #, ? или свой.
• Код строго для своего логина: /mail_opt N login — на одной почте много аккаунтов, покупатель получит код своего.
• Фильтры с вариантами через «|»: отправитель, тема, ключевое слово.
• Лимит кодов на чат: покупатель не будет брать коды бесконечно.
• Окно поиска (15 минут), память кода (60 секунд) и пауза между запросами (10 секунд) — настраиваются.

⚡ Быстрый старт

1. Включите плагин и перезапустите бота (шаг 1 ниже).
2. /email_codes → «📧 Аккаунты» → «➕ IMAP аккаунт».
3. Привяжите ящик к лоту: /mail_opt 1 lot ID_лота — или разрешите чаты в «🔑 Доступ».
4. Проверьте: /ecf_test.

🛠️ Пошаговая настройка

ШАГ 1. Включите плагин (обязательно перед настройкой)

1. Отправьте своему боту команду /menu.
2. Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Email Code Fetcher.
3. Нажмите «Включить».
4. ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.

ШАГ 2. Шаг 1. Ящик

1. /email_codes → 📧 Аккаунты → ➕ IMAP аккаунт.
2. Формат: email | пароль приложения | фильтр | команда.
3. Пароль приложения: Gmail — Безопасность → Пароли приложений; Яндекс и Mail.ru — так же в настройках безопасности.

ШАГ 3. Шаг 1б. Логин и фильтры (по желанию)

1. /mail_opt 1 login steamlogin — ящику №1 привязан логин: бот выдаёт код только из письма для этого логина.
2. /mail_opt 1 subject Steam Guard | Your Steam account — подойдёт письмо с любой из тем; так же from и keyword.
3. /mail_opt 1 limit 3 — не больше трёх кодов в один чат; «-» вместо значения убирает настройку.

ШАГ 4. Шаг 2. Доступ

1. Проще и безопаснее: /mail_opt 1 lot Аккаунт GTA (часть названия лота или его ID) — код по команде ящика №1 получит только тот, кто купил этот лот, в своём чате. После возврата заказа коды ему больше не выдаются.
2. Или вручную: 🔑 Доступ → ➕ Добавить Chat ID — чаты FunPay, где команда сработает.

ШАГ 5. Шаг 3. Префикс

1. ⚙️ Настройки → ⌨️ Префикс команд. Например, команда rck с префиксом ! — покупатель пишет !rck.

ШАГ 6. Шаг 4. Проверка

1. /ecf_test или 🧪 Тест у аккаунта.

🕹️ Меню и кнопки

Меню /email_codes

• 📧 Аккаунты — ящики: «➕ IMAP аккаунт», «➕ POP3 аккаунт», «➕ Gmail OAuth», «🧪 Тест», «🗑»
• ⚙️ Настройки — окно поиска, сколько помнить код, пауза между запросами, префикс, «🔒 По списку / 🌐 Все чаты»
• 🔑 Доступ — чаты FunPay, где работают команды ящиков без лота: «➕ Добавить Chat ID», «🧹 Очистить»
• 📜 Логи — кому и когда выданы коды

🔄 Как это работает

1. Покупатель пишет команду ящика с префиксом, например !rck.
2. Ящик привязан к лоту — бот проверяет, что у покупателя есть оплаченный или подтверждённый заказ этого лота и он не возвращён.
3. Иначе — что чат в списке доступа (или включены все чаты).
4. Проверяет лимит кодов на чат и паузу между запросами.
5. Ищет письмо за окно поиска по фильтрам и логину и присылает код; нового нет — последний найденный с временем получения.

💬 Как это выглядит

Покупателю в чат FunPay

🔑 Код: 48213 (получен в 14:05)

Если нового письма нет

🔑 Последний код: 48213 (получен в 13:58, новый не найден)

⌨️ Команды

• префикс + команда — покупатель получает код, например !rck
• /email_codes — меню плагина
• /ecf_guide — встроенный гайд
• /mail_opt N поле значение — логин, фильтры с «|» и лимит кодов у ящика N

💡 Важно знать

• ⚠️ Привязывайте ящик к лоту по ID: по части названия код получат покупатели всех ваших лотов, в названии которых есть эти слова.
• Если FunPay не ответил при проверке заказа, бот не выдаёт код, а просит покупателя повторить через минуту.
• Для Gmail, Яндекса и Mail.ru нужен пароль приложения, а не обычный пароль.

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

Код не находится

Проверьте фильтр писем и окно поиска — письмо должно прийти за последние N минут. Для Gmail нужен пароль приложения, а не обычный пароль.

Покупатель пишет команду — бот молчит

Скорее всего, его чата нет в 🔑 Доступ: по умолчанию команды работают только в чатах из списка. Переключатель «🔒 По списку / 🌐 Все чаты» в ⚙️ Настройках снимает ограничение. Проверьте и префикс: команда rck с префиксом ! — это !rck.

Покупатель получил «Запрос слишком частый»?

Между запросами одного чата должно пройти не меньше 10 секунд (🐢 Rate limit в ⚙️ Настройках).

Насколько старое письмо подойдёт?

Бот ищет письма за последние 15 минут — ⏱ Окно поиска в ⚙️ Настройках.