# Události segmentů

> Kontakty, které vstoupí do sledovaného segmentu, nebo ho opustí.



## segment.contact_added

> Odesílá se, když kontakt vstoupí do sledovaného segmentu. Obsahuje segment, kontakt, důvod a čas vstupu. Alfaverze: otevřená jen týmu Emailitu.

# segment.contact_added

Odesílá se, když kontakt začne odpovídat [sledovanému segmentu](/cs/docs/segments/tracked/). Segmenty, které nejsou sledované, tuto událost neodesílají. Neodesílá ji ani první zápis členů po vytvoření sledovaného segmentu nebo po obnovení sledování.

> **Segmenty jsou v alfaverzi:** Dokud segmenty testujeme, jsou otevřené jen týmu Emailitu. Viz [Kdo může segmenty používat](/cs/docs/segments/#who-can-use-segments).

Stejný vstup spouští automatizace se spouštěčem **Added to segment** a splní cíle a kroky **Wait until**, které na tuto událost čekají, pokud `reason` není `segment_updated`.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "segment.contact_added",
  "object": {
    "object": "segment_membership",
    "segment": {
      "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
      "name": "Pro customers renewing soon"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "plan": "pro"
      }
    },
    "reason": "contact",
    "joined_at": "2026-10-18T12:00:00.000000+00:00"
  },
  "data": {
    "object": {
      "object": "segment_membership",
      "segment": {
        "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
        "name": "Pro customers renewing soon"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "plan": "pro"
        }
      },
      "reason": "contact",
      "joined_at": "2026-10-18T12:00:00.000000+00:00"
    }
  }
}
```

## Pole

- `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/).

- `type` (string): Vždy `segment.contact_added`.

- `object` (object): Změna členství, kterou událost popisuje. Její pole jsou uvedena níže.

- `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`.

### Objekt členství v segmentu

- `object` (string): Vždy `segment_membership`.

- `segment` (object): `id` a `name` segmentu.

- `contact` (object): Kontakt: `id`, `email`, `first_name`, `last_name` a `custom_fields`.

- `reason` (string): Proč kontakt vstoupil: `contact`, když se změnily kontakty, včetně importů a smazaných seznamů kontaktů, `schedule`, když ho našla denní synchronizace, například protože teď odpovídá datové pravidlo, nebo `segment_updated`, když se upravil zdroj nebo filtry segmentu.

- `joined_at` (string): Kdy Emailit vstup zaznamenal, ve formátu ISO 8601 s posunem vůči UTC.

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/segment/segment-contact-added/

## segment.contact_removed

> Odesílá se, když kontakt opustí sledovaný segment. Obsahuje segment, kontakt, důvod a čas odchodu. Alfaverze: otevřená jen týmu Emailitu.

# segment.contact_removed

Odesílá se, když kontakt přestane odpovídat [sledovanému segmentu](/cs/docs/segments/tracked/). Segmenty, které nejsou sledované, tuto událost neodesílají a neodesílá se ani u kontaktů, které odejdou kvůli smazání.

> **Segmenty jsou v alfaverzi:** Dokud segmenty testujeme, jsou otevřené jen týmu Emailitu. Viz [Kdo může segmenty používat](/cs/docs/segments/#who-can-use-segments).

Stejný odchod spouští automatizace se spouštěčem **Removed from segment** a ukončuje spuštění s touto podmínkou ukončení, pokud `reason` není `segment_updated`.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz [Požadavky webhooků](/cs/docs/webhooks/webhook-requests/).

```json
{
  "event_id": "evt_2xLd4Ks8Vp1Rm6Wc3Nt9Bh5Qy0e",
  "type": "segment.contact_removed",
  "object": {
    "object": "segment_membership",
    "segment": {
      "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
      "name": "Pro customers renewing soon"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "plan": "pro",
        "renews_on": "2026-12-01"
      }
    },
    "reason": "schedule",
    "left_at": "2026-10-18T00:30:05.000000+00:00"
  },
  "data": {
    "object": {
      "object": "segment_membership",
      "segment": {
        "id": "seg_2nYs9Kd1Lq3vB8wXcE4fT7uRm0p",
        "name": "Pro customers renewing soon"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "plan": "pro",
          "renews_on": "2026-12-01"
        }
      },
      "reason": "schedule",
      "left_at": "2026-10-18T00:30:05.000000+00:00"
    }
  }
}
```

## Pole

- `event_id` (string): ID události (`evt_…`). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint [Načtení události](/cs/docs/api-reference/events/get/).

- `type` (string): Vždy `segment.contact_removed`.

- `object` (object): Změna členství, kterou událost popisuje. Její pole jsou uvedena níže.

- `data.object` (object): Stejný objekt ještě jednou, v podobě, v jaké ho vrací [API událostí](/cs/docs/api-reference/events/get/) v poli `data`.

### Objekt členství v segmentu

- `object` (string): Vždy `segment_membership`.

- `segment` (object): `id` a `name` segmentu.

- `contact` (object): Kontakt v aktuální podobě: `id`, `email`, `first_name`, `last_name` a `custom_fields`.

- `reason` (string): Proč kontakt odešel: `contact`, když se změnily kontakty, včetně importů a smazaných seznamů kontaktů, `schedule`, když ho našla denní synchronizace, například protože už neodpovídá datové pravidlo, nebo `segment_updated`, když se upravil zdroj nebo filtry segmentu.

- `left_at` (string): Kdy Emailit odchod zaznamenal, ve formátu ISO 8601 s posunem vůči UTC.

---
Zdroj: https://emailit.com/cs/docs/webhooks/events/segment/segment-contact-removed/
