# Seznamy kontaktů

> 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.

Seznam kontaktů je pojmenovaný seznam kontaktů, například „Newsletter“ nebo „Novinky v produktu“. Jako příjemce [kampaně](/cs/docs/campaigns/) 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](/cs/docs/contacts/) 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í](/cs/docs/audiences/unsubscribes/).
- **Smazání odběratele** osobu ze seznamu odebere. Kontakt ve vašem workspace zůstane.

## Stránka Audiences

Na stránce **Email Marketing → Audiences** 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í](/cs/docs/audiences/subscribe-url/). |
| **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ů](/cs/docs/audiences/subscribers/).

## Limity

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

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Odběratelé na seznam | 10 000 | 50 000 | 250 000 | Neomezeně |

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](/cs/docs/billing/plans/) 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ů](/cs/docs/api-reference/audiences/) umožňuje seznamy [vytvářet](/cs/docs/api-reference/audiences/create/), [načítat](/cs/docs/api-reference/audiences/get/), [přejmenovávat](/cs/docs/api-reference/audiences/update/), [vypisovat](/cs/docs/api-reference/audiences/list/) a [mazat](/cs/docs/api-reference/audiences/delete/) a [API odběratelů](/cs/docs/api-reference/audiences/subscribers/) 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**.

```bash
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í](/cs/docs/audiences/subscribe-url/). Duplicitní název vrací `409`.

## Události

Změny seznamů a odběratelů vyvolávají události, které můžete přijímat [webhooky](/cs/docs/webhooks/) a které spouštějí [automatizace](/cs/docs/automations/):

| Událost | Kdy nastane |
| --- | --- |
| [`audience.created`, `audience.updated`, `audience.deleted`](/cs/docs/webhooks/events/audience/) | Seznam se vytvoří, přejmenuje nebo smaže. Smazání seznamu nevyvolá událost pro každého z jeho odběratelů. |
| [`subscriber.created`](/cs/docs/webhooks/events/subscriber/) | Někdo se do seznamu přidá ve webovém rozhraní, nebo přes API. Spouští automatizace **Added to audience**. |
| [`subscriber.updated`](/cs/docs/webhooks/events/subscriber/) | Změní se údaje odběratele, nebo jeho příznak **Subscribed**. |
| [`subscriber.deleted`](/cs/docs/webhooks/events/subscriber/) | 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

  - [Správa odběratelů](/cs/docs/audiences/subscribers/): Přidávejte, upravujte, odhlašujte a odebírejte lidi.
  - [URL pro přihlášení](/cs/docs/audiences/subscribe-url/): Sbírejte přihlášky z vlastního webu.
  - [Odhlášení](/cs/docs/audiences/unsubscribes/): Jak funguje odhlášení napříč seznamy.
  - [Odeslání kampaně](/cs/docs/campaigns/create/): Pošlete e-mail odběratelům svých seznamů.

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