# Události

> Procházejte události, které Emailit zaznamenává pro váš workspace, ve webovém rozhraní nebo přes Events API a použijte je k doplnění nebo sesouhlasení webhooků.

Událost je záznam o tom, že se ve vašem workspace něco stalo: e-mail byl doručen, někdo klikl na odkaz, na vaši příchozí subdoménu dorazila zpráva, vznikl kontakt. Emailit ukládá každou událost, zobrazuje je ve webovém rozhraní a sestavuje z nich každý požadavek [webhooku](/cs/docs/webhooks/). Tato stránka vysvětluje, jak události procházet a číst přes API.

## Co událost obsahuje

| Pole | Popis |
| --- | --- |
| `id` | ID události začínající na `evt_`. V požadavcích webhooků se jmenuje `event_id`. |
| `type` | Co se stalo, například `email.delivered` nebo `contact.created`. Viz [Typy událostí](/cs/docs/webhooks/event-types/). |
| `data.object` | Zdroj, kterého se událost týká, například e-mail, proklik, doména nebo kontakt, ve stavu z okamžiku události. |
| `created_at` | Kdy byla událost zaznamenána. |

```json
{
  "object": "event",
  "id": "evt_2xGk7Nq1VbD5sR8tLmW3eYhC6aP",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_2xGk7Lr3XcB8pQ1wYzK4dTfG9hJ",
      "object": "email",
      "from": "billing@acme.com",
      "to": "ada@example.com",
      "subject": "Your receipt #1042",
      "status": "delivered",
      "meta": { "order_id": "1042" },
      "updated_at": "2026-10-01T09:14:03.512000+00:00",
      "created_at": "2026-10-01T09:14:01.207000+00:00"
    }
  },
  "created_at": "2026-10-01T09:14:03.540000+00:00"
}
```

## Události a webhooky

Události jsou zdrojem požadavků webhooků. Když Emailit zaznamená událost, zařadí do fronty požadavek pro každý zapnutý webhook, který odebírá daný typ události a jehož [filtr obsahu](/cs/docs/webhooks/set-up/#filter-events-by-payload) odpovídá. Událost se uloží bez ohledu na to, jestli ji nějaký webhook dostane.

Z toho plynou dva důsledky:

- Webhook dostává jen události, které nastanou, dokud existuje a je zapnutý. Události zaznamenané v době, kdy byl webhook vypnutý, nebo před jeho vytvořením se mu dodatečně neodesílají.
- Seznam událostí můžete použít k doplnění mezer. Po výpadku nebo období, kdy byl webhook vypnutý, načtěte přes API události z tohoto časového okna a zpracujte ty, které váš webhook zmeškal. Duplicity odstraňujte podle ID události, což je stejné ID `evt_`, které webhooky používají jako `event_id`.

## Procházejte události ve webovém rozhraní

Otevřete **Email API → Events**. Tabulka zobrazuje u každé události **Event type**, **ID** a čas **Created**, od nejnovějších.

- Ve výchozím stavu stránka zobrazuje poslední 2 dny. Pokud chcete jít dál do minulosti v rámci doby uchovávání, přidejte filtr **Created**.
- Filtrem **Type** zobrazíte jen jeden druh událostí, například jen `email.bounced`.
- Výběrem události zobrazíte její čas **Created**, **Type** a celý **Payload** jako JSON s tlačítkem pro zkopírování.

## Čtěte události přes API

Oba endpointy potřebují API klíč s oprávněním **Full Access**.

### Výpis událostí

[Výpis událostí](/cs/docs/api-reference/events/list/) vrací události od nejnovějších.

| Parametr dotazu | Popis |
| --- | --- |
| `type` | Jeden typ, nebo několik typů oddělených čárkami, například `email.bounced,email.complained`. |
| `include_data` | `true`, pokud chcete u každé události i `data`. Výchozí hodnota je `false`, která vrací jen `id`, `type` a `created_at`. |
| `page`, `limit` | Číslo stránky a velikost stránky. `limit` je od 1 do 100, výchozí hodnota je 100. |
| `created_at.after`, `created_at.before` | Filtry podle data. Viz [Filtrování](/cs/docs/api-reference/filtering/). |

```bash
curl -G https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  --data-urlencode "type=email.bounced,email.complained" \
  --data-urlencode "created_at.after=2026-09-28T00:00:00Z" \
  --data-urlencode "include_data=true"
```

```json
{
  "data": [
    {
      "object": "event",
      "id": "evt_2xGkB3n8WqZ5cT1vRmK7pLsD4hY",
      "type": "email.bounced",
      "data": { "object": { "id": "em_2xGkA9m1PdX6bR3sQnJ8tKfW2eV", "object": "email", "status": "bounced" } },
      "created_at": "2026-09-30T17:02:41.118000+00:00"
    }
  ],
  "next_page_url": "/v2/events?page=2&limit=100&type=email.bounced%2Cemail.complained&include_data=true",
  "previous_page_url": null
}
```

Rychlost tohoto endpointu zajišťují dva limity:

- **Výchozí okno.** Bez filtru `created_at` pokrývá výpis poslední 2 dny. Starší události načtete s `created_at.after`.
- **Hloubka stránkování.** Offset `(page - 1) × limit` nesmí být větší než 2 500. Hlubší stránky vracejí `422` s kódem `events_offset_too_large`. Místo dalšího stránkování požadavek zužte pomocí `type` nebo rozsahu `created_at`.

### Načtení události

[Načtení události](/cs/docs/api-reference/events/get/) vrací jednu událost podle jejího ID `evt_`, vždy s `data`.

```bash
curl https://api.emailit.com/v2/events/evt_2xGk7Nq1VbD5sR8tLmW3eYhC6aP \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

## Dohledejte zmeškané události webhooků

1. **Zvolte časové okno.** Poznamenejte si, kdy váš endpoint začal selhávat nebo kdy byl webhook vypnut, a kdy byl problém odstraněn.

2. **Vypište události.** Zavolejte `GET /v2/events` s `created_at.after` a `created_at.before` nastavenými na toto okno, s hodnotami `type`, které váš webhook zpracovává, a s `include_data=true`. Pokračujte podle `next_page_url`, dokud není `null`. Pokud narazíte na `events_offset_too_large`, rozdělte okno na kratší úseky.

3. **Zpracujte, co jste ještě neviděli.** Přeskočte události, jejichž ID už máte uložené jako zpracované, a ostatní zpracujte stejným kódem, jaký používá váš webhook.

U požadavků, které byly zařazeny do fronty, ale selhaly, je jednodušší použít u webhooku [Retry failed](/cs/docs/webhooks/retries-and-failures/#retry-failed-requests), pokud jsou chyby mladší než 7 dní.

## Uchovávání

Události se řídí dobou uchovávání **Logy**, stejně jako logy požadavků a požadavky webhooků:

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Uchovávání logů požadavků | 7 dní | 30 dní | 30 dní | Flexibilní |

## Související

  - [Typy událostí](/cs/docs/webhooks/event-types/)
  - [Events API](/cs/docs/api-reference/events/)

---
Zdroj: https://emailit.com/cs/docs/logs/events/