# SMTP relay

> Odesílejte e-maily z jakékoli aplikace, frameworku nebo zařízení, které umí SMTP. Údaje pro připojení, jak se přeposlaná pošta zobrazuje v Emailitu a čím se SMTP liší od API.

SMTP relay Emailitu přijímá poštu od čehokoli, co umí odesílat přes SMTP, například od CMS, maileru frameworku, monitorovacího nástroje nebo skeneru, a doručuje ji stejnou cestou jako [e-mailové API](/cs/docs/email-api/). Použijte ho, když je změna nastavení SMTP jednodušší než psaní kódu pro API.

## Kdy použít SMTP

SMTP se hodí, když:

- Váš software podporuje jen SMTP, jako pluginy pro WordPress, helpdesky a síťová zařízení.
- Přecházíte od jiného poskytovatele a chcete změnit jen hostitele a přístupové údaje.
- Váš framework už má SMTP mailer, jako Laravel, Django, Rails a Nodemailer.

API zvolte, když potřebujete [šablony](/cs/docs/templates/) s proměnnými, plánování, metadata, idempotenční klíče nebo nastavení měření pro jednotlivé e-maily. Úplné srovnání najdete na stránce [Volba mezi API a SMTP](/cs/docs/get-started/api-or-smtp/).

## Jak to funguje

1. Vaše aplikace se připojí k `smtp.emailit.com`, přepne spojení na TLS a přihlásí se API klíčem.
2. Pošle odesílatele v obálce, jeden příkaz pro každého příjemce a zprávu.
3. Emailit zkontroluje workspace, limity rychlosti, velikost zprávy a doménu v hlavičce From a pak odpoví `250 2.0.0 OK: queued as em_…`.
4. Každý příjemce se stane samostatným e-mailem s vlastním ID `em_`. Emailit ho podepíše DKIM, provede kontroly spamu, doručí ho a dočasné chyby zkouší znovu, přesně jako u pošty z API.

## Údaje pro připojení

| Nastavení | Hodnota |
| --- | --- |
| Hostitel | `smtp.emailit.com` |
| Port | `587` se STARTTLS. Dále `465` (implicitní TLS) a `2525` nebo `2587` (STARTTLS) pro sítě, které blokují port 587. |
| Uživatelské jméno | `emailit` |
| Heslo | [API klíč](/cs/docs/developers/api-keys/), začíná na `secret_` |
| Autentizace | `PLAIN` nebo `LOGIN` |

Stránka každého API klíče v **Email API → API Keys** ukazuje stejné údaje v panelu **SMTP Info**. Všechny porty, pravidla pro adresu odesílatele a limity popisuje stránka [Nastavení SMTP](/cs/docs/smtp/settings/).

## Pošlete testovací zprávu

**cURL**

```bash
cat > message.txt <<'EOF'
From: Acme <hello@acme.com>
To: ada@example.com
Subject: SMTP test from Acme

It works.
EOF

curl --url "smtp://smtp.emailit.com:587" --ssl-reqd --crlf \
  --user "emailit:$EMAILIT_API_KEY" \
  --mail-from hello@acme.com \
  --mail-rcpt ada@example.com \
  --upload-file message.txt -v
```

**Node.js**

```javascript
import nodemailer from 'nodemailer';

const transporter = nodemailer.createTransport({
  host: 'smtp.emailit.com',
  port: 587,
  secure: false, // STARTTLS on 587
  requireTLS: true,
  auth: { user: 'emailit', pass: process.env.EMAILIT_API_KEY },
});

const info = await transporter.sendMail({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'SMTP test from Acme',
  text: 'It works.',
});

console.log(info.response); // 250 2.0.0 OK: queued as em_…
```

**Python**

```python
import os
import smtplib
from email.message import EmailMessage

msg = EmailMessage()
msg["From"] = "Acme <hello@acme.com>"
msg["To"] = "ada@example.com"
msg["Subject"] = "SMTP test from Acme"
msg.set_content("It works.")

with smtplib.SMTP("smtp.emailit.com", 587) as smtp:
    smtp.starttls()
    smtp.login("emailit", os.environ["EMAILIT_API_KEY"])
    smtp.send_message(msg)
```

**PHP**

```php
use PHPMailer\PHPMailer\PHPMailer;

$mail = new PHPMailer(true);
$mail->isSMTP();
$mail->Host = 'smtp.emailit.com';
$mail->Port = 587;
$mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
$mail->SMTPAuth = true;
$mail->Username = 'emailit';
$mail->Password = getenv('EMAILIT_API_KEY');

$mail->setFrom('hello@acme.com', 'Acme');
$mail->addAddress('ada@example.com');
$mail->Subject = 'SMTP test from Acme';
$mail->Body = 'It works.';
$mail->send();
```

Nové workspace jsou v režimu sandbox a mohou posílat jen na e-maily účtů členů workspace. Než začnete posílat komukoli jinému, [požádejte o produkční přístup](/cs/docs/workspaces/production-access/).

## Jak se pošta ze SMTP zobrazuje v Emailitu

- **Jeden e-mail na příjemce.** Zpráva se třemi příjemci vytvoří tři e-maily, každý s vlastním ID `em_`, stavem a událostmi.
- **ID v odpovědi.** Odpověď `250` po zprávě uvádí nová ID, například `250 2.0.0 OK: queued as em_33VtK8mRq1xZp7LwN4cY2bHsDfa`. Jsou to stejná ID, jaká používá API, webové rozhraní a webhooky. Viz [Hlavičky a odpovědi SMTP](/cs/docs/smtp/headers/#the-250-reply).
- **Seznam e-mailů.** E-maily se zobrazují v **Email API → Emails**. Filtrem **API key** zobrazíte poštu jedné aplikace.
- **Logy.** Každá odeslaná zpráva se objeví v **Email API → Logs** se zdrojem **SMTP** a kódem odpovědi, spolu s odmítnutími kvůli limitu rychlosti a neúspěšnými přihlášeními. Viz [Logy požadavků](/cs/docs/logs/request-logs/).
- **Webhooky.** Pošta ze SMTP vyvolává stejné události doručení a zapojení jako pošta z API, kromě `email.accepted`. První událostí je obvykle `email.delivered`.

## Čím se SMTP liší od e-mailového API

| Funkce | E-mailové API | SMTP relay |
| --- | --- | --- |
| Šablony a proměnné Temple | Ano | Ne. Zpráva se odešle tak, jak jste ji sestavili. |
| Plánované odesílání | Ano, přes `scheduled_at` | Ne |
| Metadata | Ano, přes `meta` | Ne |
| Měření otevření a prokliků | Nastavení domény, nebo pro jednotlivé e-maily přes `tracking` | Jen nastavení **Track loads** a **Track clicks** odesílací domény |
| Idempotenční klíče | Ano | Ne |
| Událost `email.accepted` | Ano | Ne |
| Příjemci na zprávu | Až 50 v každém z polí `to`, `cc` a `bcc` | Bez pevného limitu |
| Kdy se účtují kredity | Při přijetí požadavku. Při nedostatku kreditů vrací `402`. | Při zpracování každého e-mailu. Při nedostatku kreditů se e-mail zadrží. |
| Co se počítá do limitu rychlosti | Každý příjemce | Každá SMTP transakce (jedna zpráva) |
| Maximální velikost zprávy | 40 MB | 40 MB |

Emailit ve zprávách přes SMTP nečte řídicí hlavičky `X-Emailit-*`. Viz [Hlavičky a odpovědi SMTP](/cs/docs/smtp/headers/).

## Limity

| Limit | Hodnota |
| --- | --- |
| Velikost zprávy | 40 MB |
| Rychlost odesílání (výchozí) | 2 zprávy za sekundu a 5 000 zpráv denně na workspace, společně s API |
| Denní obnovení | O půlnoci UTC |
| Kredity | 1 za příjemce |

Workspace s tarifem Pro a Business dostávají automatická navýšení limitů podle kondice odesílání a každý workspace může požádat o víc v panelu **Sending Limits** na úvodní stránce webového rozhraní. Viz [Limity a kvóty](/cs/docs/limits/).

## Další kroky

  - [Nastavení SMTP](/cs/docs/smtp/settings/): Porty, TLS, autentizace, pravidla pro adresu odesílatele a limity.
  - [Hlavičky a odpovědi](/cs/docs/smtp/headers/): Co Emailit přidává, přepisuje a odstraňuje.
  - [Řešení problémů](/cs/docs/smtp/troubleshooting/): Všechny kódy odpovědí SMTP s řešením.
  - [Rychlý začátek se SMTP](/cs/docs/quickstart/smtp/): Odešlete svou první zprávu krok za krokem.

---
Zdroj: https://emailit.com/cs/docs/smtp/