Brevo SMTP: vodič za podešavanje, parametre i rešavanje problema

Brevo SMTP izmešta odlaznu poštu aplikacije sa lokalnog poštanskog agenta veb hostinga na infrastrukturu koja autentifikuje, beleži i izveštava o svakoj poruci. Podešavanje je malo: jedno ime hosta, jedan port, dva akreditiva. I pogrešiti je jednako malo, a načini otkazivanja su tihi. Ovaj vodič pokriva parametre, model akreditiva, rad na DNS zapisima koji omogućava isporuku, i greške na koje ćete naleteti ako je bilo koji deo loše podešen. Ako još birate provajdera, širi vodič kroz SMTP imejl servise prvo poredi tržište.

Šta je Brevo SMTP

Brevo opisuje Brevo SMTP kao svoj SMTP relejni servis. Vaša aplikacija, sajt ili poštanski server predaje poruku releju preko autentifikovane veze, a Brevo preuzima odgovornost za usmeravanje, ponovne pokušaje, reputaciju i izveštavanje. Statistika za relejiranu poštu pojavljuje se uz statistiku kampanja, a tvrdo odbijanje automatski stavlja taj kontakt na listu blokiranih.

Relej je napravljen za transakcione poruke: resetovanje lozinke, potvrde, potvrde porudžbina, obaveštenja o nalogu. Ako granica između njih i marketinške pošte još nije oštra, šta je transakcioni imejl to pokriva.

SMTP ili REST API

Obe putanje stižu do iste platforme. Praktična podela:

Jedno tvrdo ograničenje: programerska dokumentacija platforme Brevo navodi da SMTP relejni server ne podržava grupno slanje i upućuje grupne operacije na krajnje tačke API-ja.

Kreiranje SMTP akreditiva

SMTP autentifikacija u platformi Brevo koristi dve vrednosti koje se lako mešaju sa akreditivima koje već imate.

Pronađite svoj SMTP nalog za prijavu

Vaš SMTP nalog za prijavu nije imejl adresa vašeg Brevo naloga. To je poseban identifikator prikazan u polju Login na stranici Settings, SMTP and API, u formatu [email protected].

Iz toga slede dva pravila, oba iz dokumentacije za rešavanje problema. Nemojte upisivati smtp-relay.brevo.com u polje za korisničko ime: to je adresa releja, a ne vaš nalog za prijavu. I nemojte stavljati svoj SMTP nalog za prijavu u zaglavlje From, jer on vas autentifikuje, a ne identifikuje pošiljaoca.

Generišite SMTP ključ

Lozinka je SMTP ključ, ne lozinka vašeg naloga i ne API ključ.

1. Otvorite padajući meni naloga i izaberite Settings, pa SMTP and API.
2. Na kartici SMTP kliknite na Generate a new SMTP key.
3. Nazovite ključ po integraciji koja će ga koristiti.
4. Izaberite varijantu. Standard je preporučeni ključ od 64 znaka; Short je ključ od 15 znakova, za klijente koji ne podnose duge lozinke.
5. Postavite rok važenja između 7 dana i 1 godine, ili izaberite bez isteka.
6. Kliknite na Generate, pa odmah kopirajte ceo ključ.

Ceo ključ se prikazuje jednom, nakon čega stranica pokazuje samo poslednjih nekoliko znakova. Ako ga izgubite, generišite zamenu i ažurirajte svoju konfiguraciju.

Parametri veze

Vrednosti koje unosite u bilo koji klijent ili biblioteku:

Izbor porta

Brevo preporučuje 587 kao podrazumevani. Port 465 je bio namenjen za SMTP preko SSL protokola i kasnije je zastareo, ali je i dalje široko podržan i pravi je izbor kada vam treba veza šifrovana pre prve komande. Port 2525 nije registrovan kod IETF ni IANA organizacije, ali ga većina provajdera i klaud platformi dozvoljava, što ga čini izlazom u nuždi kada je 587 blokiran.

Polje za šifrovanje ljude zbunjuje. Brevo vam kaže da ga ostavite prazno osim ako ste na 465. To ne znači da je veza nešifrovana: na 587 i 2525 server oglašava STARTTLS i svaki iole sposoban klijent nadograđuje vezu pre autentifikacije. Znači da ne treba da birate „SSL” dok se povezujete na 587, jer nepodudarnost porta i šifrovanja obara autentifikaciju i sa ispravnim akreditivima.

Testirajte vezu pre pisanja ijedne linije koda

Potvrdite da relej odgovara i da se TLS uspostavlja pre nego što otklanjate greške u kodu aplikacije.

openssl s_client -starttls smtp -crlf -connect smtp-relay.brevo.com:587

Uspešno rukovanje završava se serverskom listom mogućnosti 250, koja bi trebalo da uključi STARTTLS i liniju AUTH sa navedenim PLAIN i LOGIN. Potpuni izostanak odgovora je mrežni problem, a ne problem sa akreditivima.

Autentifikacija vašeg domena za slanje

Ovo je korak koji ljudi preskaču, a on odlučuje da li išta stiže. Od 1. februara 2024. autentifikacija domena je obavezna prema zahtevima za pošiljaoce koje postavljaju Gmail i Yahoo, a Brevo navodi da je Microsoft najavio slične standarde 5. maja 2025. Neautentifikovana pošta biva filtrirana ili odbijena bez obzira na to koji relej ju je poslao.

Zapisi koje Brevo traži

Brevo može da doda ove zapise automatski ako se iz platforme Brevo prijavite kod svog registrara domena, ili ih možete ručno prepisati u svoju DNS zonu. Koji oblik DKIM zapisa dobijate zavisi od naloga: dva CNAME zapisa podrazumevano koriste ključ od 2048 bita, a jedan TXT oblik ključ od 1024 bita.

Zašto nema SPF zapisa

Odgovori na česta pitanja platforme Brevo su izričiti: SPF i MX zapisi nisu potrebni za autentifikaciju domena i daju se samo kada podešavate namensku IP adresu. Na deljenoj infrastrukturi Brevo kontroliše povratnu putanju, pa DKIM plus provera vlasništva nose autentifikaciju. Ako prelazite sa provajdera koji je zahtevao SPF include, nemojte ga izmišljati; nepotreban include samo rizikuje problem sa ograničenjem broja pretraga.

DMARC i dalje ima značaja, a Brevo objavljuje početni zapis koji radi:

v=DMARC1; p=none; rua=mailto:[email protected]

Počnite sa p=none radi zbirnih izveštaja bez rizika po isporuku, pa pooštrite na quarantine i reject kada svaki legitimni izvor bude usklađen. Naš vodič za isporučivost imejla pokriva taj redosled.

Verifikujte pošiljaoca

Svaka From adresa mora da bude verifikovani pošiljalac ili da bude na autentifikovanom domenu. Novi pošiljalac se verifikuje šestocifrenim kodom poslatim na tu adresu, ali pošiljaoci na autentifikovanom domenu preskaču taj korak, zbog čega prvo autentifikujete domen. Besplatni imejl domeni ne mogu da se autentifikuju, pa će From adresa na gmail.com ili outlook.com biti odbijena ili filtrirana.

Vodiči kroz integracije

WordPress

WordPress predaje odlaznu poštu funkciji wp_mail, koja poziva ono što hosting nudi. Za usmeravanje kroz Brevo potreban je dodatak.

1. U bočnoj traci administracije idite na Plugins, pa Add New Plugin.
2. Potražite Brevo, instalirajte „Newsletter, SMTP, Email marketing and Subscribe forms by Brevo”, pa ga aktivirajte.
3. Idite na Brevo, pa Home, i unesite svoj Brevo API ključ v3 u polje za aktivaciju. Ovaj korak koristi API ključ jer dodatak takođe sinhronizuje kontakte. Kliknite na Login.
4. U odeljku Transactional emails izaberite Yes.
5. Izaberite postojećeg pošiljaoca ili napravite novog. Svaka WordPress poruka koristi to ime i adresu pošiljaoca.
6. Unesite adresu i kliknite na Send email da biste pokrenuli probu.

Dve greške su česte. Poruka da transakcioni imejlovi nisu aktivirani jer vaš Brevo SMTP nalog nije aktiviran znači da podrška platforme Brevo mora da uključi tu mogućnost. Poruka da SMTP ne može da se koristi jer je wp_mail već deklarisao drugi proces znači da postoji konkurentski SMTP dodatak; deaktivirajte ostale jedan po jedan.

Aplikacija na strani servera

Sopstveni primer za Node.js platforme Brevo koristi nodemailer i parametre navedene iznad:

const nodemailer = require("nodemailer");

const transporter = nodemailer.createTransport({
  host: "smtp-relay.brevo.com",
  port: 587,
  secure: false, // tačno za 465, netačno za ostale portove
  auth: {
    user: process.env.BREVO_SMTP_LOGIN, // [email protected]
    pass: process.env.BREVO_SMTP_KEY,
  },
});

async function sendOrderConfirmation() {
  const info = await transporter.sendMail({
    from: '"Acme Support" <[email protected]>',
    to: "[email protected]",
    subject: "Vaša porudžbina je potvrđena",
    text: "Porudžbina 10482 je potvrđena i šalje se u roku od dva radna dana.",
  });
  console.log("Poruka poslata:", info.messageId);
}

sendOrderConfirmation().catch(console.error);

Obratite pažnju na secure: false na portu 587. Ta zastavica kontroliše implicitni TLS, a ne to da li je veza šifrovana; nodemailer i dalje izdaje STARTTLS. Postavite true samo za 465.

Ekvivalent u Python jeziku sa standardnom bibliotekom:

import smtplib, ssl
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme Support <[email protected]>"
msg["To"] = "[email protected]"
msg["Subject"] = "Vaša porudžbina je potvrđena"
msg.set_content("Porudžbina 10482 je potvrđena i šalje se u roku od dva radna dana.")

with smtplib.SMTP("smtp-relay.brevo.com", 587, timeout=20) as server:
    server.starttls(context=ssl.create_default_context())
    server.login(BREVO_SMTP_LOGIN, BREVO_SMTP_KEY)
    server.send_message(msg)

Oba primera čitaju akreditive iz okruženja, što je tema sledećeg odeljka.

Bezbednost i rotacija ključeva

Brevo tretira SMTP ključeve kao lozinke. Operativna pravila vredi pratiti doslovno.

• Jedan ključ po integraciji. Nazovite svaki ključ po sistemu koji ga koristi, tako da curenje ili gašenje povuče tačno jednu stvar.
• Nikada ne stavljajte ključ u repozitorijum. Promenljive okruženja, menadžer tajni ili skladište konfiguracije vaše platforme. Ne kontrola verzija, ne praćena .env datoteka, ne snimak ekrana.
• Rotirajte bez prekida rada. Generišite zamenu, postavite je u rad, potvrdite slanje, pa obrišite stari ključ. Brisanje je nepovratno, a brisanje ključa koji je još u upotrebi odmah zaustavlja transakciono slanje.
• Deaktivirajte umesto da brišete da biste pauzirali integraciju. Ključevi mogu kasnije ponovo da se aktiviraju.
• Očekujte istek. Ključevi mogu da nose rok važenja od 7 dana do 1 godine, a Brevo gasi neaktivne ključeve nakon 90 dana.

Za tvrđu granicu, Brevo može da blokira zahteve sa nepoznatih IP adresa. Lista odobrenih adresa deli se između API i SMTP ključeva, pa se sve što dozvolite odnosi na oboje. Budite pažljivi kod kontejnerskih ili klaud opterećenja: izlazna adresa može biti NAT mrežni prolaz, a ne IP adresa instance koju očekujete, a greška tu proizvodi odbijanje 525 5.7.1 Unauthorized IP address.

Timovi koji uz Brevo vode i prodavnicu, CRM i korisničku podršku na kraju istovremeno upravljaju sa nekoliko ključeva, pošiljalaca i domena. Tajo drži tu konfiguraciju na jednom mestu umesto na četiri komandne table.

Ograničenja slanja i prigušivanje

Slanje preko SMTP servera troši imejl kredite vašeg plana. Na besplatnom planu to znači 300 poslatih poruka dnevno; ograničenje se resetuje svakodnevno i neiskorišćena slanja se ne prenose. Kada ga dostignete, Brevo drži do 1.000 daljih poruka u redu za ponovni pokušaj i ne isporučuje ništa preko tog reda. Plaćeni planovi uklanjaju dnevno ograničenje, a vodič kroz Brevo cene razlaže nivoe.

Kada krediti potpuno nestanu, poruke predate preko SMTP servera pauziraju se i stavljaju u red umesto da budu odbačene. Zaostatak stoji u odeljku Transactional, pa Real time, pa Usage and plan, u sekciji Email queue.

Brevo objavljuje tvrda ograničenja broja zahteva za REST API, a ne za relej. Na opštem nivou POST /v3/smtp/email dozvoljava 1.000 zahteva u sekundi, a prekoračenje vraća 429 Too Many Requests. Putanja preko API-ja vraća i zaglavlja sa ograničenjima prema kojima možete da odmeravate tempo, što relej ne radi.

Praćenje odbijanja i pritužbi

Relejirana pošta vidljiva je u odeljku Transactional, na stranicama Statistics i Logs. Događaji koji traže reakciju:

• Tvrdo odbijanje. Adresa je neispravna, a Brevo automatski stavlja kontakt na listu blokiranih.
• Blokirano. Primalac se ranije žalio, odjavio, imao tvrdo odbijanje ili je ručno blokiran.
• Odloženo i meko odbijanje. Provajder je prihvatio vezu, ali je poruku odložio ili odbio. Ponavljajuća odlaganja kod jednog provajdera signaliziraju problem sa reputacijom, a ne problem u kodu.

Anketiranje dnevnika ne skalira. Brevo podržava transakcione webhookove koji u realnom vremenu šalju događaje isporuke, odbijanja, otvaranja i pritužbi na vašu krajnju tačku, i tako održavate sopstvene podatke o suzbijanju aktuelnim.

Broj koji treba pratiti je stopa prijava neželjene pošte. Gmail, Yahoo i Microsoft zahtevaju da pošiljaoci ostanu ispod 0,3%, a Brevo preporučuje praćenje kroz Gmail Postmaster Tools. Oporavak od prekoračenja traje daleko duže nego njegovo izbegavanje.

Rešavanje problema

535 5.7.8 Authentication failed

Korisničko ime ili lozinka nisu mogli da se provere. Po verovatnoći:

• Upotrebljena je imejl adresa naloga umesto SMTP naloga za prijavu u formatu [email protected].
• smtp-relay.brevo.com je nalepljen u polje za korisničko ime. Brevo to navodi kao jedan od najčešćih uzroka.
• Upotrebljen je API ključ umesto SMTP ključa.
• Ključ nosi prateći razmak ili prelom reda nastao kopiranjem.
• Podešavanje šifrovanja ne odgovara portu.
• Ključ je poništen nakon bezbednosnog upozorenja, u kom slučaju generišite novi.

525 5.7.1 Unauthorized IP address

Blokiranje po IP adresi je aktivno, a adresa sa koje se povezujete nije odobrena. Dodajte je, i prvo proverite svoju stvarnu izlaznu adresu ako aplikacija radi iza NAT-a ili na kontejnerskoj platformi.

Nema odgovora i nema pozdravne poruke

Ako se TCP veza otvori, ali server nikada ne pošalje svoj pozdrav 220, autentifikacija ne može ni da počne, a kvar je na vašoj strani mreže. Korporativni zaštitni zidovi ponekad dozvole vezu, pa tiho odbace SMTP saobraćaj. AWS, Azure i Google Cloud podrazumevano ograničavaju odlazni SMTP saobraćaj na novim nalozima. Zatražite ukidanje tog ograničenja ili pređite na port 2525.

450, platforma nije aktivirana

Greška kaže da vaš SMTP nalog još nije aktiviran ili da je vaša platforma za slanje trenutno onemogućena. Na novom nalogu transakciono slanje zahteva poseban korak aktivacije od podrške platforme Brevo. Na ustaljenom nalogu to obično znači suspenziju, bilo zato što je nezaštićen formular napadnut prijavama botova, bilo zato što je nalog pokazao znake kompromitovanja.

Pošiljalac odbijen

Proverite tri stvari: da li je domen autentifikovan, da li je pošiljalac verifikovan i da zaglavlje From nije vaš SMTP nalog za prijavu.

Pošta se prima, ali sleće u neželjenu poštu

Radite ovim redom. Potvrdite da je domen za slanje autentifikovan i da DKIM potpisuje. Potvrdite da je From domen vaš, a ne besplatni imejl provajder. Proverite svoju stopu pritužbi u alatu Postmaster Tools u odnosu na prag od 0,3%. Sadržaj gledajte tek kada te provere budu čiste, jer je on skoro nikada prvi uzrok.

Namenske IP adrese

Namenska IP adresa pomaže samo pri velikom i ujednačenom obimu. Mora da se zagreje pre nego što kroz nju značajnije šaljete, i traži poddomen za slanje koji se u vašim zaglavljima pojavljuje kao mailed by i return path domen. Ovo je jedina konfiguracija u kojoj Brevo daje SPF i MX zapise, uz A, CNAME, DKIM i DMARC zapise za taj poddomen.

Dva detalja ljude iznenade. Namenska IP adresa podešena samo za marketinški imejl stavlja vaše transakcione poruke u red umesto da ih šalje, pa je prebacite ili kupite drugu adresu. I razdvajanje transakcionog od marketinškog usmeravanja zahteva skup od najmanje dve IP adrese sa različitim pošiljaocima, kako slabo angažovanje na marketinškoj pošti ne bi povuklo naniže potvrde i resetovanja lozinki.

Kako da bude ispravno iz prve

Autentifikujte domen, napravite imenovani SMTP ključ, povežite se na smtp-relay.brevo.com preko 587 i pošaljite probu kroz pravu putanju u kodu, a ne dugmetom na komandnoj tabli. Skoro svaki kasniji problem vodi ka jednoj od tri stvari.

• Pogrešan akreditiv u polju za korisničko ime ili lozinku.
• Podešavanje porta i šifrovanja koja se međusobno ne slažu.
• Domen za slanje koji nikada nije autentifikovan.

Postavite to ispravno i relej nestaje u pozadini, što je upravo ono što transakciona infrastruktura treba da radi.