# Správa blokovaných adres

> Prohlížejte, filtrujte, přidávejte, importujte, exportujte a mažte blokované adresy ve webovém rozhraní nebo přes API, nastavte automatické blokování adres a znovu odešlete zablokované e-maily.

Tento návod popisuje všechny úkony se seznamem blokovaných adres: vyhledání záznamů, jejich přidání jednotlivě nebo ze souboru CSV, export, odebrání a nastavení automatického blokování adres. Jak blokované adresy fungují, vysvětluje stránka [Blokované adresy](/cs/docs/suppressions/).

## Než začnete

- Seznam může ve webovém rozhraní spravovat každý člen workspace. Nastavení automatického blokování adres může měnit jen administrátor.
- Pro práci přes API použijte API klíč s oprávněním **Full Access**.

## Zobrazte a filtrujte seznam

**Webové rozhraní**

  Otevřete **Email API → Suppressions**. Tabulka u každé blokace uvádí **Email**, **Reason** a **Created at**, od nejnovějších.

  - **Search** hledá v e-mailové adrese a v důvodu.
  - **Filters** přidávají pravidla pro **Email**, **Reason**, **Type** nebo **Created at**, například *Type equals complaint*. Stiskněte Enter, nebo vyberte **Apply**.
  - **Display options > Edit columns** zobrazí sloupec **Type**.
  - Když vyberete záhlaví sloupce, tabulka se podle něj seřadí.

**API**

  Zavolejte [Výpis blokovaných adres](/cs/docs/api-reference/suppressions/list/). Filtrovat můžete podle `email`, `reason`, `type`, `created_at` a `keep_until`:

```bash
curl -G https://api.emailit.com/v2/suppressions \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type.exact=complaint" \
  --data-urlencode "limit=100"
```

  Pokud chcete dohledat jednu adresu, zavolejte [Načtení blokace](/cs/docs/api-reference/suppressions/get/) s jejím ID `sup_` nebo s e-mailovou adresou. Všechny operátory najdete na stránce [Filtrování a řazení](/cs/docs/api-reference/filtering/).

## Přidejte blokaci

**Webové rozhraní**

  1. **Otevřete seznam.** Otevřete **Email API → Suppressions** a vyberte **Add suppression**.

  2. **Zadejte údaje.** Vyplňte pole **Email** a volitelně **Reason** s důvodem, podle kterého blokaci později poznáte.

  3. **Vyberte Create.** Adresa se přidá s typem `recipient`, který blokuje veškerou poštu na ni.

  Pokud chcete přidat jiný typ nebo blokaci, která vyprší, použijte API nebo import CSV.

**API**

  Zavolejte [Vytvoření blokace](/cs/docs/api-reference/suppressions/create/):

```bash
curl https://api.emailit.com/v2/suppressions \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "type": "unsubscribe",
    "reason": "Opted out by phone",
    "keep_until": "2027-01-01T00:00:00Z"
  }'
```

  | Pole | Povinné | Popis |
  | --- | --- | --- |
  | `email` | Ano | Adresa, kterou chcete zablokovat. |
  | `type` | Ne | `recipient` (výchozí), `bounce`, `complaint` nebo `unsubscribe`. |
  | `reason` | Ne | Volný text. |
  | `keep_until` | Ne | Kdy blokace vyprší: ISO 8601, unixové časové razítko nebo anglický výraz, například `in 30 days`. Pokud ho vynecháte, adresa zůstane zablokovaná natrvalo. |

  Stejnou adresu se stejným typem lze přidat jen jednou. Duplicitní záznam vrací `409 Suppression already exists for this email and type`.

## Naimportujte soubor CSV

Importem převedete seznam blokovaných adres od jiného poskytovatele, nebo najednou přidáte mnoho adres.

1. **Připravte soubor.** Použijte soubor `.csv` se sloupci `email`, `type` a `reason`:

```csv title="suppressions.csv"
email,type,reason
ada@example.com,bounce,Hard bounce at previous provider
grace@example.com,unsubscribe,Unsubscribed in 2025
alan@example.com,,Requested removal
```

   - Sloupec `email` je povinný. Sloupce `type` a `reason` jsou volitelné.
   - Prázdná nebo neznámá hodnota `type` se změní na `recipient`.
   - Řádek se záhlavím je volitelný. Bez něj Emailit čte sloupce v pořadí `email`, `type`, `reason`.
   - Soubor musí mít méně než 8 MB a nejvýše 10 000 řádků.

2. **Nahrajte ho.** Na stránce **Email API → Suppressions** vyberte **Import** a pak zvolte soubor, nebo ho přetáhněte na **Select a file or drag it here**.

3. **Zkontrolujte výsledek.** Emailit přidá nové záznamy a přeskočí adresy, které už mají blokaci stejného typu. Řádky s neplatnými e-mailovými adresami se přeskočí.

Pokud máte víc než 10 000 adres, soubor rozdělte. Pokud chcete importovat z kódu, zavolejte pro každou adresu [Vytvoření blokace](/cs/docs/api-reference/suppressions/create/).

## Vyexportujte seznam

1. **Zužte výběr.** Volitelně seznam v **Email API → Suppressions** prohledejte nebo vyfiltrujte. Export obsahuje jen to, co je zobrazené.

2. **Vyexportujte.** Vyberte **Export** a pak ve vyskakovacím panelu znovu **Export**. Emailit stáhne soubor `suppressions.csv`.

Soubor má sloupce `email`, `type`, `reason` a `created_at` a obsahuje nejvýše 10 000 řádků.

## Smažte blokace

Po smazání blokace může Emailit na adresu znovu odesílat. Ujistěte se, že je adresa platná a že daný člověk o vaši poštu stojí, jinak se další e-mail může nedoručit nebo vyvolat stížnost.

**Webové rozhraní**

  - **Jedna blokace:** v jejím řádku vyberte ikonu koše a potvrďte.
  - **Více blokací:** zaškrtávacími políčky vyberte řádky, vyberte **Delete suppressions** a potvrďte.

**API**

  Zavolejte [Smazání blokace](/cs/docs/api-reference/suppressions/delete/) s ID `sup_` nebo s e-mailovou adresou:

```bash
curl https://api.emailit.com/v2/suppressions/sup_4Lm8Qr2Tz6Wk \
  -X DELETE \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  Pokud má adresa blokace více typů, použijte ID `sup_`, abyste smazali tu správnou.

  Pokud chcete blokaci místo toho změnit, například jí nastavit datum vypršení, zavolejte [Úprava blokace](/cs/docs/api-reference/suppressions/update/) s `type`, `reason` nebo `keep_until`. Pokud chcete vypršení zrušit, nastavte `keep_until` na `null`.

## Nastavte automatické blokování adres

Emailit na seznam automaticky přidává adresy, na které se e-maily nedoručí nebo jejichž příjemci si stěžují. V tarifech Pro a Business to mohou administrátoři změnit.

1. **Otevřete nastavení.** Otevřete **Workspace → Settings** a vyberte kartu **Suppressions**.

2. **Zapněte ho, nebo vypněte.** Použijte přepínač **Enable automatic suppression**.

3. **Zvolte, co blokovat.** V poli **Suppress on** vyberte **Bounces and Complaints** (výchozí), **Bounces only** nebo **Complaints only**.

V tarifech Pay as you go a Custom je automatické blokování adres vždy zapnuté pro nedoručení i stížnosti. Ovládací prvky mají označení **Pro** a nelze je změnit. Členové, kteří nejsou administrátoři, nastavení vidí, ale nemohou ho měnit. Kdy přesně Emailit adresu zablokuje, popisuje stránka [Nedoručení a stížnosti](/cs/docs/deliverability/bounces-and-complaints/#automatic-suppression).

## Znovu odešlete zablokované e-maily

Zpráva zastavená blokací zůstane ve stavu `suppressed`, i když blokaci smažete. Pokud ji chcete odeslat:

1. **Smažte blokaci** adresy, jak je popsáno výše. Jinak se opakované odeslání znovu zablokuje.

2. **Odešlete e-mail znovu.** Otevřete ho v **Email API → Emails** a vyberte **Retry**, nebo zavolejte [Opakované odeslání e-mailu](/cs/docs/api-reference/emails/retry/).

Opakované odeslání vytvoří nový e-mail se stejným obsahem a novým ID a stojí kredity jako každé jiné odeslání. Znovu odeslat můžete e-maily staré nejvýše 30 dní, pokud je jejich obsah stále v rámci doby [uchovávání dat](/cs/docs/data-retention/).

## Související

  - [Blokované adresy](/cs/docs/suppressions/): Typy, automatické blokování a vypršení.
  - [Nedoručení a stížnosti](/cs/docs/deliverability/bounces-and-complaints/): Kdy Emailit adresu zablokuje.
  - [API blokovaných adres](/cs/docs/api-reference/suppressions/): Všechny endpointy pro blokované adresy.
  - [Ověřování e-mailů](/cs/docs/email-verification/): Odstraňte špatné adresy ještě před odesláním.

---
Zdroj: https://emailit.com/cs/docs/suppressions/manage/