Eventos de segmento

Contatos que entram em um segmento rastreado ou saem dele.

segment.contact_added
segment.contact_removed

segment.contact_added

Enviado quando um contato passa a corresponder a um segmento rastreado. Os segmentos que não são rastreados não enviam este evento. A primeira contagem depois que um segmento rastreado é criado, ou depois que o rastreamento é retomado, também não o envia.

A mesma entrada inicia as automações com o gatilho Added to segment e atinge as metas e as etapas Wait until que usam esse evento, a menos que reason seja segment_updated.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre segment.contact_added.

objectobject

A mudança de participação que o evento descreve. Os campos dela estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de participação em segmento

objectstring

Sempre segment_membership.

segmentobject

id e name do segmento.

contactobject

O contato: id, email, first_name, last_name e custom_fields.

reasonstring

Por que o contato entrou: contact quando os contatos mudaram, incluindo importações e listas de contatos excluídas, schedule quando a sincronização diária o encontrou, por exemplo porque uma regra de data agora corresponde, ou segment_updated quando a origem ou os filtros do segmento foram editados.

joined_atstring

Quando o Emailit registrou a entrada, em ISO 8601 com deslocamento 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

Enviado quando um contato deixa de corresponder a um segmento rastreado. Os segmentos que não são rastreados não enviam este evento, e os contatos que saem porque foram excluídos também não.

A mesma saída inicia as automações com o gatilho Removed from segment e encerra as execuções que têm essa condição de saída, a menos que reason seja segment_updated.

As requisições de webhook trazem um array JSON de eventos como este; consulte Requisições de webhook.

Campos

event_idstring

ID do evento (evt_…). Uma nova tentativa da requisição traz o mesmo ID, então use-o para ignorar eventos que você já processou. Você também pode consultar o evento com Obter um evento.

typestring

Sempre segment.contact_removed.

objectobject

A mudança de participação que o evento descreve. Os campos dela estão listados abaixo.

data.objectobject

O mesmo objeto de novo, no formato que a API de eventos retorna em data.

Objeto de participação em segmento

objectstring

Sempre segment_membership.

segmentobject

id e name do segmento.

contactobject

O contato como ele está agora: id, email, first_name, last_name e custom_fields.

reasonstring

Por que o contato saiu: contact quando os contatos mudaram, incluindo importações e listas de contatos excluídas, schedule quando a sincronização diária o encontrou, por exemplo porque uma regra de data não corresponde mais, ou segment_updated quando a origem ou os filtros do segmento foram editados.

left_atstring

Quando o Emailit registrou a saída, em ISO 8601 com deslocamento 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"
    }
  }
}