# Eventi dei segmenti

> Contatti che entrano in un segmento tracciato o ne escono.



## segment.contact_added

> Inviato quando un contatto entra in un segmento tracciato, con il segmento, il contatto, il motivo e il momento dell’ingresso. Alpha: aperto solo al team di Emailit.

# segment.contact_added

Inviato quando un contatto inizia a corrispondere a un [segmento tracciato](/it/docs/segments/tracked/). I segmenti non tracciati non inviano questo evento. Non lo invia nemmeno il primo conteggio dopo la creazione di un segmento tracciato o dopo la ripresa del tracciamento.

> **I segmenti sono in alpha:** I segmenti sono aperti solo al team di Emailit mentre li testiamo. Vedi [Chi può usare i segmenti](/it/docs/segments/#who-can-use-segments).

Lo stesso ingresso avvia le automazioni con il trigger **Added to segment** e, su questo evento, soddisfa gli obiettivi e fa riprendere i passaggi **Wait until**, a meno che `reason` non sia `segment_updated`.

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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"
    }
  }
}
```

## Campi

- `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `segment.contact_added`.

- `object` (object): La modifica dell’appartenenza descritta dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto appartenenza al segmento

- `object` (string): Sempre `segment_membership`.

- `segment` (object): `id` e `name` del segmento.

- `contact` (object): Il contatto: `id`, `email`, `first_name`, `last_name` e `custom_fields`.

- `reason` (string): Perché il contatto è entrato: `contact` quando sono cambiati dei contatti, comprese le importazioni e le liste eliminate, `schedule` quando lo ha trovato la sincronizzazione giornaliera, ad esempio perché una regola su una data ora corrisponde, oppure `segment_updated` quando sono stati modificati l’origine o i filtri del segmento.

- `joined_at` (string): Quando Emailit ha registrato l’ingresso, in formato ISO 8601 con offset UTC.

---
Fonte: https://emailit.com/it/docs/webhooks/events/segment/segment-contact-added/

## segment.contact_removed

> Inviato quando un contatto esce da un segmento tracciato, con il segmento, il contatto, il motivo e il momento dell’uscita. Alpha: aperto solo al team di Emailit.

# segment.contact_removed

Inviato quando un contatto smette di corrispondere a un [segmento tracciato](/it/docs/segments/tracked/). I segmenti non tracciati non inviano questo evento, e nemmeno i contatti che escono perché sono stati eliminati.

> **I segmenti sono in alpha:** I segmenti sono aperti solo al team di Emailit mentre li testiamo. Vedi [Chi può usare i segmenti](/it/docs/segments/#who-can-use-segments).

La stessa uscita avvia le automazioni con il trigger **Removed from segment** e termina le esecuzioni con questa condizione di uscita, a meno che `reason` non sia `segment_updated`.

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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"
    }
  }
}
```

## Campi

- `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `segment.contact_removed`.

- `object` (object): La modifica dell’appartenenza descritta dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto appartenenza al segmento

- `object` (string): Sempre `segment_membership`.

- `segment` (object): `id` e `name` del segmento.

- `contact` (object): Il contatto com’è ora: `id`, `email`, `first_name`, `last_name` e `custom_fields`.

- `reason` (string): Perché il contatto è uscito: `contact` quando sono cambiati dei contatti, comprese le importazioni e le liste eliminate, `schedule` quando lo ha trovato la sincronizzazione giornaliera, ad esempio perché una regola su una data non corrisponde più, oppure `segment_updated` quando sono stati modificati l’origine o i filtri del segmento.

- `left_at` (string): Quando Emailit ha registrato l’uscita, in formato ISO 8601 con offset UTC.

---
Fonte: https://emailit.com/it/docs/webhooks/events/segment/segment-contact-removed/
