# Segmentos

> Os segmentos são filtros salvos sobre os seus contatos. Monte-os a partir de todos os contatos ou de listas escolhidas, envie campanhas para eles ou deixe-os de fora, e confira o limite de segmentos do seu plano. Alfa: aberto apenas à equipe do Emailit.

Um segmento é um filtro salvo sobre os contatos do seu workspace, como “Clientes no plano Pro” ou “Cadastrados nos últimos 30 dias”. Você não adiciona pessoas a um segmento: todos que correspondem às regras dele estão nele, e mais ninguém. Use segmentos para enviar uma [campanha](/pt/docs/campaigns/) a uma parte dos seus contatos ou para deixar pessoas de fora de uma campanha.

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

## Quem pode usar os segmentos

Durante a fase alfa, os segmentos estão disponíveis apenas para os administradores da plataforma Emailit. O papel Admin de um workspace não é suficiente.

| Onde | Equipe do Emailit | Todos os outros |
| --- | --- | --- |
| Painel | **Email Marketing → Segments**, os seletores de segmentos nas campanhas, os gatilhos de segmento nas automações e os eventos de segmento nos webhooks | **Segments** no menu mostra **Soon** e não pode ser aberto. Os seletores ficam ocultos, mas uma campanha ou automação que já usa um segmento continua mostrando-o. |
| API e MCP | A API de segmentos, os segmentos como destinatários e os gatilhos de segmento, e as ferramentas de segmentos do MCP | `403` com `error: "segments_alpha"` |
| Chaves de API | Nenhuma. As chaves de API pertencem a um workspace, não a uma pessoa. | `403` com `error: "segments_alpha"` |

As campanhas e automações que já usam um segmento continuam funcionando para todos no workspace, e os segmentos rastreados continuam sendo atualizados.

## Como os segmentos funcionam

Um segmento tem duas partes:

- **Origem.** Todos os contatos do workspace, ou apenas os inscritos das listas de contatos que você escolher.
- **Filtros.** Grupos de regras sobre os campos do contato, os [campos personalizados](/pt/docs/contacts/custom-fields/), a participação em listas e as [tags e a pontuação de lead](/pt/docs/contacts/tags-and-score/), por exemplo **Email domain** é `acme.com`, **plan** é qualquer um de `pro`, `enterprise`, ou **Tags** tem qualquer uma de `vip`. Cada grupo exige todas as suas regras ou qualquer uma delas, e o segmento exige todos os seus grupos ou qualquer um deles. Sem filtros, todos da origem estão no segmento.

O Emailit avalia um segmento sempre que ele é contado, listado ou usado em um envio, então ele está sempre atualizado. Uma campanha agendada para a próxima semana chega a quem corresponder ao segmento no momento do envio, e regras como “criado nos últimos 30 dias” acompanham a data.

### Quem as campanhas podem alcançar

Cada segmento mostra duas contagens: **Contacts**, todos que correspondem a ele, e **Subscribed**, a parte para a qual as campanhas podem enviar. Um contato está inscrito quando não está descadastrado globalmente e está inscrito em pelo menos uma lista, qualquer que seja. Os contatos que nunca entraram em uma lista correspondem a segmentos, mas não recebem campanhas. Os endereços suprimidos continuam sendo contados e são ignorados quando a campanha é enviada.

O campo **Subscription status** usa a mesma regra, então **Subscription status** é `subscribed` restringe um segmento aos contatos que as campanhas podem alcançar.

## Criar um segmento

1. Acesse **Email Marketing → Segments** e selecione **Create segment**.
2. Em **Details**, digite um nome em **Name** e, se quiser, uma descrição para a sua equipe em **Description**.
3. Em **Type**, escolha **Segment** ou **Tracked segment**. Não é possível mudar o tipo depois. Consulte [Segmentos simples e rastreados](#plain-and-tracked-segments).
4. Em **Contacts from**, escolha **All contacts** ou **Subscribers of specific audiences** e selecione as listas em **Audiences**.
5. Em **Filters**, selecione **Add condition** e escolha um campo, um operador e um valor. Use **Add group** para criar outro grupo de condições e alterne entre **all** e **any** para decidir como as condições e os grupos se combinam.
6. Confira a prévia em **Preview**: o número de contatos em **Matching contacts**, quantos deles estão inscritos e as primeiras correspondências em **First matches**. Ela é atualizada conforme você edita.
7. Selecione **Save segment**.

Você também pode começar um segmento a partir de outras páginas:

- **Save as segment** na lista de contatos transforma os filtros atuais da lista em um segmento. Os filtros que os segmentos não aceitam ficam de fora, e o editor os lista.
- **Create segment** no menu da página de uma lista de contatos começa um segmento com essa lista como origem.
- **Duplicate** no menu da linha de um segmento o copia como um novo segmento.

Para a lista completa de campos, operadores e valores, consulte [Criar um segmento](/pt/docs/api-reference/segments/create/#conditions) na referência da API.

## A página do segmento

Selecione um segmento em **Email Marketing → Segments** para abri-lo. A página mostra os números de **Contacts**, **Subscribed** e **Updated**, a definição do segmento em **Definition** e os contatos que correspondem a ele agora, com busca e filtros. Os contatos são listados em tempo real, então a lista muda conforme os contatos mudam.

No cabeçalho, você pode editar o segmento com **Edit**, criar uma campanha que envia para ele com **Create campaign** ou excluí-lo com **Delete**, no menu.

## Enviar uma campanha para um segmento

Na etapa **Recipients** da campanha, escolha um ou mais segmentos em **Segments**, sozinhos ou junto com listas em **Audiences**. Para deixar pessoas de fora, use **Exclude audiences** e **Exclude segments**. Consulte [Criar uma campanha](/pt/docs/campaigns/create/#step-1-recipients).

- **Avaliados no momento do envio.** O Emailit define os destinatários quando o envio começa, então os contatos que corresponderem até lá são incluídos e os que deixaram de corresponder ficam de fora.
- **Uma cópia por endereço.** Um contato que está em várias listas e segmentos selecionados recebe a campanha uma vez.
- **As exclusões prevalecem.** Um contato em uma lista ou um segmento excluído é ignorado, mesmo que também esteja em um selecionado.
- **Exclusões apagadas impedem o envio.** Se uma campanha exclui uma lista ou um segmento que não existe mais, o Emailit não a envia: o envio retorna um erro, e uma campanha agendada volta para **Draft**. Atualize os destinatários dela e envie-a de novo.

Não é possível excluir um segmento enquanto uma campanha agendada ou em envio o usa. Excluir um segmento o remove das campanhas em rascunho que enviam para ele. Os rascunhos que o deixam de fora mantêm a exclusão e não podem ser enviados até você substituí-la, para que as pessoas que você queria deixar de fora nunca os recebam.

## Segmentos simples e rastreados

Ao criar um segmento, você escolhe o tipo dele:

| | **Segment** | **Tracked segment** |
| --- | --- | --- |
| Contagens, lista de contatos e campanhas | Em tempo real | Em tempo real |
| Registra quem entra e quem sai, e quando | Não | Sim |
| Inicia automações com as entradas e saídas | Não | Sim |
| Envia os webhooks `segment.contact_added` e `segment.contact_removed` | Não | Sim |
| Gráfico **Growth** e coluna **Joined** | Não | Sim |
| Planos | Todos | Pro, Business e Custom |

O tipo é fixo depois que o segmento existe. Para mudar, crie um novo segmento com as mesmas regras. Consulte [Segmentos rastreados](/pt/docs/segments/tracked/).

As automações também podem verificar qualquer segmento, rastreado ou não, em uma **Condition** If/Else, em uma meta, em uma etapa **Wait until** ou em uma condição de saída: **Segment** está em **VIP customers**. Consulte [Condition (If/Else)](/pt/docs/automations/steps/#condition-ifelse). Um segmento que uma automação usa não pode ser excluído até você alterar a automação.

## Limites

Cada plano inclui um número de segmentos por workspace. Os segmentos rastreados e os simples contam para o mesmo limite.

| | Pay as you go | Pro | Business | Custom |
| --- | --- | --- | --- | --- |
| Segmentos | 3 | 10 | 100 | Flexível |
| Segmentos rastreados | — | Incluídos | Incluídos | Incluídos |

A lista de segmentos mostra quantos você já usou, por exemplo `3/10 used`. Quando você atinge o limite, **Create segment** e **Duplicate** ficam desativados até você excluir um segmento ou [fazer upgrade do seu plano](/pt/docs/billing/plans/). A API retorna `422` com o `usage` atual:

```json
{
  "error": "Pay as you go includes 3 segments.",
  "message": "Pay as you go includes 3 segments.",
  "usage": { "used": 3, "limit": 3 }
}
```

Se você fizer downgrade, os seus segmentos continuam funcionando, mas você não pode adicionar mais até ficar abaixo do novo limite. No Pay as you go, os segmentos rastreados são pausados. Consulte [Quando o rastreamento é pausado](/pt/docs/segments/tracked/#when-tracking-pauses).

Um segmento pode ter até 10 grupos e 50 regras e usar como origem até 100 listas de contatos.

## Usar a API e o MCP

A [API de segmentos](/pt/docs/api-reference/segments/) permite [criar](/pt/docs/api-reference/segments/create/), [obter](/pt/docs/api-reference/segments/get/), [atualizar](/pt/docs/api-reference/segments/update/), [listar](/pt/docs/api-reference/segments/list/) e [excluir](/pt/docs/api-reference/segments/delete/) segmentos, [listar os contatos deles](/pt/docs/api-reference/segments/contacts/), [pré-visualizar](/pt/docs/api-reference/segments/preview/) uma definição antes de salvá-la e [listar os campos](/pt/docs/api-reference/segments/fields/) que as regras podem usar. A API exige uma chave de API com **Full Access**.

```bash
curl https://api.emailit.com/v2/segments \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme team",
    "conditions": { "rules": [{ "field": "email_domain", "operator": "equals", "value": "acme.com" }] }
  }'
```

Para enviar uma campanha a um segmento, adicione `{ "segment_id": "seg_…" }` aos `recipients` dela com [Atualizar uma campanha](/pt/docs/api-reference/campaigns/update/), ou `{ "segment_id": "seg_…", "exclude": true }` para deixá-lo de fora.

No [servidor MCP](/pt/docs/mcp/), o toolset `segments` tem as mesmas operações, então um assistente de IA pode montar e conferir segmentos para você. Consulte [Toolsets](/pt/docs/mcp/toolsets/).

## Próximos passos

  - [Segmentos rastreados](/pt/docs/segments/tracked/): Registre entradas e saídas e inicie automações.
  - [Criar uma campanha](/pt/docs/campaigns/create/): Envie para segmentos e deixe outros de fora.
  - [Campos personalizados](/pt/docs/contacts/custom-fields/): Guarde os dados que as suas regras filtram.
  - [API de segmentos](/pt/docs/api-reference/segments/): Todos os endpoints de segmentos.

---
Fonte: https://emailit.com/pt/docs/segments/