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 днів».