Přejít na obsah
Dokumentace

Přehled

Seznamy kontaktů jsou seznamy, na které posíláte kampaně. Vytvářejte seznamy, spravujte odběratele, zjistěte limit odběratelů ve vašem tarifu a pracujte se seznamy přes API.

Aktualizováno 1. 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, Subscribers a datem Created. Sloupec Subscribers ukazuje, kolik odběratelů má každý seznam v poměru k limitu vašeho tarifu, například 1.2k/10k. Nabídka řádku obsahuje volby Manage subscribers, Rename 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é.

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á
Rename Změní název seznamu.
Subscribe URL Zobrazí hostovanou URL pro přihlášení k tomuto seznamu a umožní ji obnovit. Viz URL pro přihlášení.
Add subscriber Přidá osobu podle e-mailové adresy. Když je seznam v tarifu Pay as you go plný, nahradí ho tlačítko Upgrade.
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.

Pod ním je tabulka odběratelů se sloupci Email, First name, Last name, Subscribed a Created, s vyhledáváním, filtry a nabídkou řádku s volbami Edit a Delete pro každého odběratele. Viz Správa odběratelů.

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 tlačítkem Request Increase v panelu Sending Limits na úvodní stránce webového rozhraní.

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, přejmenovávat, vypisovat 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í 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.

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ří, přejmenuje 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í, nebo přes API. 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 URL pro přihlášení události odběratelů nevyvolávají.

Další kroky

Přidávejte, upravujte, odhlašujte a odebírejte lidi.
Sbírejte přihlášky z vlastního webu.
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.