Mail OAuth & Email Log для WooCommerce — письма магазина через Microsoft 365 и Gmail и журнал писем заказов

Mail OAuth & Email Log для WooCommerce отправляет письма магазина — подтверждения заказов, письма учётных записей, уведомления других плагинов — через ваш почтовый ящик и записывает каждое письмо в журнал. Подключить можно Microsoft 365 / Outlook.com (через Microsoft Graph API или SMTP AUTH) и Google Workspace / Gmail (через Gmail API) со входом OAuth 2.0 — пароль ящика не вводится и не хранится, — а также любой SMTP-сервер: ящик хостинга, Brevo, Mailgun, Amazon SES, Postmark.

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

Зачем OAuth. Microsoft объявила об отключении входа по паролю (Basic authentication) для SMTP AUTH в Exchange Online и советует перейти на OAuth 2.0 или Microsoft Graph; актуальные даты — в документации Microsoft. Магазин, который отправляет письма с ящика Microsoft 365 по логину и паролю, тогда перестанет их отправлять — и без журнала об этом узнают от покупателей, не получивших подтверждение.

Чего плагин не обещает. «Отправлено» в журнале значит, что Microsoft, Google или SMTP-сервер приняли письмо для доставки. Не попало ли письмо в спам у покупателя, плагин не видит. Внешний вид писем WooCommerce он не меняет.

Нужно посмотреть, как выглядит письмо заказа, и отправить тестовую копию? Это делает отдельный модуль Email Preview для WooCommerce. Mail OAuth & Email Log отвечает за доставку: через какой ящик идёт письмо, принял ли его почтовый сервис и что делать, если не принял.

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

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

С подключением Microsoft или Google отправителем становится ящик, в который вы вошли: Microsoft отклоняет другие адреса, если у учётной записи нет права Send As, а Gmail подставляет собственный адрес. Если ящик может отправлять от псевдонима или общего ящика, это включается флажком в настройках. Копии Bcc сохраняются на каждом подключении; через Microsoft Graph они уходят как настоящие скрытые получатели.

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

Что получает админ

• Подключения — Microsoft 365 / Outlook.com, Google Workspace / Gmail, SMTP-сервер или «Стандартно для сервера»: PHP mail() хостинга, как у WordPress без плагинов, но с журналом.
• Microsoft 365 / Outlook.com — через Microsoft Graph API (HTTPS, порт 443 — работает, когда хостинг блокирует SMTP-порты) или SMTP AUTH с XOAUTH2 (тогда можно отправлять от общего ящика). Бизнес-ящики и личные учётные записи Outlook.com.
• Google Workspace / Gmail — через Gmail API с самым узким разрешением Gmail: только отправлять письма от вашего имени.
• Собственное приложение — вы регистрируете его в своём Microsoft Entra или Google Cloud по пошаговой инструкции на экране, Redirect URI копируется кнопкой. Токены идут от Microsoft или Google прямо на ваш сайт, client secret и токены хранятся зашифрованными.
• Тестовое письмо через сохранённое подключение: «принято для доставки» или точный ответ сервиса.
• Присмотр за входом — токены обновляются раз в сутки, даже когда писем нет (Microsoft завершает вход после 90 дней без использования, Google — после шести месяцев); дата окончания client secret Microsoft с предупреждением за 14 дней; подсказка, если приложение Google осталось в статусе «Testing»; уведомление в админке и тест в «Здоровье сайта», когда подключение потеряло вход.
• Другой почтовый плагин — если активен WP Mail SMTP, FluentSMTP, Post SMTP или другой такой плагин, экран назовёт его: два почтовых плагина не могут одновременно отправлять письма WordPress.

• Бокс «Письма покупателю и магазину» на каждом заказе (HPOS и классический экран заказа): какое письмо, кому, статус, через какое подключение, когда, и «Просмотр» — письмо таким, каким оно ушло.
• Письма, которых не было — «Не отправлено: письмо выключено» или «Не отправлено: нет получателя» (например, заказ без e-mail): ответ на вопрос «почему покупатель ничего не получил?» виден прямо на странице заказа.

• Журнал писем — каждое письмо WordPress и плагинов: дата, от кого, кому, Cc, Bcc, тема, кто отправил (тип письма WooCommerce или плагин), заказ, подключение, результат, точная ошибка и каждая попытка.
• Фильтры и поиск — «Проблемы», «Отправлено», «Ошибка», «Не отправлено», «Только письма WooCommerce»; поиск по адресу, теме или номеру заказа.
• Просмотр письма — HTML в изолированном фрейме или текст, со всеми заголовками и попытками.
• Хранение — срок в днях (по умолчанию 30), переключатель «Сохранять содержимое писем», размер журнала и «Удалить весь журнал». Письма покупателя входят в «Экспорт» и «Удаление персональных данных» WordPress, а в руководстве по политике конфиденциальности появляется готовый текст.
• Доступ — менеджер магазина видит письма заказов; письма учётных записей (сброс пароля, новые аккаунты) и другие письма сайта — только администраторы.

• Pro: очередь повторных попыток — письмо, которое почтовый сервис не принял, уходит ещё раз через 5 мин, 15 мин, 1 ч, 3 ч, 12 ч…; от 2 до 10 попыток (по умолчанию 5); только письма WooCommerce или все письма. Адрес, который сервис отклонил, повторно не пробует.
• Письма ждут входа — пока подключение ждёт нового входа в Microsoft или Google, письма ждут тоже (до 7 дней) и уходят сразу после входа; попытки при этом не тратятся.
• Заметки в заказе — о повторе, доставке с N-й попытки и о письме, которое так и не дошло. Доставленное повторно письмо «Новый заказ» ставит собственную отметку WooCommerce об отправленном письме, поэтому последующая смена статуса не отправит магазину дубль.

• Pro: отправить ещё раз — любое письмо из журнала или из бокса заказа тем же получателям или копию на другой адрес.
• Pro: новая копия письма заказа — письмо собирается заново из актуальных данных заказа: покупателю — обработка, выполнение, удержание, детали заказа, отмена, неудачный заказ; магазину — новый, отменённый, неудачный заказ. Штатные действия заказа WooCommerce позволяют повторно отправить только детали заказа покупателю и уведомление о новом заказе.
• Pro: резервное подключение любого типа — например, SMTP хостинга за Microsoft 365: когда основное не справилось, письмо уходит через него, в том числе когда вложения слишком велики для Microsoft Graph (3 МБ) или загрузки в Gmail (5 МБ).

• Pro: колонка «Письмо» в списке заказов отмечает заказы, письма которых ждут повтора или не дошли, — их видно, не открывая каждый заказ.

• Pro: уведомления — на e-mail (несколько адресов через запятую) и в Telegram: письмо заказа покупателю или магазину не доставлено (номер заказа, какое письмо, ошибка, следующая попытка), очередь сдалась, подключению нужен новый вход, client secret скоро истечёт или работу взяло на себя резервное подключение.
• Уведомления не идут через сломанное подключение — когда проблема в основном, они уходят через резервное или PHP mail(). Адреса покупателей в уведомлениях скрыты. Когда подключение ломается и письма падают одно за другим, после трёх уведомлений за 15 минут приходит одна сводка в час, а не письмо на каждый заказ.

Как это работает — шаг за шагом

1. WooCommerce → Почта и журнал писем → Подключение (на сайте без WooCommerce — Настройки → Почта и журнал писем).
2. Выберите Microsoft 365 / Outlook.com, Google Workspace / Gmail, SMTP-сервер или «Стандартно для сервера».
3. Для Microsoft или Google раскройте инструкцию на экране: зарегистрируйте приложение в Microsoft Entra или Google Cloud (Redirect URI — кнопкой «Копировать»), вставьте client ID и client secret, нажмите «Сохранить и войти через Microsoft» (или Google) и войдите в ящик, с которого отправляет магазин. Для SMTP — сервер, порт, шифрование, логин и пароль.
4. «Отправить тестовое письмо» — плагин покажет, что ответил почтовый сервис.
5. С этого момента каждое письмо WordPress и WooCommerce идёт через это подключение и попадает в журнал вместе с заказом, к которому относится. Токен доступа плагин обновляет сам — перед окончанием и раз в сутки.
6. Покупатель не получил письмо? Откройте заказ: бокс «Письма покупателю и магазину» покажет, что случилось. В Pro неудачное письмо уже стоит в очереди, владелец получил уведомление, а новую копию можно отправить одной кнопкой.

Что под капотом

• Свой PHPMailer в wp_mail() — плагин подставляет собственный класс PHPMailer в каждый вызов wp_mail(), поэтому через него идут письма WordPress, WooCommerce и всех плагинов, которые отправляют почту стандартно: запись в журнал → основное подключение → в Pro резервное.
• OAuth 2.0 — authorization code с PKCE (S256); Redirect URI — просто адрес админки, без параметров запроса; токен доступа обновляется за две минуты до окончания под блокировкой, чтобы два запроса не обновляли его одновременно; отозванный вход помечает подключение «нужен новый вход», и следующие письма не дёргают Microsoft или Google впустую.
• Microsoft Graph — /me/sendMail в формате JSON с настоящими ccRecipients и bccRecipients; SMTP AUTH с XOAUTH2 — собственный SMTP-клиент со STARTTLS, работает с PHPMailer любой версии WordPress 6.2+; Gmail API — полное письмо в формате RFC 822 со строкой Bcc.
• Шифрование — client secret, пароль SMTP, токены и токен бота Telegram хранятся зашифрованными (libsodium, ключ выводится из солей WordPress). Если соли изменить, секрет нужно ввести снова и войти ещё раз.
• Контекст WooCommerce — тип письма, заказ и «покупателю или магазину» плагин берёт из woocommerce_mail_callback_params; выключенные письма и письма без адреса записываются отдельными строками.
• Журнал — собственная таблица. На 150 000 строк: страница журнала — 25 мс, поиск по номеру заказа — меньше 1 мс, поиск по адресу — 0,3 с. Ежедневная уборка удаляет старые строки и не трогает письма, которые ждут повтора.
• Pro: очередь — на Action Scheduler, который есть в WooCommerce, без него — WP-Cron; вложения для повтора копируются в папку со случайным названием и удаляются после доставки или через 7 дней.
• Удаление плагина — по умолчанию журнал и настройки остаются; с отметкой «Удалить журнал и все настройки при удалении плагина» удаляются таблица, настройки, задания крона и папка вложений.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите catcode-mail-oauth-email-log-for-woocommerce-free-1.0.0.zip и активируйте.
2. Если на сайте стоит другой почтовый плагин (WP Mail SMTP, FluentSMTP и т. п.), деактивируйте его — экран настроек подскажет, какой именно.
3. WooCommerce → Почта и журнал писем → Подключение: выберите сервис, пройдите короткую инструкцию на экране и нажмите «Сохранить и войти через…».
4. Отправьте тестовое письмо и проверьте входящие — вместе с папкой «Спам».
5. Для Pro: загрузите Pro-сборку плагина поверх бесплатной (WordPress предложит заменить установленную версию; журнал и вход сохраняются) и вставьте лицензионный ключ на вкладке «Pro-лицензия» — или нажмите там «Попробовать Pro 7 дней».