Správa blokovaných adres

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.

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

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

Přidejte blokaci

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"
  }'

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:

   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.

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.

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

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.

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.

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.

Související