Files
sorsfonalak/docs/levelkuldes.md
T

61 lines
4.2 KiB
Markdown
Raw Normal View History

# Levélküldés élesben (meghívók, értesítések)
Élesben most nincs levélküldő beállítva (`SMTP_URL` üres), így minden levél az `email_outbox` táblában vár. Amíg ez így van, a meghívót kézzel is továbbadhatod: az admin „Meghívók” oldala küldés után kiírja a linket („Link másolása”).
A meghívó a legkényesebb levéltípus, mert a címzett nem kérte. A spammappát elsősorban a feladó hírneve és a domain hitelesítése dönti el, a sablon csak ezután számít. Ezért kell a lenti négy lépés.
## 1. Levélküldő szolgáltatás
Javaslat: **Brevo** (EU-s, napi 300 levélig ingyenes; egy induló, meghívásos oldalnak bőven elég). Ha később fontosabb lesz a kézbesítési arány, a Postmark (fizetős) a legjobb; a beállítás ugyanígy megy.
A **DigitalOcean** a dropleteken alapból tiltja a kimenő SMTP-portokat (25, 465, 587), ezért a **2525-ös portot** kell használni; ezt a Brevo és a Postmark is tudja.
A droplet saját tűzfala (`sorsfonalak-fw`, DigitalOcean → Networking → Firewalls) a kimenő forgalmat is szűri: az **Outbound rules** közé fel kell venni a **TCP 2525**-öt (cél: All IPv4, All IPv6), különben a worker nem éri el a levélküldőt.
1. Brevo-fiók létrehozása.
2. *Senders, Domains & Dedicated IPs → Domains → Add a domain*: `sorsfonalak.hu`. A Brevo kiírja a szükséges DNS-rekordokat (lásd 2. pont).
3. *Senders*: feladó felvétele, javaslat: `hello@sorsfonalak.hu`. A `noreply` cím a szűrőknél rosszabb, és válaszolni sem lehet rá.
4. *SMTP & API → SMTP*: itt van az SMTP-login (`…@smtp-brevo.com` alakú) és egy új **SMTP-kulcs** (ez a jelszó).
## 2. DNS a Cloudflare-en
A rekordokat a Brevo pontosan megadja; ezek szoktak lenni:
| Típus | Név | Tartalom |
|---|---|---|
| TXT | `sorsfonalak.hu` | `brevo-code:…` (a domain igazolása) |
| CNAME | `brevo1._domainkey` | a Brevo által megadott cél (DKIM) |
| CNAME | `brevo2._domainkey` | a Brevo által megadott cél (DKIM) |
| TXT | `_dmarc` | `v=DMARC1; p=none; rua=mailto:<a te címed>` |
- A CNAME-ek legyenek **DNS only** (szürke felhő), különben a DKIM nem működik.
- SPF: ha a Brevo kér SPF-et, egy domainnek csak **egy** `v=spf1` rekordja lehet, a szolgáltatókat abba kell összevonni (például `v=spf1 include:spf.brevo.com ~all`).
- DMARC: induláskor `p=none` (csak jelentés). Ha pár hétig minden levél átmegy a DKIM-en, szigorítható `p=quarantine`-ra.
- Ha a `hello@sorsfonalak.hu` címre érkező válaszokat is olvasni szeretnéd: a Cloudflare *Email Routing* ingyen továbbítja őket a Gmailedre. Ez MX- és SPF-rekordot is ad; az SPF-et ilyenkor a Brevóéval egy rekordba kell összevonni.
## 3. A szerver `.env` fájlja
`/opt/sorsfonalak/.env`:
```
SMTP_URL=smtp://<login>:<smtp-kulcs>@smtp-relay.brevo.com:2525?tls=required
MAIL_FROM=Sorsfonalak <hello@sorsfonalak.hu>
```
- A loginban lévő `@` jelet `%40`-re kell írni (például `abc123%40smtp-brevo.com`), mert az URL-ben az `@` választja el a jelszót a géptől.
- Utána: `docker compose up -d worker`. A naplóban ennek kell megjelennie: `e-mail delivery enabled`.
- Az eddig várakozó levelek ekkor kimennek. Ha ezt nem szeretnéd, előtte töröld őket: `DELETE FROM email_outbox WHERE sent_at IS NULL;`.
## 4. Próba
1. Admin → Meghívók → **Teszt küldése magamnak**: megérkezik-e, és nem a spamben van-e.
2. A Gmailben a levélnél *⋮ → Eredeti megjelenítése*: az SPF, a DKIM és a DMARC mellett is `PASS` álljon.
3. A [mail-tester.com](https://www.mail-tester.com) ad egy egyszeri címet: küldj rá meghívót az admin oldalról (utána vond vissza), és nézd meg a pontszámot. 9/10 fölött jó.
## Amit a kód már elintéz
- HTML és szöveges változat ugyanazzal a tartalommal; egyhasábos, képek és követés nélkül; minden link a saját domainre mutat.
- `Message-ID` a feladó domainjén.
- `List-Unsubscribe` és `List-Unsubscribe-Post` (RFC 8058): a Gmail és a többi levelező saját „Leiratkozás” gombot mutat. Aki leiratkozik, annak a címére soha többé nem megy meghívó (`email_optouts`, csak a cím hash-e).
- Meghívót csak admin küldhet; egy meghívó legfeljebb háromszor megy ki, 24 óránként egyszer. A személyes üzenet legfeljebb 300 karakter, és nem lehet benne link.