Ръководство за потребителя на Symelo SMTP

За Symelo SMTP версия 1.0.0.

Това ръководство обяснява как да настроите Symelo SMTP, какво прави всяка опция и как сами да отстранявате проблеми с доставката. Последният раздел, „За разработчици“, описва константите в wp-config.php, куките (hooks) и командите на WP-CLI.

Нужда от помощ? Пишете на [email protected] или посетете symelo.com.

Какво прави Symelo SMTP

WordPress изпраща имейли (за смяна на парола, потвърждения на поръчки, съобщения от формите за контакт) с вградената в PHP функция mail(). Много хостинги я блокират, а спам филтрите не ѝ се доверяват, затова имейлите се губят.

Symelo SMTP вместо това изпраща всеки имейл от WordPress през истинска имейл услуга:

• SMTP (Simple Mail Transfer Protocol) е стандартният начин, по който пощенските сървъри общуват помежду си. Почти всеки имейл доставчик предлага SMTP сървър, в който можете да влезете с акаунта си.
• API мейлърите изпращат през уеб API на доставчика по обикновен HTTPS. Често са по-бързи и работят и при хостинги, които блокират SMTP портовете.
• OAuth мейлърите (Gmail и Microsoft 365) ви позволяват да влезете с акаунта си в Google или Microsoft, вместо да съхранявате парола.

Освен това Symelo SMTP:

• записва всеки имейл в журнал заедно със статуса му, така че виждате какво е изпратено, какво не е успяло и защо;
• автоматично опитва резервна връзка, когато основната откаже;
• изпраща сигнали в Slack, Discord, Microsoft Teams или към произволен webhook, когато имейл не бъде изпратен;
• има режим Log only за тестови (staging) сайтове, така че тестовите копия никога да не изпращат имейли до реални клиенти;
• обяснява честите грешки на разбираем език.

Изисквания

• WordPress 6.4 или по-нова версия.
• PHP 7.4 или по-нова версия. При по-стар PHP плъгинът остава неактивен и показва: „Symelo SMTP needs PHP 7.4 or newer.“
• Акаунт при имейл доставчик (или пощенската кутия от хостинга ви) и възможност сървърът ви да се свързва с него:
  • SMTP изисква отворен изходящ порт (обикновено 587 или 465). Някои хостинги ги блокират.
  • API мейлърите изискват изходящ HTTPS, който почти всеки хостинг позволява.
• За Gmail / Google Workspace и Microsoft 365 / Outlook: приложение в Google Cloud или Microsoft Entra, което създавате сами (обяснено по-долу).
• Само администраторите виждат и променят настройките на плъгина (правото manage_options). Разработчиците могат да променят това; вижте За разработчици.
• Работи и с мултисайт (Multisite). Всеки сайт в мрежата има свои настройки, връзки и журнал.

---

Бърз старт

Така само за няколко минути стигате от инсталирането до успешно изпратен тестов имейл.

1. Инсталиране и активиране

1. В wp-admin отидете в Разширения → Добавяне на разширение → Качване на разширение.
2. Изберете .zip файла на плъгина, натиснете Инсталиране, след това Активиране.

В страничното меню на администрацията се появява ново меню Symelo SMTP (с икона на плик).

2. Добавете първата си връзка

Връзката е един начин за изпращане на имейли: мейлър (доставчик) заедно с данните за вход и адреса на подателя.

1. Отидете в Symelo SMTP → Settings. Тъй като все още няма връзки, екранът се отваря директно на Set up email delivery с избора на мейлър.
2. Под Mailer щракнете върху плочката на вашия доставчик. Ако доставчикът ви не е в списъка, изберете Other SMTP.
3. Попълнете полетата на доставчика. Задължителните полета са отбелязани с червена звездичка (*). Линкът Setup guide до описанието на мейлъра отваря документацията на доставчика. Вижте Настройване на всеки доставчик, за да разберете откъде да вземете всяка стойност.
4. Под Sender попълнете From email: адрес, от който доставчикът ви позволява да изпращате (потребителското ви име за SMTP или адрес в домейн, който сте потвърдили при доставчика).
5. Оставете отметката Use this address for every email, even when a plugin sets its own From address. Това е най-сигурната настройка.
6. По желание задайте From name (например името на магазина ви) и Connection name (използва се само в администрацията и в журнала).
7. Натиснете Add connection.

Ще видите или „Connection saved.“, или „Connection saved, but it isn't ready yet:“, последвано от това, което липсва. Първата ви връзка автоматично става основната (Primary).

Само за Gmail и Microsoft 365: след запазване оставате на екрана на връзката. Натиснете Sign in with Google или Sign in with Microsoft в карето Authorization и разрешете достъпа. Първо прочетете Gmail / Google Workspace или Microsoft 365 / Outlook, защото трябва да създадете приложение при доставчика, преди да можете да влезете.

3. Изпратете тестов имейл

1. Отворете раздела Send a Test.
2. Полето Send to е попълнено с вашия собствен адрес. Променете го, ако желаете.
3. Оставете Connection на Normal routing (primary, then backup).
4. Натиснете Send test email.

Ако всичко е наред, ще видите Test email sent: „The provider accepted the email for … Check the inbox (and the spam folder).“ Ако изпращането е неуспешно, ще видите The test email failed с точната грешка, подсказки на разбираем език и опитите за доставка (Delivery attempts). Вижте Отстраняване на проблеми.

Това е всичко. Отсега нататък всеки имейл, изпратен от WordPress и вашите плъгини, минава през тази връзка и се появява в Email Log.

---

Къде да намерите всичко

Symelo SMTP има едно меню с две точки:

• Symelo SMTP → Settings: всички раздели с настройки на един екран. Разделите се превключват мигновено, без презареждане.
• Symelo SMTP → Email Log: журналът. Той използва същата лента с раздели, така че можете да стигнете до него и чрез раздела Email Log.

На екрана Разширения под Symelo SMTP има и линк Settings.

---

Раздел Connections

Обобщение на състоянието

Най-горната карта показва как се изпращат имейлите в момента:

• „Emails are sent through Name.“ и, ако сте задали резервна връзка, „If that fails, Name is tried next.“
• Червено съобщение след това, ако основната връзка има проблем (например липсваща парола).
• „No primary connection is selected, so emails are sent through the backup connection, Name, with nothing to fall back on. Choose a primary connection under Routing.“, когато има резервна, но няма основна връзка. Тогава имейлите минават само през резервната.
• „No primary connection is selected, so emails go out through the server's default mail setup.“, когато няма нито една от двете.

Бутонът Add connection отваря празен формуляр за връзка.

Списък с връзки

Действия за всеки ред:

• Edit (или View за връзка, дефинирана в wp-config.php).
• Send a test: отваря раздела Send a Test с вече избрана тази връзка.
• Delete: иска потвърждение, след което премахва връзката. При Gmail също отменя достъпа в Google; при Microsoft запазеният вход се изтрива. Ако изтритата връзка е била основна или резервна, тази роля остава празна. Без основна връзка имейлите минават само през резервната (картата със състоянието го показва), затова изберете нова Primary connection под Routing и натиснете Save routing.

Проблеми, които колоната Status може да покаже:

Маршрутизиране

Картата Routing се появява, след като имате поне една връзка.

След промяна на която и да е от двете натиснете Save routing. Резервната връзка не може да е същата като основната.

Ако в wp-config.php е дефинирана връзка, основната е фиксирана към нея: „Fixed to the connection defined in wp-config.php (SYMELO_SMTP_MAILER).“ Пак можете да изберете резервна.

Как работи резервната връзка: за всеки имейл Symelo SMTP първо опитва основната връзка. Само ако този опит е неуспешен, опитва резервната. И двата опита се записват в журнала под Delivery attempts. Всяка връзка изпраща със собствен адрес на подателя (From), така че резервна връзка при друг доставчик може да използва адрес, който този доставчик приема.

Добавяне или редактиране на връзка

Формулярът за връзка има четири части.

1. Mailer. Щракнете върху плочка, за да изберете доставчика. Задръжте курсора над плочка, за да видите кратко описание. Нова връзка започва с Other SMTP. Налични мейлъри:

Other SMTP, Gmail / Google Workspace, Microsoft 365 / Outlook, Amazon SES, Brevo, Mailgun, SendGrid, Postmark, SendLayer, Resend, SMTP2GO, SparkPost, Mailjet, PHP mail().

Ако смените мейлъра на съществуваща връзка, запазените тайни данни (пароли, ключове) на стария мейлър не се прехвърлят, а входът в Gmail или Microsoft се премахва.

2. Provider settings. Полетата за избрания мейлър. Вижте Настройване на всеки доставчик.

• Паролите, API ключовете и клиентските тайни (client secrets) никога не се показват отново след запазване. Полето показва „Saved. Leave blank to keep it.“ Оставете го празно, за да запазите съхранената стойност, или въведете нова, за да я замените.
• За Gmail и Microsoft 365 се появява каре Authorized redirect URI с бутон Copy. Добавете точно този адрес към вашето OAuth приложение, преди да влезете.

3. Sender. Доставчиците изпращат имейли само от адреси, на които имат доверие: вашето потребителско име за SMTP или адрес в домейн, който сте потвърдили при тях. Другите адреси се отхвърлят (например „You are not allowed to send from this address“).

4. Connection name. „Only shown here and in the email log. Defaults to the mailer's name.“ Името се показва само в администрацията и в журнала, а по подразбиране е името на мейлъра. Например „Mailgun (main)“.

Натиснете Add connection (за нова връзка) или Save connection (за съществуваща). Плъгинът проверява връзката и ви казва, ако нещо липсва. Невалиден From email не се запазва: „The From email isn't a valid address.“

Как се избира адресът на подателя

За всеки имейл адресът на подателя (From) се определя от връзката, която го изпраща:

Microsoft 365 / Outlook: ако From email не е пощенската кутия, с която сте влезли (например споделена пощенска кутия), кутията трябва да има право „Send As“ или „Send on Behalf“ за този адрес. Вижте Microsoft 365 / Outlook. Microsoft може да показва собственото показвано име на пощенската кутия вместо From name.

Упълномощаване (Gmail и Microsoft 365)

След като запазите връзка с Gmail или Microsoft 365, под формуляра се появява каре Authorization.

• Преди влизане: „Save the client ID and secret first, then sign in to allow this site to send email.“ Натиснете Sign in with Google или Sign in with Microsoft. Ако някое задължително поле все още е празно (например Tenant при Microsoft), ще видите „Finish the connection settings first:“, последвано от това, което липсва.
• След влизане: значка Connected и „Signed in as [email protected].“ Натиснете Disconnect, за да премахнете входа (при Google достъпът се отменя в самия Google; Microsoft няма прост начин за отмяна, затова токените се изтриват от сайта ви).

Влезте от същия браузър и със същия администраторски акаунт, от който сте започнали, и завършете в рамките на 10 минути. В противен случай ще видите „The sign-in link expired or was already used. Try again.“

След като сте влезли, плъгинът поддържа входа активен: ежедневна фонова задача опреснява входовете, които не са използвани 7 дни, за да не ги прекрати доставчикът поради неактивност.

---

Раздел Send a Test

Използвайте този раздел, за да проверите връзка, без да чакате истински имейл.

Натиснете Send test email. Темата е „Symelo SMTP test from името на сайта ви“.

Карето с резултата показва:

• Test email sent: доставчикът е приел имейла. Проверете входящата поща и папката за спам. „Приет“ означава, че доставчикът го е поел; доставката във входящата поща след това зависи от доставчика и от пощенския сървър на получателя.
• Test email logged, not sent: включен е режимът Log only, затова имейлът е само записан в журнала.
• The test email failed: грешката, до две подсказки как да я отстраните и Delivery attempts.
• Delivery attempts: по един ред за всяка опитана връзка, отбелязан с Accepted или Failed. Отворете Technical details, за да видите SMTP комуникацията или отговора на доставчика (паролите и ключовете са скрити).

Бележки:

• В режим Log only тест с Normal routing само се записва, без да се изпраща: „'Log only' mode is on, so the email to … was recorded in the log but not sent. Pick a specific connection to test real delivery.“ Тест през Only Name наистина изпраща имейл, дори в режим Log only.
• Ако резултатът казва „Symelo SMTP didn't handle this email“, друг плъгин поема имейлите на WordPress. Вижте Активен е друг SMTP плъгин.

---

Журнал на имейлите (Email Log)

Отидете в Symelo SMTP → Email Log.

Списъкът

Най-горе: Sent in the last 7 days, Failed in the last 7 days и, ако има такива, Logged only, not sent.

Ако журналът е изключен, предупреждение казва „Logging is turned off, so new emails aren't recorded.“ с линк към настройките в Logging.

Начини да стесните списъка:

• Изгледи по статус над таблицата: All, Sent, Failed, Not sent (log only) (изгледът се показва само когато има записи).
• Search emails: търси в темата, получателите, адреса на подателя и текста на грешката.
• Две полета за дата и Filter: показват имейлите между две дати.
• Сортиране по Subject, Status или Date с щракване върху заглавието на колоната.
• Настройки на екрана (горе вдясно): брой записи на страница, 20 по подразбиране, до 200.

Действия за ред: View, Resend (само за имейли, чието съдържание е запазено), Delete. За да изтриете много записи наведнъж, отметнете ги и изберете Delete от груповите действия.

Export to CSV изтегля записите, които отговарят на текущите филтри, с колоните Date (UTC), Status, From, To, Subject, Connection, Mailer, Sent by и Error. Текстът на съобщенията не се експортира.

Един запис

Щракнете върху тема, за да видите:

• Темата и статуса, а при неуспешните имейли и грешката с подсказки.
• Date, From, To, Cc, Bcc, Reply-To, Connection, Sent by, Message ID и Duration.
• Attachments: имена и размери на файловете. Самите файлове никога не се съхраняват.
• Message: безопасен преглед на HTML имейла. „Remote images are blocked for your privacy.“ Натиснете Load them, за да покажете изображенията от други сайтове, и Block them, за да ги скриете отново. Показва се и Plain-text version, когато имейлът има такава.
• Extra headers: допълнителните заглавки (headers), които е имал имейлът.
• Delivery attempts с Technical details.

Ако текстът не е запазен: „The content wasn't stored (Logging → Content is off).“

Повторно изпращане

Resend изпраща записания имейл отново през текущото маршрутизиране (не непременно през връзката, използвана първия път), до същите получатели и със същите тема, текст и заглавки.

• Прикачените файлове не се съхраняват, затова не се изпращат повторно: „Email resent, without its attachments (they aren't stored in the log).“
• Можете да изпращате повторно само имейли, чието съдържание е запазено, затова Resend се появява само за тях, както в списъка, така и в самия запис.
• Повторното изпращане създава нов запис в журнала. В режим Log only повторно изпратеният имейл само се записва.

---

Раздел General

Заглавието Sender в този раздел само напомня, че адресът и името на подателя се задават поотделно за всяка връзка, и съдържа линк Edit connections.

Ако режимът е зададен в wp-config.php, изборът е неактивен (в сиво) с текст „Set by SYMELO_SMTP_DELIVERY in wp-config.php.“

Натиснете Save Changes.

---

Раздел Logging

Натиснете Save Changes.

Delete all log entries изтрива всички записи в журнала наведнъж (след потвърждение).

---

Раздел Alerts

Сигналите ви уведомяват, когато имейл не бъде изпратен, дори ако сайтът ви изобщо не може да изпраща имейли, защото се изпращат в чат приложение или към webhook, а не по имейл.

Канали за сигнали

Съществуващите канали са изброени с техните Type и Destination (показва се само името на хоста на webhook-а, защото пълният адрес е таен). Действия: Send test alert и Remove.

За да добавите канал, под Add a channel:

Натиснете Add channel, след това Send test alert, за да го проверите. Можете да добавите до 10 канала.

Всеки сигнал съдържа името на сайта, темата на имейла, получателите, връзката, грешката и линк към записа в журнала.

Ограничаване на честотата

Натиснете Save Changes.

---

Раздел Advanced

Криптиране

Паролите, API ключовете, OAuth токените и адресите на webhook-овете за сигнали се съхраняват криптирани в базата данни. Тази карта показва кой ключ ги защитава:

• Dedicated key: криптирани са с SYMELO_SMTP_KEY от wp-config.php. Това е най-сигурният вариант: копие само на базата данни не може да ги разкрие.

• Site salt: криптирани са с ключ, извлечен от солите (salts) на сайта ви (тайните ключове в wp-config.php). Картата показва готов ред със случаен ключ, който можете да поставите в wp-config.php:

  define( 'SYMELO_SMTP_KEY', '…64 random characters…' );
  

  Ключът трябва да е дълъг поне 32 знака. Готовият е с 64.

Ако SYMELO_SMTP_KEY е дефиниран, но е по-кратък от 32 знака, той се пренебрегва и се използват солите на сайта. Тогава картата показва предупреждение („SYMELO_SMTP_KEY in wp-config.php is ignored because it's shorter than 32 characters…“) над нов ключ, с който да го замените, а „Здраве на сайта“ също го отчита.

След добавяне или смяна на ключа нищо от криптираното със стария ключ вече не може да бъде прочетено. Картата ви напомня за това. Трябва да направите следното:

1. Въведете отново всяка запазена парола, API ключ и клиентска тайна (редактирайте всяка връзка).
2. Влезте отново във връзките с Gmail и Microsoft 365.
3. Премахнете и добавете отново каналите за сигнали, които показват „Unreadable, add it again“.

Деинсталиране

Натиснете Save Changes. Вижте Отмяна и деинсталиране.

Конфигуриране с константи

Агенциите и разработчиците могат вместо това да настроят Symelo SMTP в wp-config.php. Картата изброява всички поддържани константи. Вижте За разработчици.

---

Раздел Support

• Get help: линкове към Send a test email, View failed emails и Check Site Health, както и бутон Email support ([email protected]).
• System information: текстов отчет с версиите, режима на доставка, връзките (типовете мейлъри, без тайни данни), настройките на журнала, броя имейли за последната седмица, последния неуспех, типа на ключа за криптиране, другите активни SMTP плъгини и данни за сървъра. Никога не включва пароли, API ключове или токени. Натиснете Copy system information и поставете отчета в имейла си до поддръжката.
• About Symelo LTD: линк към symelo.com.

---

Джаджа в таблото, известия и Здраве на сайта

Джаджа в таблото

Email delivery в таблото на WordPress показва „Last 7 days: X sent, Y failed.“, последния неуспех (ако има такъв) и линкове към Email log и Send a test. Показва се на администраторите, докато журналът е включен.

Известия в администрацията

Те се показват в Табло, на екрана Разширения и на собствените екрани на плъгина (двете известия за липсваща основна връзка се показват само извън екраните на плъгина, защото там разделът Connections вече го казва):

Здраве на сайта

Инструменти → Здраве на сайта включва четири проверки на Symelo SMTP:

Здраве на сайта → Информация → Symelo SMTP показва версията, основния и резервния мейлър, режима на доставка, журнала и дали е зададен отделен ключ (или дали е твърде кратък).

---

Настройка на всеки доставчик

Общи съвети, валидни за всеки доставчик:

• Преди да започнете, потвърдете при доставчика домейна, от който изпращате (или поне адреса на подателя). Непотвърдените адреси на подателя са най-честата причина имейлите да бъдат отхвърлени.
• За инструкциите на самия доставчик използвайте връзката Setup guide във формуляра на връзката.
• Таблата на доставчиците се променят често. Ако някое име на меню по-долу не съвпада точно, потърсете най-близкото до него.

Other SMTP

Използвайте го за всеки SMTP сървър: пощенската кутия при вашия хостинг, Zoho, Fastmail или SMTP relay на доставчик.

Времето за изчакване на SMTP връзките е 20 секунди.

Готови настройки в Fill in settings for:

За повечето от тези доставчици специалният API мейлър по-долу е по-добър избор от SMTP: той работи дори когато хостингът ви блокира SMTP портовете.

Gmail / Google Workspace (OAuth)

Изпраща през Gmail API с вашия Google акаунт. Не се съхранява парола: влизате с Google, а плъгинът пази криптиран токен за достъп. Работи както с лични Gmail акаунти, така и с акаунти в Google Workspace.

Полета:

Права (scopes), които плъгинът иска:

• https://www.googleapis.com/auth/gmail.send: само изпращане на имейли. Плъгинът не може да чете пощенската ви кутия.
• openid и email: за да разбере с кой адрес сте влезли.

Стъпки:

1. Отворете Google Cloud Console и създайте проект (или изберете съществуващ).
2. Включете Gmail API за проекта.
3. Отворете Google Auth platform и настройте екрана за съгласие:
   • Google Workspace: задайте аудиторията на Internal. Само хора от вашата организация могат да влизат, а достъпът не изтича.
   • Личен Gmail: задайте аудиторията на External, добавете себе си като тестов потребител, ако бъдете попитани, и натиснете Publish app. В режим „Testing“ Google прекратява достъпа след 7 дни.
4. Отидете в Clients → Create client, изберете Web application и в authorized redirect URIs поставете Authorized redirect URI от формуляра на връзката. Адресът трябва да съвпада точно.
5. Копирайте Client ID и Client secret във формуляра на връзката, попълнете подателя (Sender) и натиснете Add connection (или Save connection).
6. В блока Authorization натиснете Sign in with Google, изберете акаунта и разрешете изпращането на имейли. Тъй като приложението е ваше собствено, Google може да предупреди, че не го е проверил; можете да продължите.
7. Връщате се във връзката: „Connected. Signed in as [email protected].“

Адрес на подателя: оставете From email празно, за да изпращате от името на акаунта, с който сте влезли. Ако зададете друг адрес, използвайте такъв, който сте добавили в Gmail като псевдоним „Send mail as“; иначе Google може да го замени с адреса на акаунта.

Лимити: имейли до 35 MB, включително прикачените файлове. Важат и дневните лимити за изпращане на самия Gmail. Когато бъдат достигнати, се показва „Gmail's sending limit was reached. It can take several hours to reset.“ (нулирането на лимита може да отнеме няколко часа).

Microsoft 365 / Outlook (OAuth)

Изпраща през Microsoft Graph с пощенска кутия в Microsoft 365 или Outlook.com. Изпратените имейли се запазват и в папката Sent Items („Изпратени“) на пощенската кутия.

Полета:

Ако Tenant е common и влизането се провали с AADSTS50194 („…isn't configured as a multitenant application…“), приложението ви е single tenant: въведете вместо това неговия Directory (tenant) ID. Съобщението за грешка също го казва.

Права (scopes), които плъгинът иска: Mail.Send и User.Read (делегирани права за Microsoft Graph), плюс openid, email и offline_access (за да продължи входът да работи без ваше участие). Когато връзката има From email и Tenant не е consumers, плъгинът иска и Mail.Send.Shared, което Microsoft изисква за изпращане от друг адрес.

Стъпки:

1. Отворете Microsoft Entra admin center и отидете в App registrations → New registration.
2. Дайте име на приложението и изберете поддържаните типове акаунти.
3. Добавете redirect URI с платформа Web и поставете Authorized redirect URI от формуляра на връзката.
4. В API permissions добавете делегираните права за Microsoft Graph Mail.Send и User.Read, както и Mail.Send.Shared, ако ще изпращате от друг адрес (например от споделена пощенска кутия). Ако организацията ви го изисква, дайте администраторско съгласие (admin consent).
5. В Certificates & secrets → New client secret създайте тайна и веднага копирайте нейното Value.
6. Попълнете Application (client) ID, Client secret и Tenant (вижте таблицата по-горе), задайте подателя в Sender (или оставете From email празно, за да изпращате от името на пощенската кутия, с която ще влезете) и натиснете Add connection (или Save connection).
7. Натиснете Sign in with Microsoft, изберете пощенската кутия и приемете.

Какво трябва да знаете:

• Адрес на подателя: оставете From email празно, за да изпращате от името на пощенската кутия, с която сте влезли. За да изпращате от друг адрес, например от споделена пощенска кутия, въведете го като From email. Тогава пощенската кутия, с която сте влезли, се нуждае от право „Send As“ или „Send on Behalf“ за този адрес (дава го администратор на Microsoft 365), а след задаването на адреса трябва да влезете отново, за да включва входът Mail.Send.Shared. Личните акаунти в Outlook.com могат да изпращат само от собствения си адрес.
• Без това право изпращането се проваля с ErrorSendAsDenied: „The signed-in mailbox isn't allowed to send from this From email. Either leave the connection's From email empty (or enter the signed-in mailbox), or have a Microsoft 365 admin give the mailbox "Send As" or "Send on Behalf" permission for this address, then open the connection and sign in with Microsoft once more.“
• Microsoft може да показва собственото показвано име на пощенската кутия вместо From name. За да промените името, което виждат получателите, сменете показваното име на пощенската кутия в Microsoft 365.
• Пощенската кутия се нуждае от лиценз за Exchange Online. При другите грешки 403 съобщението гласи: „The mailbox may not have an Exchange Online license, or the sign-in is missing a permission. Open the connection and sign in again.“
• Тайните на клиента (client secrets) изтичат (най-късно след 24 месеца). Добавете нова тайна преди това и я въведете във връзката.
• Имейлите са ограничени до 4 MB, включително прикачените файлове.
• Ако сайтът ви използва постоянни връзки Обикновени, redirect URI съдържа ?rest_route= и под него се появява предупреждение. Microsoft не приема redirect URI с query string за приложения, в които влизат лични акаунти на Microsoft. Изберете друга структура в Настройки → Постоянни връзки, след което копирайте новия адрес.

Amazon SES

Евтино изпращане на големи обеми от AWS, през SES v2 API.

Новите SES акаунти започват в „sandbox“ и могат да изпращат само до потвърдени адреси. Поискайте от AWS production access, преди да пуснете сайта на живо.

Лимити: 50 получатели на имейл (To, Cc и Bcc общо), 40 MB на имейл.

Brevo

Бившият Sendinblue.

• Адресът на подателя трябва да е потвърден в Brevo.
• Brevo може да блокира API заявки от непознати IP адреси. Ако получите грешка HTTP 401, проверете ключа и разрешете IP адреса на сървъра си в Security → Authorized IPs.
• Brevo приема само един Reply-To адрес; използва се първият.
• Лимит: 20 MB на имейл.

Mailgun

Грешен регион или домейн води до грешка HTTP 401 или 404: „Check the API key, the sending domain, and that the region matches where the domain was created.“ Лимит: 25 MB на имейл.

SendGrid

Подателят трябва да е потвърден Sender Identity. Лимит: 30 MB на имейл.

Postmark

Лимити: 50 получатели на имейл, 10 MB на имейл.

SendLayer

Изпращайте от адрес в домейн, разрешен в SendLayer. Лимити: 10 получатели в „to“, 10 в „cc“ и 5 в „bcc“ на имейл, 10 MB на имейл.

Resend

Домейнът на подателя трябва да е потвърден в Resend. Лимити: 50 получатели в „to“ на имейл, 40 MB на имейл.

SMTP2GO

Лимит: 50 MB на имейл.

SparkPost

Symelo SMTP изпраща през SparkPost като транзакционен имейл, с изключено проследяване на отварянията и кликванията. Лимит: 20 MB на имейл.

Mailjet

Адресът на подателя трябва да е валидиран в Mailjet. Mailjet приема само един Reply-To адрес; използва се първият. Лимити: 50 получатели на имейл, 15 MB на имейл.

PHP mail()

Вградената функция за поща на сървъра. Не са нужни настройки („No settings needed.“), но доставяемостта е слаба и много хостинги не я поддържат. Използвайте я само като резервна връзка в краен случай. From email не е задължително за този мейлър: ако остане празно, имейлите запазват адреса на подателя, зададен от WordPress или от плъгина, който ги изпраща.

Лимитите накратко

Symelo SMTP проверява тези лимити преди изпращане, така че получавате ясна грешка вместо отхвърлена заявка.

Тире означава, че Symelo SMTP сам не проверява лимит; лимитите на доставчика пак важат. Времето за изчакване на API заявките е 30 секунди.

---

Практически рецепти

Изпращане през Brevo с резервна връзка

1. В Brevo потвърдете домейна или адреса на подателя и създайте API ключ (Settings → SMTP & API → API keys).
2. В WordPress отидете в Symelo SMTP → Settings и натиснете Add connection.
3. Изберете Brevo, поставете API key, въведете потвърдения си адрес в From email, наречете връзката „Brevo“ и натиснете Add connection.
4. Натиснете отново Add connection и настройте резервната връзка, например Other SMTP с пощенската кутия при хостинга ви или втори доставчик. Задайте ѝ собствен From email, който този доставчик приема.
5. В Routing задайте Primary connection да е Brevo, а Backup connection – втората връзка. Натиснете Save routing.
6. В Send a Test изберете Only име на резервната връзка и изпратете тест, за да се уверите, че резервната връзка работи и самостоятелно.
7. Изпратете още един тест с Normal routing (primary, then backup).

Когато Brevo откаже, записът в журнала показва два опита в Delivery attempts: неуспешния опит през Brevo и приетия опит през резервната връзка.

Как да не се изпращат имейли от staging сайт

Вариант А, в администрацията:

1. На staging сайта отидете в Symelo SMTP → Settings → General.
2. В Mode изберете Log only: record emails but never send them и натиснете Save Changes.

Вариант Б, в wp-config.php (по-добрият избор за агенции, защото оцелява при копиране на базата данни от живия сайт):

define( 'SYMELO_SMTP_DELIVERY', 'log_only' );

Добавете това в wp-config.php на staging сайта, преди да импортирате базата данни на живия сайт, така че копието да не може да изпрати нищо междувременно. Тогава настройката Mode е заключена: „Set by SYMELO_SMTP_DELIVERY in wp-config.php.“

И в двата случая:

• Имейлите се появяват в журнала със статус Not sent (log only), а предупредително съобщение ви напомня, че имейлите не се доставят.
• Тест с Normal routing само се записва в журнала. Тест през Only Име наистина изпраща, затова го използвайте само със собствения си адрес.

Съобщение в Slack при неуспешен имейл

1. В Slack създайте incoming webhook за желания канал и копирайте неговия URL.
2. Отидете в Symelo SMTP → Settings → Alerts.
3. В Add a channel задайте Type на Slack, поставете Webhook URL и натиснете Add channel.
4. Натиснете Send test alert. В Slack трябва да видите „Symelo SMTP test alert from вашия сайт“.
5. Променете At most one alert every … minutes, ако искате повече или по-малко известия по време на срив.

Всички имейли от вашия домейн, без да се губят отговорите

Плъгините за контактни форми и онлайн магазини често задават адреса на посетителя или клиента като адрес на подателя. Доставчиците отхвърлят такива имейли.

1. Редактирайте връзката.
2. Въведете в From email адрес от потвърдения си домейн, например [email protected].
3. Оставете отметнато Use this address for every email, even when a plugin sets its own From address.
4. Запазете.

Отговорите пак стигат до правилния човек, когато плъгинът задава Reply-To адрес (Contact Form 7 и WooCommerce го правят).

По-малко лични данни в журнала на имейлите

1. Отидете в Settings → Logging.
2. Махнете отметката от Store the message body, за да се пазят само получателите, темата и статусът. (Тогава няма да можете да преглеждате и да изпращате повторно имейли.)
3. Намалете Keep entries for до броя дни, които наистина са ви нужни.
4. Натиснете Save Changes.
5. По желание натиснете Delete all log entries, за да изтриете вече съхраненото.

Настройка на клиентски сайт в wp-config.php

Когато връзката е дефинирана в wp-config.php, данните за вход не са в базата данни и редакторите на сайта не могат да ги променят.

define( 'SYMELO_SMTP_MAILER', 'mailgun' );
define( 'SYMELO_SMTP_API_KEY', 'your-key' );
define( 'SYMELO_SMTP_DOMAIN', 'mg.example.com' );
define( 'SYMELO_SMTP_REGION', 'eu' );
define( 'SYMELO_SMTP_FROM_EMAIL', '[email protected]' );
define( 'SYMELO_SMTP_FROM_NAME', 'Example Ltd' );

Връзката се показва като „Defined in wp-config.php“, винаги е основна и в администрацията може само да се преглежда. Settings → Advanced → Configure with constants изброява всички константи. Вижте За разработчици.

---

Отстраняване на проблеми

Започнете оттук

1. Изпратете тест от Send a Test. Резултатът показва точната грешка и подсказки.
2. Или отворете неуспешния имейл в Email Log. Грешката, подсказките и Delivery attempts са най-горе.
3. Отворете Technical details под опита, за да видите SMTP комуникацията или отговора на доставчика.

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

Чести грешки

Symelo SMTP разпознава тези грешки и показва съответната подсказка:

Тестът казва „sent“, но имейлът така и не пристига

„Accepted“ означава, че доставчикът е приел имейла. Ако той не пристига:

• Проверете папката за спам.
• Проверете журнала с активността при самия доставчик; там се вижда дали сървърът на получателя е приел имейла, или го е върнал.
• Уверете се, че домейнът на адреса на подателя е потвърден при доставчика (SPF и DKIM записи). Имейлите от непотвърдени домейни често попадат в спама.
• Проверете дали режимът на доставка не е Log only (тогава статусът в журнала ще е Not sent (log only)).

Gmail спира да работи след 7 дни

Приложението ви в Google Cloud е в режим „Testing“. Публикувайте го („In production“) или задайте аудиторията му на „Internal“, ако използвате Google Workspace. След това отворете връзката и влезте отново.

Microsoft 365 внезапно спира да работи

• Грешки „AADSTS…“ след месеци безпроблемна работа обикновено означават, че тайната на клиента е изтекла. Създайте нова тайна в Microsoft Entra, въведете нейното Value във връзката и запазете.
• ErrorSendAsDenied означава, че From email е адрес, от чието име пощенската кутия, с която сте влезли, няма право да изпраща. Оставете From email празно или дайте на пощенската кутия право „Send As“ или „Send on Behalf“ и влезте отново. Вижте Microsoft 365 / Outlook.

Проблеми с входа (Gmail и Microsoft 365)

Ако адресът на сайта ви се промени (нов домейн или преминаване от http към https), redirect URI също се променя. Обновете го в приложението си в Google или Microsoft и влезте отново.

Запазената стойност вече не може да бъде декриптирана

Виждате „The saved value can't be decrypted any more (the site's keys changed). Enter it again.“ или „… can no longer be decrypted …“.

Тайните се криптират с SYMELO_SMTP_KEY или, ако той липсва, със salt ключовете на сайта ви. Ако ключът или salt ключовете са се променили (някои плъгини за сигурност ги сменят периодично, а сайт, копиран на нов сървър, може да има различни ключове в wp-config.php), старите стойности не могат да бъдат прочетени. Въведете отново паролите и ключовете, влезте отново при OAuth връзките и добавете наново каналите за известия, отбелязани с „Unreadable, add it again“. Отделен SYMELO_SMTP_KEY (копиран заедно със сайта) предотвратява това занапред.

Активен е друг SMTP плъгин

Само един плъгин може да управлява имейлите на WordPress. Здраве на сайта съобщава „More than one SMTP plugin is active“, когато открие WP Mail SMTP, WP Mail SMTP Pro, FluentSMTP, Post SMTP, Easy WP SMTP, GoSMTP, SMTP Mailer, WP Offload SES Lite или SureMail. Деактивирайте останалите.

Ако тест покаже „Symelo SMTP didn't handle this email. Another plugin may be taking over wp_mail(); deactivate other SMTP plugins.“, друг плъгин е прихванал имейла, преди Symelo SMTP да го види.

Известията не пристигат

• Натиснете Send test alert. Грешките се показват: „The test alert failed: …“ или „The webhook answered with HTTP …“.
• Webhook адресът трябва да е публичен https:// адрес. Адреси в локалната ви мрежа се отказват.
• По време на срив се изпраща само по едно известие за период на ограничение (по подразбиране 60 минути).

Все още не работи?

Отидете в раздела Support, натиснете Copy system information и изпратете информацията заедно с описание на проблема на [email protected].

---

Поверителност и сигурност

Какво се съхранява и къде

Криптирането използва libsodium с SYMELO_SMTP_KEY от wp-config.php или с ключ, извлечен от salt ключовете на сайта ви. Тайните никога не се изпращат обратно към браузъра: полетата за тайни остават празни след запазване.

Журналът на имейлите пази за всеки имейл: дата, статус, адрес и име на подателя, всички получатели (To, Cc, Bcc, Reply-To), тема, допълнителни заглавки, имена и размери на прикачените файлове (никога самите файлове), използваните връзка и мейлър, изпращащия плъгин, идентификатора на съобщението при доставчика, евентуална грешка и опитите за доставка. При включено Content пази и съдържанието на съобщението (до 1 MB). Debug изходът в Technical details никога не съдържа съдържанието на имейла (то се заменя с „[message content omitted]“), а паролите, ключовете и токените са маскирани.

Записите в журнала се изтриват след периода на съхранение (по подразбиране 30 дни). Ако Keep entries for е 0, те се пазят, докато не ги изтриете.

Какво се изпраща и къде

• Вашите имейли отиват при доставчика на връзката, която ги изпраща. API заявките се идентифицират с user agent SymeloSMTP/<version>, който включва адреса на сайта ви.
• Вход в Gmail / Microsoft 365: браузърът ви отива на страницата за вход на Google или Microsoft. След това сайтът ви обменя входа за токени директно с Google или Microsoft, научава имейл адреса на акаунта ви и по-късно подновява токените при тях. Прекъсването или изтриването на Gmail връзка също така иска от Google да отмени входа.
• Известията отиват на въведените от вас webhook адреси: име и адрес на сайта, темата и получателите на неуспешния имейл, името на връзката, грешката и линк към записа в журнала.
• Нищо не се изпраща никъде, докато не добавите връзка или канал за известия, а плъгинът никога не изпраща нищо на Symelo LTD.

Инструменти за GDPR

• Инструменти → Експортиране на лични данни включва записите от „Symelo SMTP email log“, изпратени до или от посочения адрес (дата, подател, получатели, тема и текст на съобщението).
• Инструменти → Изтриване на лични данни изтрива тези записи от журнала.
• Настройки → Поверителност предлага текст за политиката ви за поверителност, който описва журнала на имейлите. Текстът следва настройката Keep entries for: „Log entries are deleted automatically after 30 days.“ или, при 0, „Log entries are kept until the site owner deletes them.“

Безопасен преглед на записаните имейли

Записаните HTML имейли се показват в изолирана рамка за преглед, която не може да изпълнява скриптове, а отдалечените изображения са блокирани, докато не натиснете Load them. Това ви пази от проследяващи пиксели и злонамерено съдържание в записаните имейли.

Бележки за сигурността

• Всяко действие в администрацията проверява дали сте администратор и използва защитата на WordPress с nonce срещу фалшифицирани заявки.
• OAuth използва authorization code flow с PKCE, а входът е обвързан с администратора, който го е започнал.
• CSV експортите неутрализират формулите за електронни таблици.

---

Отмяна и деинсталиране

• Спиране на използването на връзка: променете Routing или изтрийте връзката. Ако изтриете всички връзки, отново влиза в сила стандартната настройка за поща на WordPress.
• Спиране на изпращането без деинсталиране: превключете General → Mode на Log only.
• Деактивиране: WordPress веднага се връща към стандартния си начин на изпращане на имейли. Настройките, връзките и журналът остават в базата данни, така че при повторно активиране всичко се възстановява. Ежедневната задача за почистване спира.
• Изтриване (Разширения → Изтриване):
  • Ако Advanced → Uninstall → Delete all settings and logs when the plugin is deleted е включено: настройките, връзките, OAuth входовете, таблицата с журнала на имейлите и временните данни се изтриват. При multisite собствената настройка на всеки сайт определя какво става с неговите данни.
  • Ако е изключено (по подразбиране): настройките и журналът остават в базата данни, така че при повторно инсталиране продължавате оттам, докъдето сте стигнали.
  • И в двата случая се изтриват личните предпочитания на потребителите (затворени съобщения, брой записи на страница).

Изтриването на плъгина не отменя достъпа на приложението, което сте създали в Google или Microsoft. Първо натиснете Disconnect на тези връзки или премахнете достъпа на приложението в настройките на акаунта си.

---

За разработчици

Константи в wp-config.php

Константите имат предимство пред екрана с настройки и заключват съответните полета.

Връзка. Дефинирането на SYMELO_SMTP_MAILER създава връзка само за четене с име „Defined in wp-config.php“ (ID wp-config), която винаги е основната връзка.

Полетата, които не дефинирате, получават стойностите по подразбиране на мейлъра. Ако SYMELO_SMTP_MAILER сочи непознат мейлър, константите се игнорират, а екраните на плъгина и Здраве на сайта показват предупреждение със стойността и валидните ID на мейлъри. Връзките с Gmail и Microsoft, дефинирани по този начин, все пак изискват еднократно Sign in with … от екрана View.

Общи и криптиране:

Действия

Филтри

WP-CLI

REST API

Symelo SMTP регистрира един публичен маршрут, GET /wp-json/symelo-smtp/v1/oauth. Той е адресът за OAuth пренасочването и само препраща отговора на Google или Microsoft към wp-admin, където се проверяват влезлият администратор и заявката за вход. Няма REST API за управление на настройките.

Съдържание на заявката към Webhook (JSON)

Каналите за известия от тип Webhook (JSON) получават POST заявка с Content-Type: application/json:

{
  "event": "email_failed",
  "site": "My Site",
  "site_url": "https://example.com/",
  "time": "2026-10-12T09:30:00+00:00",
  "subject": "Your order",
  "recipients": "[email protected]",
  "connection": "Brevo",
  "error": "Brevo rejected the email (HTTP 401): …",
  "log_url": "https://example.com/wp-admin/admin.php?page=symelo-smtp-log&view=123",
  "suppressed": 0
}

event е test при тестовите известия. suppressed е броят неуспехи, пропуснати заради ограничението на честотата след последното известие. При зададена тайна за подписване заглавката X-Symelo-Signature е sha256=, последвано от шестнадесетичния HMAC-SHA256 на суровото тяло на заявката.

Планирана задача

symelo_smtp_daily се изпълнява веднъж дневно: изтрива записите в журнала, по-стари от периода на съхранение, и опреснява OAuth входовете, които не са използвани 7 дни. Премахва се при деактивиране.