Eventi dei segmenti

Contatti che entrano in un segmento tracciato o ne escono.

segment.contact_added
segment.contact_removed

segment.contact_added

Inviato quando un contatto inizia a corrispondere a un segmento tracciato. 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.

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.

Campi

event_idstring

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.

typestring

Sempre segment.contact_added.

objectobject

La modifica dell’appartenenza descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto appartenenza al segmento

objectstring

Sempre segment_membership.

segmentobject

id e name del segmento.

contactobject

Il contatto: id, email, first_name, last_name e custom_fields.

reasonstring

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_atstring

Quando Emailit ha registrato l’ingresso, in formato ISO 8601 con offset UTC.

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"
    }
  }
}

segment.contact_removed

Inviato quando un contatto smette di corrispondere a un segmento tracciato. I segmenti non tracciati non inviano questo evento, e nemmeno i contatti che escono perché sono stati eliminati.

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.

Campi

event_idstring

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.

typestring

Sempre segment.contact_removed.

objectobject

La modifica dell’appartenenza descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto appartenenza al segmento

objectstring

Sempre segment_membership.

segmentobject

id e name del segmento.

contactobject

Il contatto com’è ora: id, email, first_name, last_name e custom_fields.

reasonstring

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_atstring

Quando Emailit ha registrato l’uscita, in formato ISO 8601 con offset UTC.

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"
    }
  }
}