Přejít na obsah
Dokumentace

Přehled

Seznamy kontaktů jsou seznamy, na které posíláte kampaně. Vytvářejte, slučujte a archivujte seznamy, spravujte odběratele, nastavte double opt-in a veřejný název a pracujte se seznamy přes API.

Aktualizováno 20. 10. 2026

Seznam kontaktů je pojmenovaný seznam kontaktů, například „Newsletter“ nebo „Novinky v produktu“. Jako příjemce kampaně zvolíte jeden nebo více seznamů a lidi do seznamu můžete přidat ručně, importem, přes API, nebo přes hostovanou URL pro přihlášení.

Jak seznamy kontaktů fungují

Každá osoba v seznamu je odběratel: vazba mezi jedním kontaktem a seznamem s vlastním příznakem Subscribed. Stejný kontakt může být ve více seznamech a k některým být přihlášený a z jiných odhlášený.

  • Kampaně se posílají odběratelům, kteří mají příznak Subscribed zapnutý, jejichž kontakt není globálně odhlášený a jejichž adresa není zablokovaná. Kontakt, který je ve více vybraných seznamech, dostane jednu kopii.
  • Odhlášení příznak vypne, ale odběratele v seznamu ponechá, takže o historii nepřijdete. Viz Odhlášení.
  • Smazání odběratele osobu ze seznamu odebere. Kontakt ve vašem workspace zůstane.

Stránka Audiences

Na stránce Email MarketingAudiences uvidíte své seznamy kontaktů s údaji Name, Visibility, Subscribers a datem Created. Pod názvem se zobrazuje veřejný název, pokud se od názvu liší. Sloupec Visibility ukazuje Public, nebo Private a při zapnutém double opt-inu i označení Double opt-in. Sloupec Subscribers ukazuje, kolik odběratelů má každý seznam v poměru k limitu vašeho tarifu, například 1.2k/10k. Řadit lze podle každého sloupce.

Nabídka řádku obsahuje volby Manage subscribers, Rename, Merge into another audience, Archive a Delete. Pokud chcete pracovat s více seznamy najednou, vyberte je a použijte nabídku Actions: Merge, Archive (nebo na kartě Archived volbu Unarchive) a Delete.

Nový seznam vytvoříte tak, že vyberete Create audience, do pole Name zadáte název a vyberete Create. Názvy musí být ve workspace jedinečné.

Archivujte seznam

Seznamy, které už nepoužíváte, archivujte. Uklidíte tak, aniž byste o cokoli přišli. Archivovaný seznam se přesune na kartu Archived a:

  • ponechá si všechny své odběratele,
  • nezobrazuje se při výběru seznamů v kampaních, formulářích, automatizacích a kontaktech,
  • není uvedený na stránce pro správu odběrů, s výjimkou lidí, kteří jsou k němu stále přihlášení,
  • už nepřijímá přihlášení přes svou URL pro přihlášení, která vrací 404.

Kampaně, formuláře a automatizace, které ho už používají, fungují dál. Zpět ho vrátíte volbou Unarchive.

Slučte seznamy

Sloučení zkopíruje odběratele jednoho nebo více seznamů do jiného seznamu. Vyberte seznamy, zvolte Actions > Merge a pak vyberte seznam, do kterého je chcete sloučit, nebo v nabídce řádku použijte volbu Merge into another audience. Na stránce seznamu dělá totéž v opačném směru volba Merge audiences into this one v nabídce.

  • Lidé, kteří už v cílovém seznamu jsou, si v něm ponechají svůj stav, takže nikdo, kdo se odhlásil, se znovu nepřihlásí.
  • Osoba, která je ve více slučovaných seznamech, bude přihlášená, pokud je přihlášená alespoň v jednom z nich.
  • S volbou Delete the merged audiences afterwards se sloučené seznamy i jejich členství smažou a kampaně, jejichž odesílání na ně ještě neskončilo, se místo toho pošlou na cílový seznam. Segmenty, které čerpají ze sloučeného seznamu nebo na něj mají pravidlo, také místo něj použijí cílový seznam, a stejně tak automatizace, které se jím spouštějí, přidávají do něj lidi, kontrolují ho v podmínce nebo kontakt vyřadí, když ho opustí. Totéž platí pro formuláře, které do něj přidávají lidi nebo ho nabízejí k výběru, pro dosud nepotvrzené odkazy double opt-inu a pro spuštění automatizací čekající na podmínku, která se ho týká.

Sloučení nevyvolává události subscriber.*, nespouští automatizace a neposílá e-maily pro double opt-in ani potvrzovací e-maily. Sledované segmenty potom aktualizují své členy. Platí limit odběratelů cílového seznamu: sloučení, které by ho překročilo, nepřidá nikoho.

Stránka seznamu kontaktů

Po otevření seznamu můžete spravovat jeho odběratele. V záhlaví je počet odběratelů, označení s limitem a tyto akce:

Akce Co dělá
Subscribe URL Zobrazí URL pro přihlášení k tomuto seznamu a umožní ji obnovit. Viz URL pro přihlášení.
Import Naimportuje soubor CSV nebo Excel přímo do tohoto seznamu. Viz Import odběratelů.
Add subscriber Přidá osobu podle e-mailové adresy. Když je seznam v tarifu Pay as you go plný, nahradí ho tlačítko Upgrade.
Settings (v nabídce) Otevře kartu Settings.
Merge audiences into this one (v nabídce) Zkopíruje do tohoto seznamu odběratele jiných seznamů. Viz Sloučení seznamů.
Archive (v nabídce) Archivuje seznam, nebo ho vrátí z archivu. Viz Archivace seznamu.
Create segment (v nabídce) Založí nový segment s tímto seznamem jako zdrojem. Segmenty jsou v alfaverzi a otevřené jen týmu Emailitu.
Delete (v nabídce) Smaže seznam i všechny jeho odběratele. Kontakty ve vašem workspace zůstanou. Tuto akci nelze vrátit zpět.

Karta Subscribers uvádí lidi v seznamu se zobrazeními All, Engaged a Unengaged, řazením podle sloupců, vyhledáváním, filtry a hromadnými akcemi. Viz Správa odběratelů.

Karta Settings obsahuje:

Limity

Každý tarif omezuje, kolik odběratelů může mít jeden seznam. Počet seznamů omezený není.

Pay as you goProBusinessCustom
Odběratelé na seznam10 00050 000250 000Neomezeně

Do limitu se počítají všichni odběratelé v seznamu, včetně lidí, kteří se odhlásili. Místo uvolníte tak, že smažete odběratele, které už nepotřebujete, přejdete na vyšší tarif nebo požádáte o vyšší limit e-mailem na support@emailit.com.

Když je seznam plný, tlačítko Add subscriber je neaktivní a každý způsob přidání lidí, včetně API, importů a URL pro přihlášení, se odmítne s kódem 422 a zprávou jako „Pro includes 50,000 subscribers per audience.“. Chyba z API obsahuje aktuální usage:

JSON
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": { "used": 50000, "limit": 50000, "plan": "pro" }
}

Práce s API

API seznamů kontaktů umožňuje seznamy vytvářet, načítat, upravovat, vypisovat, slučovat, hromadně upravovat a mazat a API odběratelů spravuje lidi v nich. V URL můžete místo ID aud_ použít název seznamu. API potřebuje API klíč s oprávněním Full Access.

Terminal
curl https://api.emailit.com/v2/audiences \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Newsletter" }'

Odpovědi se seznamem kontaktů obsahují nastavení (visibility, public_name, public_description, double_opt_in, confirmation_email, unengaged, archived, archived_at), subscribers_count a objekt usage s poli used, limit a plan. Vytvoření, načtení a úprava seznamu navíc vrací jeho token, tajnou část jeho URL pro přihlášení. Duplicitní název vrací 409. Výpisy vynechávají archivované seznamy, pokud nepředáte archived=true, nebo archived=all.

Události

Změny seznamů a odběratelů vyvolávají události, které můžete přijímat webhooky a které spouštějí automatizace:

Událost Kdy nastane
audience.created, audience.updated, audience.deleted Seznam se vytvoří, změní (včetně archivace) nebo smaže. Smazání seznamu nevyvolá událost pro každého z jeho odběratelů.
subscriber.created Někdo se do seznamu přidá ve webovém rozhraní, přes API, URL pro přihlášení, formulář, odkaz pro double opt-in nebo stránku pro správu odběrů. Spouští automatizace Added to audience.
subscriber.updated Změní se údaje odběratele, nebo jeho příznak Subscribed.
subscriber.deleted Odběratel se odebere. Spouští automatizace Removed from audience.

Importy a sloučení události odběratelů nevyvolávají.

Další kroky

Přidávejte, importujte, upravujte a odebírejte lidi, jednotlivě i hromadně.
Sbírejte přihlášky z vlastního webu.
Potvrzujte přihlášení a vítejte nové odběratele.
Umožněte lidem vybrat si své seznamy.
Vynechte lidi, kteří přestali otevírat vaše e-maily.
Jak funguje odhlášení napříč seznamy.
Pošlete e-mail odběratelům svých seznamů.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.