Brevo SMTP: vodnik po nastavitvi, nastavitvah in odpravljanju težav

Brevo SMTP odhodno pošto aplikacije premakne z lokalnega poštnega agenta spletnega gostitelja na infrastrukturo, ki vsako sporočilo avtenticira, beleži in o njem poroča. Postavitev je majhna: eno ime gostitelja, ena vrata, dve poverilnici. Napačna postavitev je prav tako majhna, načini odpovedi pa so tihi. Ta vodnik pokriva nastavitve, model poverilnic, delo z DNS, ki poskrbi za dostavo, in napake, na katere boste naleteli, če je karkoli napačno nastavljeno. Če ponudnika šele izbirate, širši vodnik po storitvah SMTP za e-pošto najprej primerja trg.

Kaj je Brevo SMTP

Brevo opisuje Brevo SMTP kot svojo relejno storitev SMTP. Vaša aplikacija, spletno mesto ali poštni strežnik sporočilo prek avtenticirane povezave izroči releju, Brevo pa prevzame odgovornost za usmerjanje, ponovne poskuse, ugled in poročanje. Statistika za relejano pošto se prikaže ob statistiki kampanj, trda zavrnitev pa ta stik samodejno uvrsti na seznam blokiranih.

Rele je zgrajen za transakcijska sporočila: ponastavitve gesel, potrdila, potrditve naročil, obvestila o računu. Če meja med temi in marketinško pošto še ni ostra, jo pokriva kaj je transakcijska e-pošta.

SMTP ali vmesnik REST API

Obe poti dosežeta isto platformo. Praktična delitev:

Ena trda omejitev: razvijalska dokumentacija Brevo navaja, da rele SMTP ne podpira paketnega pošiljanja, in paketne operacije usmerja na končne točke vmesnika API.

Ustvarjanje poverilnic SMTP

Avtentikacija Brevo SMTP uporablja dve vrednosti, ki ju je lahko zamenjati s poverilnicami, ki jih že imate.

Poiščite svojo prijavo SMTP

Vaša prijava SMTP ni e-poštni naslov vašega računa Brevo. Je ločen identifikator, prikazan v polju Login na strani Settings, SMTP and API, v obliki [email protected].

Iz tega sledita dve pravili, obe iz dokumentacije Brevo za odpravljanje težav. V polje za uporabniško ime ne vpisujte smtp-relay.brevo.com: to je gostitelj releja in ne vaša prijava. In svoje prijave SMTP ne vpisujte v glavo From, ker vas avtenticira in ne določa pošiljatelja.

Ustvarite ključ SMTP

Geslo je ključ SMTP, ne geslo vašega računa in ne ključ API.

1. Odprite spustni meni računa in izberite Settings, nato SMTP and API.
2. Na zavihku SMTP kliknite Generate a new SMTP key.
3. Ključ poimenujte po integraciji, ki ga bo uporabljala.
4. Izberite različico. Standard je priporočen 64-znakovni ključ, Short pa 15-znakovni ključ za odjemalce, ki ne prenesejo dolgih gesel.
5. Nastavite veljavnost med 7 dnevi in 1 letom ali izberite brez poteka.
6. Kliknite Generate, nato celoten ključ takoj kopirajte.

Celoten ključ je prikazan enkrat, nato stran prikazuje le zadnjih nekaj znakov. Če ga izgubite, ustvarite nadomestnega in posodobite svojo konfiguracijo.

Nastavitve povezave

Vrednosti, ki jih vnesete v katerikoli odjemalec ali knjižnico:

Izbira vrat

Brevo kot privzeta priporoča vrata 587. Vrata 465 so bila določena za SMTP prek SSL in pozneje opuščena, a ostajajo široko podprta in so prava izbira, kadar potrebujete šifrirano povezavo že pred prvim ukazom. Vrata 2525 niso registrirana pri IETF ali IANA, dovoli pa jih večina ponudnikov interneta in oblakov, kar jih naredi za zasilni izhod, ko so 587 blokirana.

Polje za šifriranje ljudi pogosto zmede. Brevo pravi, naj ga pustite prazno, razen če ste na 465. To ne pomeni, da je povezava nešifrirana: na 587 in 2525 strežnik oglašuje STARTTLS in vsak spodoben odjemalec povezavo nadgradi pred avtentikacijo. Pomeni le, da pri povezovanju na 587 ne smete izbrati „SSL”, ker neujemanje vrat in šifriranja povzroči neuspešno avtentikacijo tudi ob pravilnih poverilnicah.

Povezavo preizkusite, preden napišete kaj kode

Preden razhroščujete kodo aplikacije, potrdite, da se rele odziva in da se TLS vzpostavi.

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

Uspešno rokovanje se konča s seznamom zmožnosti 250 s strani strežnika, ki naj vsebuje STARTTLS in vrstico AUTH s postavkama PLAIN in LOGIN. Če pozdrava sploh ni, gre za omrežno težavo in ne za težavo s poverilnicami.

Avtentikacija vaše pošiljajoče domene

To je korak, ki ga ljudje preskočijo, in ta odloča, ali bo karkoli sploh prispelo. Od 1. februarja 2024 je avtentikacija domene obvezna po zahtevah za pošiljatelje pri Gmailu in Yahooju, Brevo pa navaja, da je Microsoft podobne standarde napovedal 5. maja 2025. Neavtenticirana pošta je filtrirana ali zavrnjena ne glede na to, kateri rele jo je poslal.

Zapisi, ki jih zahteva Brevo

Brevo jih lahko doda samodejno, če se v svojo domensko storitev prijavite iz Brevo, lahko pa vrednosti ročno prepišete v svojo cono DNS. Katero obliko DKIM dobite, je odvisno od računa: dva zapisa CNAME privzeto uporabljata 2048-bitni ključ, enojna oblika TXT pa 1024-bitni ključ.

Zakaj ni zapisa SPF

Pogosta vprašanja Brevo so izrecna: zapisa SPF in MX za avtentikacijo domene nista potrebna in sta na voljo le pri vzpostavitvi namenskega naslova IP. Na deljeni infrastrukturi povratno pot nadzoruje Brevo, zato avtentikacijo nosita DKIM in preverjanje lastništva. Če se selite od ponudnika, ki je zahteval vključitev SPF, je ne izmišljujte; nepotrebna vključitev le tvega težavo z omejitvijo števila poizvedb.

DMARC še vedno šteje in Brevo objavlja delujoč začetni zapis:

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

Začnite pri p=none za zbirna poročila brez tveganja za dostavo, nato zaostrite na quarantine in reject, ko so vsi zakoniti viri usklajeni. To napredovanje pokriva naš vodnik po dostavljivosti e-pošte.

Potrdite pošiljatelja

Vsak naslov v polju From mora biti potrjen pošiljatelj ali pa mora biti na avtenticirani domeni. Nov pošiljatelj se potrdi s 6-mestno kodo, poslano na ta naslov, pošiljatelji na avtenticirani domeni pa ta korak preskočijo, zato domeno avtenticirate najprej. Domen brezplačne pošte ni mogoče avtenticirati, zato bo naslov From na gmail.com ali outlook.com zavrnjen ali filtriran.

Vodiča po integraciji

WordPress

WordPress odhodno pošto izroči funkciji wp_mail, ta pa pokliče, kar ponuja gostitelj. Za usmeritev prek Brevo potrebujete vtičnik.

1. V skrbniški stranski vrstici pojdite na Plugins in nato Add New Plugin.
2. Poiščite Brevo, namestite „Newsletter, SMTP, Email marketing and Subscribe forms by Brevo” in ga aktivirajte.
3. Pojdite na Brevo in nato Home ter v aktivacijsko polje vnesite svoj ključ Brevo API v3. Ta korak uporablja ključ API, ker vtičnik sinhronizira tudi stike. Kliknite Login.
4. Pod Transactional emails izberite Yes.
5. Izberite obstoječega pošiljatelja ali ga ustvarite. Vsa e-pošta iz WordPressa uporablja to ime in naslov pošiljatelja.
6. Vnesite naslov in kliknite Send email, da sprožite preizkus.

Pogosti sta dve napaki. Sporočilo, da transakcijska e-pošta ni aktivirana, ker vaš račun Brevo SMTP še ni bil aktiviran, pomeni, da mora platformo vklopiti podpora Brevo. Sporočilo, da SMTP ni mogoče uporabiti, ker je funkcijo wp_mail že prijavil drug proces, pomeni konkurenčni vtičnik SMTP; ostale deaktivirajte enega za drugim.

Strežniška aplikacija

Lasten primer Brevo za Node.js uporablja nodemailer in zgornje nastavitve:

const nodemailer = require("nodemailer");

const transporter = nodemailer.createTransport({
  host: "smtp-relay.brevo.com",
  port: 587,
  secure: false, // true za 465, false za druga vrata
  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: "Your order is confirmed",
    text: "Order 10482 is confirmed and ships within two business days.",
  });
  console.log("Message sent:", info.messageId);
}

sendOrderConfirmation().catch(console.error);

Bodite pozorni na secure: false pri vratih 587. Ta zastavica nadzoruje implicitni TLS in ne tega, ali je povezava šifrirana; nodemailer še vedno izda STARTTLS. Na true jo nastavite samo za 465.

Enakovreden primer v Pythonu s standardno knjižnico:

import smtplib, ssl
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme Support <[email protected]>"
msg["To"] = "[email protected]"
msg["Subject"] = "Your order is confirmed"
msg.set_content("Order 10482 is confirmed and ships within two business days.")

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 poverilnice bereta iz okolja, kar je tema naslednjega razdelka.

Varnost in menjava ključev

Brevo ključe SMTP obravnava kot gesla. Operativna pravila je vredno upoštevati dobesedno.

• En ključ na integracijo. Vsak ključ poimenujte po sistemu, ki ga uporablja, da razkritje ali ukinitev prekliče natanko eno stvar.
• Ključa nikoli ne dodajte v repozitorij. Okoljske spremenljivke, upravitelj skrivnosti ali shramba nastavitev vaše platforme. Ne v sistem za nadzor različic, ne v sledeno datoteko .env, ne na zaslonsko sliko.
• Menjajte brez izpada. Ustvarite nadomestnega, namestite, potrdite pošiljanje, nato izbrišite starega. Brisanje je nepovratno, brisanje ključa, ki je še v uporabi, pa takoj ustavi transakcijsko pošiljanje.
• Za premor integracije raje deaktivirajte kot brišite. Ključe je mogoče pozneje znova aktivirati.
• Pričakujte potek. Ključi lahko nosijo veljavnost od 7 dni do 1 leta, Brevo pa nedejavne ključe razveljavi po 90 dneh.

Za trdnejšo mejo lahko Brevo zavrne zahteve z neznanih naslovov IP. Seznam pooblaščenih naslovov je skupen za ključe API in SMTP, zato vse, kar dovolite, velja za oboje. Pri delovnih obremenitvah v vsebnikih ali oblaku bodite previdni: odhodni naslov je lahko prehod NAT in ne naslov IP instance, ki ga pričakujete, napaka pri tem pa povzroči zavrnitev 525 5.7.1 Unauthorized IP address.

Ekipe, ki Brevo uporabljajo ob spletni trgovini, sistemu CRM in podpornem pultu, na koncu upravljajo več ključev, pošiljateljev in domen hkrati. Tajo to konfiguracijo drži na enem mestu namesto na štirih nadzornih ploščah.

Omejitve pošiljanja in dušenje

Pošiljanje prek SMTP črpa iz e-poštnih kreditov vašega paketa. Na brezplačnem paketu to pomeni 300 poslanih e-poštnih sporočil na dan; omejitev se dnevno ponastavi, neporabljena pošiljanja pa se ne prenesejo naprej. Ko jo dosežete, Brevo do 1.000 nadaljnjih sporočil zadrži v čakalni vrsti za ponovni poskus in onkraj te vrste ne dostavi ničesar. Plačljivi paketi dnevno omejitev odpravijo, vodnik po cenah Brevo pa razčleni ravni.

Ko krediti povsem poidejo, so sporočila, oddana prek SMTP, zaustavljena in postavljena v čakalno vrsto namesto zavržena. Zaostanek najdete pod Transactional, nato Real time, nato Usage and plan, v razdelku Email queue.

Brevo objavlja trde omejitve zahtev za vmesnik REST API in ne za rele. Na splošni ravni POST /v3/smtp/email dovoli 1.000 zahtev na sekundo, preseganje omejitve pa vrne 429 Too Many Requests. Pot prek API vrača tudi glave z omejitvami zahtev, po katerih lahko uravnavate tempo, česar rele ne počne.

Spremljanje zavrnitev in pritožb

Relejana pošta je vidna pod Transactional, na straneh Statistics in Logs. Dogodki, ki zahtevajo odziv:

• Trda zavrnitev. Naslov je neveljaven in Brevo stik samodejno uvrsti na seznam blokiranih.
• Blokirano. Prejemnik se je prej pritožil, odjavil, povzročil trdo zavrnitev ali je bil ročno blokiran.
• Odloženo in mehka zavrnitev. Ponudnik je povezavo sprejel, sporočilo pa zadržal ali zavrnil. Ponavljajoče se odložitve pri enem ponudniku kažejo na težavo z ugledom in ne na težavo v kodi.

Poizvedovanje po dnevnikih se ne obnese pri rasti. Brevo podpira transakcijske webhooke, ki dogodke o dostavi, zavrnitvi, odpiranju in pritožbah v realnem času pošiljajo na vašo končno točko, kar je način, da svoje podatke o izključenih stikih ohranjate ažurne.

Številka, ki jo je treba spremljati, je stopnja pritožb zaradi neželene pošte. Gmail, Yahoo in Microsoft zahtevajo, da pošiljatelji ostanejo pod 0,3 %, Brevo pa priporoča spremljanje z orodjem Gmail Postmaster Tools. Okrevanje po prekoračitvi traja precej dlje kot preprečitev.

Odpravljanje težav

535 5.7.8 Authentication failed

Uporabniškega imena ali gesla ni bilo mogoče preveriti. Po verjetnosti:

• Namesto prijave SMTP v obliki [email protected] je bil uporabljen e-poštni naslov računa.
• V polje za uporabniško ime je bil prilepljen smtp-relay.brevo.com. Brevo to navaja kot enega najpogostejših vzrokov.
• Namesto ključa SMTP je bil uporabljen ključ API.
• Ključ ob kopiranju nosi zaključni presledek ali prelom vrstice.
• Nastavitev šifriranja se ne ujema z vrati.
• Ključ je bil razveljavljen po varnostnem opozorilu, v tem primeru ustvarite novega.

525 5.7.1 Unauthorized IP address

Blokiranje po IP je vklopljeno in povezovalni naslov ni pooblaščen. Dodajte ga, najprej pa preverite svoj resnični odhodni naslov, če aplikacija teče za NAT ali na platformi z vsebniki.

Ni odziva in ni pozdrava

Če se povezava TCP odpre, strežnik pa nikoli ne pošlje pozdrava 220, se avtentikacija ne more začeti in napaka je na vaši strani omrežja. Korporativni požarni zidovi včasih povezavo dovolijo in nato promet SMTP tiho zavržejo. AWS, Azure in Google Cloud na novih računih privzeto omejujejo odhodni SMTP. Zahtevajte odpravo omejitve ali preklopite na vrata 2525.

450, platforma ni aktivirana

Napaka pravi, da vaš račun SMTP še ni aktiviran ali da je vaša pošiljalna platforma trenutno onemogočena. Na novem računu transakcijsko pošiljanje zahteva ločen korak aktivacije s strani podpore Brevo. Na uveljavljenem računu to običajno pomeni suspenz, bodisi ker so nezaščiten obrazec napadli boti bodisi ker je račun kazal znake vdora.

Pošiljatelj zavrnjen

Preverite tri stvari: domena je avtenticirana, pošiljatelj je potrjen in glava From ni vaša prijava SMTP.

Pošta je sprejeta, a pristane med neželeno pošto

Delajte v tem vrstnem redu. Potrdite, da je pošiljajoča domena avtenticirana in da DKIM podpisuje. Potrdite, da je domena v polju From vaša in ne od ponudnika brezplačne pošte. Preverite svojo stopnjo pritožb v Postmaster Tools glede na prag 0,3 %. Vsebino si oglejte šele, ko so ta preverjanja čista, saj je skoraj nikoli prvi vzrok.

Namenski naslovi IP

Namenski naslov IP pomaga le pri visokem in stalnem obsegu. Preden prek njega resno pošiljate, ga je treba ogreti, potrebuje pa tudi pošiljalno poddomeno, ki se v vaših glavah pojavi kot domena mailed by in return path. To je edina konfiguracija, pri kateri Brevo priskrbi zapisa SPF in MX, poleg zapisov A, CNAME, DKIM in DMARC za to poddomeno.

Dve podrobnosti ljudi ujameta. Namenski naslov IP, nastavljen samo za marketinško e-pošto, vaša transakcijska sporočila postavi v čakalno vrsto, namesto da bi jih poslal, zato ga preklopite ali kupite drugega. In ločevanje transakcijskega od marketinškega usmerjanja zahteva bazen vsaj dveh naslovov IP z različnimi pošiljatelji, tako da šibko zanimanje za marketinško pošto ne more potegniti navzdol potrdil in ponastavitev gesel.

Kako to narediti prav že prvič

Avtenticirajte domeno, ustvarite poimenovan ključ SMTP, povežite se na smtp-relay.brevo.com prek 587 in pošljite preizkus po resnični poti v kodi in ne prek gumba na nadzorni plošči. Skoraj vsaka poznejša težava izvira iz ene od treh stvari.

• Napačna poverilnica v polju za uporabniško ime ali geslo.
• Nastavitvi vrat in šifriranja, ki si nasprotujeta.
• Pošiljajoča domena, ki ni bila nikoli avtenticirana.

Če te tri stvari uredite, rele izgine v ozadje, kar je natanko tisto, kar naj bi transakcijska infrastruktura počela.