# Double opt-in a potvrzovací e-maily

> Požádejte lidi, aby před přidáním do seznamu kontaktů potvrdili svou adresu, a přivítejte je potvrzovacím e-mailem. Nastavte odesílatele, texty nebo vlastní design v MJML a oba e-maily otestujte.

Každý seznam kontaktů může posílat dva vlastní e-maily:

- **Double opt-in**: e-mail s potvrzovacím odkazem. Lidé, kteří se přihlásí, se do seznamu přidají, až na odkaz kliknou, takže každá adresa v seznamu patří někomu, kdo o to stál.
- **Potvrzovací e-mail**: krátký e-mail, který potvrdí přihlášení. Odešle se hned poté, co se někdo do seznamu přidá, nebo poté, co přihlášení potvrdí, pokud je zapnutý double opt-in.

Oba jsou vypnuté, dokud je nezapnete, a oba se odesílají z vaší vlastní ověřené odesílací domény.

## Než začnete

- Ověřte odesílací doménu. Oba e-maily potřebují adresu **From** na jedné z vašich [ověřených domén](/cs/docs/domains/).
- Každý e-mail stojí jeden kredit, stejně jako jakýkoli jiný e-mail.
- Workspace, který ještě není ověřený, může posílat e-maily jen svým členům, takže e-maily pro double opt-in jiným lidem selžou, dokud nebude workspace ověřený.

## Zapněte double opt-in

1. **Otevřete nastavení.** Přejděte do **Email Marketing → Audiences**, otevřete seznam a vyberte kartu **Settings**.

2. **Nastavte odesílatele.** V panelu **Double opt-in** zadejte do pole **From** adresu na ověřené doméně, například `News <news@example.com>`, a volitelně vyplňte **Reply-to**.

3. **Upravte e-mail.** Změňte **Subject**, **Heading**, **Text**, **Button text** a **Footer**, nebo ponechte výchozí hodnoty. Náhled vpravo se aktualizuje průběžně, jak píšete.

4. **Zvolte, kam lidé přejdou.** Volitelně zadejte stránku do pole **After confirming, go to**. Bez ní lidé uvidí potvrzovací stránku s odkazem pro [správu svých odběrů](/cs/docs/audiences/manage-subscriptions/). Má design vaší [odhlašovací stránky](/cs/docs/audiences/unsubscribe-page/#other-pages-with-this-design) a otevře se v jazyce prohlížeče dané osoby.

5. **Zapněte ho.** Zapněte **Require confirmation** a vyberte **Save**.

Pokud doména v poli **From** není ověřená, uložení selže se zprávou „Use an address on a verified sending domain of this workspace.“

### Která přihlášení vyžadují potvrzení

| Jak se osoba přidá | Se zapnutým double opt-inem |
| --- | --- |
| [URL pro přihlášení](/cs/docs/audiences/subscribe-url/) seznamu | Dostane e-mail pro double opt-in a přidá se po kliknutí na odkaz v něm. URL vrací `202`. |
| [Formulář](/cs/docs/forms/), který přidává lidi do seznamu | Stejně, pokud formulář nepoužívá vlastní double opt-in. Pak stačí potvrzení přes formulář. Pokud e-mail pro double opt-in nejde odeslat, formulář osobu přidá hned. |
| **Add subscriber** ve webovém rozhraní | Políčko **Ask them to confirm by email first (double opt-in)** je zaškrtnuté. Pokud zaškrtnutí zrušíte, osoba se přidá hned. |
| [Přidání odběratele](/cs/docs/api-reference/audiences/subscribers/add/) přes API | Jen s `"double_opt_in": true`. Bez něj se osoba přidá hned. |
| Importy, sloučení a hromadné akce s kontakty | Lidé se přidají hned. |
| [Stránka pro správu odběrů](/cs/docs/audiences/manage-subscriptions/) | Osoba se přidá hned. Odkaz na stránku dostala e-mailem, což už adresu potvrzuje. |

### Co se stane po přihlášení

1. Emailit vytvoří kontakt, pokud je nový, existující kontakt nezmění a pošle e-mail pro double opt-in. Osoba v seznamu zatím není. Lidé, kteří už přihlášení jsou, žádný e-mail nedostanou, ale URL pro přihlášení i tak vrátí `202`, takže neprozradí, kdo v seznamu je.
2. Když otevře odkaz, přidá se do seznamu se zapnutým **Subscribed**. Vyvolá se událost `subscriber.created` a spustí se automatizace **Added to audience**. Pokud je potvrzovací e-mail zapnutý, následuje i on.
3. Další otevření odkazu už nic neudělá. Platnost odkazů vyprší po 30 dnech. Lidé, kteří přihlášení nepotvrdili, se mohou přihlásit znovu a dostat nový odkaz. Dřívější odkazy fungují, dokud jim nevyprší platnost, a stačí potvrdit kterýkoli z nich. Opětovné přihlášení hned po prvním druhý e-mail nepošle, takže URL pro přihlášení nejde zneužít k zahlcení něčí schránky; první odkaz dál funguje.

Karta **Settings** ukazuje, kolik lidí přihlášení ještě nepotvrdilo. Pokud e-mail nejde odeslat, například protože doména už není ověřená nebo workspace nemá kredity, osoba se nepřidá a URL pro přihlášení vrátí `503`. Formulář místo toho osobu přidá hned, aby se přihlášení neztratilo, a chyba se zaznamená u odpovědi.

## Posílejte potvrzovací e-mail

1. **Otevřete nastavení.** Na kartě **Settings** seznamu přejděte do panelu **Confirmation email**.

2. **Napište e-mail.** Do pole **From** zadejte adresu na ověřené doméně a pak upravte texty. Pokud chcete lidi poslat na svůj web, vyplňte **Button text** a **Button link**; když je necháte prázdné, e-mail bude bez tlačítka.

3. **Zapněte ho.** Zapněte **Send it** a vyberte **Save**.

Potvrzovací e-mail dostanou lidé, kteří se přidají přes URL pro přihlášení, formulář, odkaz pro double opt-in nebo stránku pro správu odběrů. Když lidi přidáváte sami, odešle se, jen když o to požádáte: v dialogovém okně **Add subscriber** zaškrtněte **Send the confirmation email**, nebo v API předejte `"send_confirmation_email": true`. Importy a sloučení ho nikdy neposílají.

Když se potvrzovací e-mail nepodaří odeslat, přihlášení se tím nezruší.

## Proměnné

Předmět, texty i vlastní designy mohou používat proměnné jazyka [Temple](/cs/docs/templates/temple/). Hodnoty kontaktu se před vložením do e-mailu escapují.

| Proměnná | Hodnota |
| --- | --- |
| `{{confirm_url}}` | Potvrzovací odkaz. Jen pro double opt-in. |
| `{{manage_subscriptions_url}}` | Odkaz osoby na [správu odběrů](/cs/docs/audiences/manage-subscriptions/). Jen pro potvrzovací e-mail. |
| `{{audience_name}}` | Veřejný název seznamu, nebo jeho název, pokud veřejný název nemá. |
| `{{email}}`, `{{first_name}}`, `{{last_name}}` | Údaje kontaktu. Pro prázdné hodnoty použijte výchozí hodnotu, například `{{first_name\|"there"}}`. |

Pole **Text** a **Footer** zachovávají zalomení řádků a přijímají řádkové HTML, například `<a>` a `**`. Pole **Heading** a **Button text** jsou prostý text. Tlačítko v e-mailu pro double opt-in vždy odkazuje na `{{confirm_url}}`.

## Navrhněte e-mail v MJML

> **MJML je v alfaverzi:** Dokud vizuální editor MJML testujeme, je otevřený jen týmu Emailitu. Všichni ostatní používají výchozí design se všemi texty výše. Viz [Editory a API pro MJML](/cs/docs/templates/mjml/).

Pokud chcete změnit rozvržení, vyberte **Customize in the MJML visual editor**. Editor se otevře s výchozím designem a vašimi aktuálními texty. Uložením se e-mail přepne na **Custom design (MJML)**. Pokud chcete znovu použít texty, přepněte **Design** zpět na **Default design**; vlastní design zůstane uložený.

Vlastní e-mail pro double opt-in musí odkazovat na `{{confirm_url}}`. Uložení e-mailu bez tohoto odkazu selže se zprávou „The double opt-in email must link to `{{confirm_url}}`.“

## Otestujte e-maily

Pod každým náhledem zadejte adresu do pole **Send a test to** a vyberte **Send test**. Test používá uloženou verzi, takže změny nejdřív uložte. Testovací e-maily používají ukázkové hodnoty kontaktu a jejich odkazy nikoho nepřihlásí.

## Práce s API

Oba e-maily nastavíte endpointem [Úprava seznamu kontaktů](/cs/docs/api-reference/audiences/update/). Pošlete jen pole, která chcete změnit:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "double_opt_in": {
      "enabled": true,
      "redirect_url": "https://example.com/welcome",
      "email": { "from": "News <news@example.com>", "subject": "Confirm your subscription to {{audience_name}}" }
    },
    "confirmation_email": {
      "enabled": true,
      "email": { "from": "News <news@example.com>", "button_label": "Read the latest issue", "button_url": "https://example.com/blog" }
    }
  }'
```

Při přidávání osoby pak požádejte o potvrzení:

```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", "double_opt_in": true }'
```

Odpověď je `202` s `"status": "pending"`. Nastavení vlastního designu (`email.source`) přes API je součástí alfaverze MJML.

## Související

  - [Stránka pro správu odběrů](/cs/docs/audiences/manage-subscriptions/): Umožněte lidem vybrat si své seznamy.
  - [URL pro přihlášení](/cs/docs/audiences/subscribe-url/): Sbírejte přihlášky z vlastního webu.

---
Zdroj: https://emailit.com/cs/docs/audiences/double-opt-in/