# Správa odběratelů

> Přidávejte lidi do seznamu kontaktů, upravujte je, zapínejte a vypínejte jim příznak Subscribed a odebírejte je, ve webovém rozhraní nebo přes API odběratelů.

Odběratel je členství jednoho kontaktu v jednom seznamu kontaktů. Tato stránka ukazuje, jak odběratele přidávat, měnit, odhlašovat, znovu přihlašovat a odebírat a co každá změna udělá s kontaktem, který za nimi stojí.

## Než začnete

- Nejdřív vytvořte seznam kontaktů. Viz [Seznamy kontaktů](/cs/docs/audiences/).
- Zkontrolujte, kolik místa v seznamu zbývá. Do limitu se počítají všichni odběratelé včetně odhlášených. Viz [Limity](/cs/docs/audiences/#limits).
- Pro API použijte API klíč s oprávněním **Full Access**.

## Přidejte odběratele

**Webové rozhraní**

  1. **Otevřete seznam kontaktů.** Přejděte do **Email Marketing → Audiences** a vyberte seznam.

  2. **Přidejte osobu.** Vyberte **Add subscriber**, vyplňte pole **Email** a volitelně **First name** a **Last name**.

  3. **Uložte.** Vyberte **Add**. Pokud pro adresu žádný kontakt neexistuje, Emailit ho vytvoří.

  Existující kontakty můžete přidat i ze stránky **Email Marketing → Contacts**: otevřete kontakt a vyberte **Add to audience**, nebo vyberte několik kontaktů a použijte **Actions > Add to audience**. Pokud chcete přidat mnoho lidí najednou, [naimportujte soubor](/cs/docs/contacts/import-export/).

**API**

  Zavolejte endpoint [Přidání odběratele](/cs/docs/api-reference/audiences/subscribers/add/) s ID nebo názvem seznamu:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme" }
  }'
```

```json
{
  "object": "subscriber",
  "id": "sub_7Rt2vX9kLm3Qp",
  "audience_id": "aud_5hJ2kL8mNp4Qr",
  "contact_id": "con_2kq8Vt4xLm7Rz",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": { "company": "Acme" },
  "subscribed": true,
  "subscribed_at": "2026-10-01T09:30:00Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}
```

  Povinné je jen pole `email`. Pokud u existujícího kontaktu předáte `first_name`, `last_name` nebo `custom_fields`, přepíšou hodnoty kontaktu a `custom_fields` nahradí celý objekt.

### Když už je osoba v seznamu

Co se stane při přidání adresy, která už v seznamu je, závisí na jejím aktuálním stavu:

| Aktuální stav | Výsledek | Odpověď API |
| --- | --- | --- |
| Není v seznamu | Vytvoří se nový odběratel se zapnutým příznakem **Subscribed**. | `201` |
| V seznamu, **Subscribed** zapnuté | Nic se nezmění. Webové rozhraní zobrazí „Contact is already subscribed to this audience“. | `409` s odběratelem v poli `existing` |
| V seznamu, odhlášený | Odběratel se znovu přihlásí: **Subscribed** se zapne, `subscribed_at` se nastaví na aktuální čas a `unsubscribed_at` se vymaže. | `200` |
| Seznam je plný | Nic se nepřidá. | `422` s polem `usage` |

Opětovné přihlášení přes tento endpoint vyvolá události `subscriber.updated` a `subscriber.resubscribed` a spustí automatizace **Added to audience**, stejně jako u nového odběratele.

> **Pozor:** Když někoho po odhlášení znovu přidáte, znovu ho tím přihlásíte. Dělejte to jen tehdy, když se osoba sama znovu přihlásit chtěla, například registrací na vašem webu.

## Upravte odběratele

V tabulce odběratelů seznamu otevřete nabídku řádku a vyberte **Edit**. Můžete změnit **First name**, **Last name** a přepínač **Subscribed**. E-mailovou adresu tady upravit nelze.

Přes API zavolejte endpoint [Úprava odběratele](/cs/docs/api-reference/audiences/subscribers/update/). Odběratele určete jeho ID `sub_`, nebo e-mailovou adresou a pošlete kterékoli z polí `email`, `first_name`, `last_name`, `custom_fields` a `subscribed`:

```bash
curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'
```

Jména, e-mail a vlastní pole patří kontaktu, ne odběrateli. Když je tady změníte, kontakt se upraví všude, i v ostatních seznamech. Jen `subscribed` se týká výhradně tohoto seznamu.

## Zapněte nebo vypněte Subscribed

Příznak **Subscribed** rozhoduje, jestli se k osobě dostanou kampaně posílané na tento seznam. Jeho vypnutím odběratel v seznamu zůstane, zaznamená se `unsubscribed_at` a ostatní seznamy kontaktu zůstanou beze změny. Opětovným zapnutím se nastaví nové `subscribed_at` a `unsubscribed_at` se vymaže.

| Kde | Odhlášení | Opětovné přihlášení |
| --- | --- | --- |
| Stránka seznamu kontaktů | **Edit** a pak vypněte **Subscribed** | **Edit** a pak zapněte **Subscribed** |
| Stránka kontaktu | **Unsubscribe** v nabídce řádku seznamu | **Resubscribe** v nabídce řádku |
| API | [Úprava odběratele](/cs/docs/api-reference/audiences/subscribers/update/) s `"subscribed": false` | Úprava s `"subscribed": true`, nebo adresu znovu [přidejte](/cs/docs/api-reference/audiences/subscribers/add/) |

Tyto změny vyvolají událost `subscriber.updated`. Nezaznamenají odhlášení u žádné kampaně, takže se neobjeví na kartě **Unsubscribes** kampaně. Když se příjemci odhlásí sami odkazem v kampani, opustí všechny seznamy najednou. Viz [Odhlášení](/cs/docs/audiences/unsubscribes/).

## Odeberte odběratele

Odebrání odběratele smaže členství. Na stránce seznamu vyberte v nabídce řádku **Delete**, na stránce kontaktu **Remove from audience** nebo zavolejte endpoint [Smazání odběratele](/cs/docs/api-reference/audiences/subscribers/delete/).

| | Odhlášení | Odebrání |
| --- | --- | --- |
| Osoba zůstane v seznamu | Ano, s vypnutým **Subscribed** | Ne |
| Počítá se do limitu seznamu | Ano | Ne |
| Kontakt zůstane zachovaný | Ano | Ano |
| Událost | `subscriber.updated` | `subscriber.deleted`, která spustí automatizace **Removed from audience** |
| Opětovné přidání adresy | Znovu přihlásí existujícího odběratele | Vytvoří nového odběratele |

Když se někdo odhlásí, dejte přednost odhlášení, abyste o tom měli záznam. Odebírejte odběratele, které jste přidali omylem, nebo které už nechcete mít v seznamu. Pokud chcete osobu smazat úplně, smažte kontakt, čímž se odebere ze všech seznamů.

## Vypište a najděte odběratele

Na stránce seznamu můžete hledat podle e-mailu nebo jména a filtrovat podle Email, First name, Last name, Subscribed nebo Created.

Přes API vrací [Výpis odběratelů](/cs/docs/api-reference/audiences/subscribers/list/) všechny odběratele včetně odhlášených. Výpis zúžíte parametrem `subscribed=true`, nebo `subscribed=false`, parametr `search` hledá v e-mailu a jménech a parametry `page` a `limit` (nejvýše 100) slouží ke stránkování:

```bash
curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

Jednu osobu dohledáte přes [Načtení odběratele](/cs/docs/api-reference/audiences/subscribers/get/) podle ID `sub_`, nebo e-mailové adresy.

## Související

  - [URL pro přihlášení](/cs/docs/audiences/subscribe-url/): Umožněte lidem, aby se na vašem webu přihlásili sami.
  - [Kontakty](/cs/docs/contacts/): Osoba za každým odběratelem.

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