# Eventos de segmento

> Contatos que entram em um segmento rastreado ou saem dele.



## segment.contact_added

> Enviado quando um contato entra em um segmento rastreado, com o segmento, o contato, o motivo e quando ele entrou. Alfa: aberto apenas à equipe do Emailit.

# segment.contact_added

Enviado quando um contato passa a corresponder a um [segmento rastreado](/pt/docs/segments/tracked/). 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.

> **Os segmentos estão em alfa:** Os segmentos estão abertos apenas à equipe do Emailit enquanto os testamos. Consulte [Quem pode usar os segmentos](/pt/docs/segments/#who-can-use-segments).

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](/pt/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"
    }
  }
}
```

## Campos

- `event_id` (string): 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](/pt/docs/api-reference/events/get/).

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

- `object` (object): A mudança de participação que o evento descreve. Os campos dela estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de participação em segmento

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

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

- `contact` (object): O contato: `id`, `email`, `first_name`, `last_name` e `custom_fields`.

- `reason` (string): 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_at` (string): Quando o Emailit registrou a entrada, em ISO 8601 com deslocamento UTC.

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

## segment.contact_removed

> Enviado quando um contato sai de um segmento rastreado, com o segmento, o contato, o motivo e quando ele saiu. Alfa: aberto apenas à equipe do Emailit.

# segment.contact_removed

Enviado quando um contato deixa de corresponder a um [segmento rastreado](/pt/docs/segments/tracked/). 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.

> **Os segmentos estão em alfa:** Os segmentos estão abertos apenas à equipe do Emailit enquanto os testamos. Consulte [Quem pode usar os segmentos](/pt/docs/segments/#who-can-use-segments).

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](/pt/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"
    }
  }
}
```

## Campos

- `event_id` (string): 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](/pt/docs/api-reference/events/get/).

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

- `object` (object): A mudança de participação que o evento descreve. Os campos dela estão listados abaixo.

- `data.object` (object): O mesmo objeto de novo, no formato que a [API de eventos](/pt/docs/api-reference/events/get/) retorna em `data`.

### Objeto de participação em segmento

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

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

- `contact` (object): O contato como ele está agora: `id`, `email`, `first_name`, `last_name` e `custom_fields`.

- `reason` (string): 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_at` (string): Quando o Emailit registrou a saída, em ISO 8601 com deslocamento UTC.

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