# Kontakty

> Kontakty jsou lidé ve vašem workspace. Zjistěte, jak spolu souvisejí kontakty, seznamy kontaktů a odběratelé, co ukazuje seznam a profil kontaktů a jak funguje odhlášení.

Kontakt je jedna osoba ve vašem workspace, identifikovaná svou e-mailovou adresou. Kontakty uchovávají jména a hodnoty vlastních polí, se kterými personalizujete kampaně, a jsou členy seznamů kontaktů, na které se kampaně posílají. Tato stránka vysvětluje, jak do sebe jednotlivé části zapadají a co s kontakty můžete dělat ve webovém rozhraní a přes API.

## Kontakty, seznamy kontaktů a odběratelé

Emailit drží lidi a seznamy odděleně. Osoba existuje jednou jako kontakt a každý seznam, ve kterém je, je samostatný záznam odběratele s vlastním stavem přihlášení.

| | Kontakt | Seznam kontaktů | Odběratel |
| --- | --- | --- | --- |
| **Co to je** | Jedna osoba | Pojmenovaný seznam, na který posíláte kampaně | Členství jednoho kontaktu v jednom seznamu |
| **Předpona ID** | `con_` | `aud_` | `sub_` |
| **Jedinečný podle** | E-mailové adresy, v rámci workspace | Názvu, v rámci workspace | Jeden na kontakt a seznam |
| **Obsahuje** | E-mail, křestní jméno, příjmení, vlastní pole, marketingový stav | Název, počet odběratelů, URL pro přihlášení | Příznak **Subscribed** s daty přihlášení a odhlášení |
| **Smazání** | Odebere kontakt také ze všech seznamů | Odebere všechny jeho odběratele. Kontakty zůstanou. | Odebere toto členství. Kontakt zůstane. |

```text
Workspace
├── Contacts ────────────── one per email address
│   ├── email, first_name, last_name, custom_fields
│   └── marketing status (unsubscribed: true | false)
└── Audiences ───────────── named lists, for example "Newsletter"
    └── Subscribers ─────── one per contact on the list
        └── subscribed: true | false
```

V praxi to znamená:

- Jeden kontakt může být odběratelem mnoha seznamů, v každém se samostatným příznakem **Subscribed**.
- Když někoho přidáte do seznamu podle e-mailu a kontakt ještě neexistuje, nejdřív se vytvoří.
- Jména a vlastní pole patří kontaktu. Když je upravíte ze seznamu, změní se kontakt, takže se změna projeví všude.

### Kdo kampaň dostane

Kampaň se pošle každému kontaktu, který splňuje všechny tři podmínky:

1. Kontakt je odběratelem alespoň jednoho ze seznamů kampaně a má zapnutý příznak **Subscribed**.
2. Marketingový stav kontaktu je **Subscribed**.
3. Adresa není na vašem [seznamu blokovaných adres](/cs/docs/suppressions/).

Kontakt, který je ve více vybraných seznamech, dostane jednu kopii. Úplná pravidla najdete na stránce [Vytvoření kampaně](/cs/docs/campaigns/create/).

## Marketingový stav

Každý kontakt má také stav **Marketing status** platný pro celý workspace: **Subscribed**, nebo **Unsubscribed** (pole `unsubscribed` v API). Je to globální odhlášení, které má přednost před příznakem jednotlivých seznamů.

| Co měníte | Jak | Vliv na kampaně |
| --- | --- | --- |
| Marketingový stav | Hromadná akce **Unsubscribe** nebo **Resubscribe** v seznamu Contacts, nebo pole `unsubscribed` v API | Kontakty ve stavu **Unsubscribed** se vynechají ve všech seznamech. Jejich členství v seznamech se nezmění. |
| Přihlášení k jednomu seznamu | **Unsubscribe** nebo **Resubscribe** na stránce kontaktu nebo v seznamu, nebo pole `subscribed` u odběratele | Kontakt se vynechá jen u kampaní na tento seznam. |
| Příjemce klikne na odkaz pro odhlášení | Hostovaná odhlašovací stránka | Kontakt se odhlásí ze všech seznamů, ve kterých je. |

Marketingový stav a přihlášení k seznamům řídí jen kampaně. Neblokují e-maily, které odesíláte přes API nebo SMTP, ani e-maily odeslané automatizacemi. Pokud chcete zastavit veškerou poštu na adresu, přidejte ji mezi [blokované adresy](/cs/docs/suppressions/). Všechny způsoby odhlášení popisuje stránka [Odhlášení](/cs/docs/audiences/unsubscribes/).

## Stránka Contacts

Otevřete **Email Marketing → Contacts** a uvidíte všechny kontakty ve workspace, od nejnovějších.

- **Sloupce.** **Email** se zobrazuje vždy. Sloupce **First name**, **Last name**, **Audiences**, **Created** a **Updated** zapnete nebo vypnete v **Display options > Edit columns**, nebo vyberte **Show full name** a jména se sloučí do jednoho sloupce **Name**. Ve sloupci **Audiences** je označení každého seznamu zelené, dokud je kontakt k seznamu přihlášený, a červené po odhlášení.
- **Vyhledávání** hledá v e-mailu, křestním jménu a příjmení.
- **Filtrovat** můžete podle Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences nebo Audience a podle libovolného [vlastního pole](/cs/docs/contacts/custom-fields/). Se dvěma a více filtry zvolte, jestli musí odpovídat všechny, nebo stačí kterýkoli.
- **Řadit** můžete výběrem záhlaví sloupce.
- **Import** a **Export** přenášejí kontakty ze souborů a do souborů. Viz [Import a export kontaktů](/cs/docs/contacts/import-export/).

Výběrem řádku kontakt otevřete. Nabídka řádku obsahuje **Edit** a **Delete**.

### Přidejte kontakt

Vyberte **Add contact**, vyplňte **Email** a volitelně **First name**, **Last name** a **Audiences**. Hodnoty vlastních polí vyplníte po výběru **Show custom fields**. Každá e-mailová adresa může ve workspace existovat jen jednou, takže přidání existující adresy selže.

Pokud chcete kontakt později změnit, vyberte **Edit**. Můžete změnit jména a vlastní pole. E-mailovou adresu ve webovém rozhraní změnit nelze. Použijte místo toho pole `email` v endpointu [Úprava kontaktu](/cs/docs/api-reference/contacts/update/).

### Hromadné akce

Vyberte kontakty zaškrtávacími políčky (políčko v záhlaví vybere celou stránku) a otevřete **Actions**. Každá akce se najednou použije nejvýše na 100 kontaktů.

| Akce | Co dělá |
| --- | --- |
| **Add to audience** | Přidá kontakty do zvoleného seznamu. Stávající členství zůstanou beze změny. Kontakty s marketingovým stavem **Unsubscribed** se přidají jako odhlášení odběratelé. |
| **Remove from audience** | Smaže jejich členství ve zvoleném seznamu. Kontakty zůstanou. |
| **Unsubscribe** | Nastaví jejich marketingový stav na **Unsubscribed**. |
| **Resubscribe** | Vrátí jejich marketingový stav na **Subscribed**. Přihlášení k seznamům se nezmění. |
| **Delete** | Smaže kontakty i všechna jejich členství. Tuto akci nelze vrátit zpět. |

## Stránka kontaktu

Stránka kontaktu ukazuje vše, co Emailit o jedné osobě ví. Nahoře jsou tlačítka **Edit** a **Delete**.

| Sekce | Co ukazuje |
| --- | --- |
| **Details** | E-mail, křestní jméno, příjmení, marketingový stav, datum vytvoření a úpravy. |
| **Custom fields** | Všechna vlastní pole definovaná ve workspace a hodnotu kontaktu. |
| **Metrics and Insights** | **Emails sent**, **Loads**, **Clicks**, **Last activity**, **Subscribed audiences** (přihlášené z celkového počtu) a **Marketing status**. Počty zahrnují všechny odchozí e-maily odeslané na adresu, nejen kampaně. |
| **Audiences** | Všechny seznamy, ve kterých kontakt je, se stavem a daty přihlášení a odhlášení. Nabídka řádku obsahuje **Unsubscribe** nebo **Resubscribe** kontaktu pro daný seznam a **Remove from audience**. **Add to audience** přidá nové členství. |
| **Sent emails** | Odchozí e-maily odeslané na adresu s předmětem, stavem, kampaní, načteními, prokliky a časem odeslání. |
| **Activity log** | Časová osa událostí kontaktu, například „Contact created“, „Added to Newsletter“, „Unsubscribed from Newsletter“ a „Email delivered“. |

## Práce s API

[API kontaktů](/cs/docs/api-reference/contacts/) pokrývá vše, co umí seznam a profil kontaktů, kromě importu souborů:

- Kontakty můžete [vytvářet](/cs/docs/api-reference/contacts/create/), [načítat](/cs/docs/api-reference/contacts/get/), [upravovat](/cs/docs/api-reference/contacts/update/), [vypisovat](/cs/docs/api-reference/contacts/list/) a [mazat](/cs/docs/api-reference/contacts/delete/). Všude, kde se očekává ID, můžete místo ID `con_` předat e-mailovou adresu kontaktu.
- Při vytvoření kontaktu předejte `audiences` (pole ID `aud_`) a kontakt se rovnou přihlásí. Při úpravě `audiences` nahradí členství kontaktu.
- Na až 100 kontaktů můžete [spustit hromadnou akci](/cs/docs/api-reference/contacts/bulk/) a až 10 000 jich [vyexportovat](/cs/docs/api-reference/contacts/export/) jako CSV nebo XLSX.

```bash
curl https://api.emailit.com/v2/contacts \
  -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", "plan": "pro" },
    "audiences": ["aud_2kq8Vt4xLm7Rz"]
  }'
```

Vytvoření kontaktu s e-mailem, který už existuje, vrací `409` s existujícím kontaktem v poli `existing`. API kontaktů potřebuje API klíč s oprávněním **Full Access**.

Změny kontaktů vyvolávají události [`contact.created`, `contact.updated` a `contact.deleted`](/cs/docs/webhooks/events/contact/) a změny členství události [`subscriber.*`](/cs/docs/webhooks/events/subscriber/), které můžete přijímat [webhooky](/cs/docs/webhooks/).

## Další kroky

  - [Vlastní pole](/cs/docs/contacts/custom-fields/): Ukládejte ke kontaktům další data a používejte je ve filtrech a e-mailech.
  - [Import a export](/cs/docs/contacts/import-export/): Naimportujte kontakty ze souboru CSV nebo Excel a stáhněte si je.
  - [Seznamy kontaktů](/cs/docs/audiences/): Seskupte kontakty do seznamů, na které můžete posílat kampaně.
  - [Odhlášení](/cs/docs/audiences/unsubscribes/): Jak funguje odhlášení a jak ho respektovat.

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