# Testování a naplánování kampaně

> Pošlete testovací e-maily, zobrazte náhled kampaně jako skutečný kontakt, odešlete ji hned, nebo ji naplánujte, zrušte naplánování a sledujte, co se děje během odesílání kampaně.

Než kampaň odejde, zkontrolujte ji ve vlastní schránce a s údaji skutečných kontaktů. Pak ji odešlete hned, nebo zvolte čas. Tato stránka popisuje testování, plánování, rušení naplánování a co se děje během odesílání kampaně, ve webovém rozhraní i přes API.

## Pošlete testovací e-mail

Testovací e-maily chodí na vaše vlastní adresy, abyste e-mail mohli zkontrolovat ve skutečných schránkách a e-mailových klientech.

1. **Otevřete krok s testováním.** V průvodci kampaní přejděte na **Preview and test**.

2. **Zadejte adresy.** V části **Send test** napište až 5 adres oddělených čárkami, mezerami nebo středníky, například `me@acme.com, colleague@acme.com`.

3. **Odešlete.** Vyberte **Send test**. Potvrzení zní „Test email is being sent.“

Testovací e-maily se od skutečné kampaně liší:

- **Slučovací značky používají zástupná data.** `{{email}}` se nahradí testovací adresou. Křestní jméno, příjmení a vlastní pole zůstanou prázdné. Skutečné hodnoty zkontrolujete přes [Preview as contact](#preview-as-a-contact).
- **Odkaz pro odhlášení nikoho neodhlásí.**
- **Načtení a prokliky se neměří** a testy se nezapočítávají do reportu kampaně.
- **Limity:** až 5 adres na jeden test a 3 testy za minutu. Kampaň nejdřív potřebuje **From email**.
- **Workspace v režimu sandbox** mohou posílat testy jen na adresy účtů členů workspace. Viz [Produkční přístup](/cs/docs/workspaces/production-access/).

Testovací e-maily se zobrazují v **Email API → Emails** stejně jako jiná odchozí pošta.

## Zobrazte náhled jako konkrétní kontakt

Ve stejném kroku **Preview as contact** vykreslí kampaň s údaji jednoho kontaktu. Vyhledejte kontakt podle jména nebo e-mailu a náhled ukáže předmět a obsah tak, jak je daná osoba uvidí, s textem „Previewing as“ a jejím jménem nad ním. Přepínáním mezi **Desktop** a **Mobile** zkontrolujete obě šířky.

Použijte ho k odhalení prázdných jmen, špatných klíčů vlastních polí a značek, které se nenahradily. Viz [Slučovací značky](/cs/docs/campaigns/merge-tags/).

## Odešlete hned, nebo naplánujte

V kroku **Send** vyberte **Send campaign** a zvolte kdy:

| Možnost | Co se stane |
| --- | --- |
| **Immediately** | Vyberte **Send now**. Kampaň přejde do stavu **In process** a odesílání začne hned. |
| **Schedule** | V poli **Schedule for** vyberte datum a čas a vyberte **Schedule**. Kampaň přejde do stavu **Scheduled**. |

Při plánování platí:

- **Čas je v časovém pásmu vašeho počítače.** Výchozí hodnota pole je nejbližší celá hodina. Emailit čas ukládá v UTC.
- **Musí být v budoucnosti.** Jinak dialogové okno zobrazí „Pick a time in the future.“
- **Odesílání začne do minuty od zvoleného času.** Emailit kontroluje kampaně k odeslání každou minutu.
- **Příjemci se určí při zahájení odesílání**, takže lidé, kteří se mezitím k vašim seznamům přidají nebo z nich odejdou, se započítají správně.
- **Kampaň je uzamčená.** Upravovat lze jen koncepty. Pokud chcete naplánovanou kampaň změnit, nejdřív zrušte naplánování.

## Zrušte naplánování

1. **Najděte kampaň.** Na stránce **Email Marketing → Campaigns** otevřete kartu **Scheduled**.

2. **Zrušte naplánování.** V nabídce řádku nebo nahoře na stránce kampaně vyberte **Cancel Schedule** a potvrďte.

Kampaň se vrátí do stavu **Draft** bez času odeslání, takže ji můžete upravit a znovu odeslat, nebo naplánovat. Během posledních 5 minut před naplánovaným časem zrušit nejde. Webové rozhraní pak zobrazí „Campaign cannot be canceled less than 5 minutes before scheduled time.“

## Během odesílání kampaně

Když odesílání začne, Emailit vybere příjemce, přeskočí odhlášené a blokované adresy a po dávkách vytvoří jeden e-mail pro každého příjemce. Stránka kampaně mezitím zobrazuje:

- Panel **In process**: „This campaign is still sending. Counts update as messages move through delivery.“
- **Send progress**: podíl vytvořených e-mailů, které opustily frontu, například „1,200 of 5,000 created messages have left the unprocessed queue.“
- Průběžné počty pro **Sent**, **Delivered**, **Attempted**, **Not processed**, **Bounced**, **Suppressed** a **Complained**. Viz [Reporty kampaní](/cs/docs/campaigns/reports/#metrics).

Jakmile jsou vytvořeny e-maily pro všechny příjemce, stav se změní na **Sent**. Doručování pak pokračuje: e-maily na dočasně nedostupné servery se zkoušejí doručit ještě až přibližně 21 hodin a načtení a prokliky dál přibývají. Report se průběžně aktualizuje.

Kampaň, která začala odesílat, nelze ve webovém rozhraní zastavit, proto ji před odesláním otestujte.

## Práce s API

Koncept odešlete hned přes [Odeslání nebo naplánování kampaně](/cs/docs/api-reference/campaigns/send/):

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "sending",
  "message": "Campaign send initiated"
}
```

Pokud ho chcete naplánovat, předejte `scheduled_at` jako datum a čas v budoucnosti ve formátu ISO 8601. Funguje i unixové časové razítko. Naplánovat lze jen koncepty:

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "scheduled_at": "2026-10-15T09:00:00Z" }'
```

```json
{
  "object": "campaign",
  "id": "cmp_4Tq9Xv2kLm8Rw",
  "name": "October newsletter",
  "status": "scheduled",
  "scheduled_at": "2026-10-15T09:00:00Z",
  "message": "Campaign is scheduled"
}
```

| Chyba | Příčina |
| --- | --- |
| `403` | Workspace ještě nemá produkční přístup. |
| `422` „Invalid scheduled_at“ | `scheduled_at` není platné datum v budoucnosti. |
| `422` „Campaign cannot be scheduled“ | Kampaň není koncept. |

[Zrušení kampaně](/cs/docs/api-reference/campaigns/cancel/) nastaví kampaň ve stavu `draft` nebo `sending` na `canceled`. E-maily, které už byly pro příjemce vytvořeny, přesto odejdou. Pokud chcete naplánovanou kampaň vrátit do konceptu, použijte ve webovém rozhraní **Cancel Schedule**.

Průběh sledujte přes [události webhooků](/cs/docs/webhooks/event-types/) `campaign.scheduled`, `campaign.queued`, `campaign.sending`, `campaign.sent` a `campaign.canceled`.

## Související

  - [Reporty kampaní](/cs/docs/campaigns/reports/): Co jednotlivé metriky znamenají.
  - [Vytvoření kampaně](/cs/docs/campaigns/create/): Celý průvodce.

---
Zdroj: https://emailit.com/cs/docs/campaigns/test-and-schedule/