Segmentos

Um segmento é um filtro salvo sobre os contatos da equipe — ele armazena uma expressão de filtro, não uma lista de membros. Quem faz parte do segmento é avaliado ao vivo: um contato que passa a corresponder ao filtro entra no segmento imediatamente, e a contagem de contatos que você vê é computada no momento da leitura.

Um segmento criado sem filtro é uma lista manual de membros: você adiciona e remove contatos explicitamente (pelo painel, ou via POST /contacts/{id}/segments/{segmentId} e o add_contact_to_segment do MCP). Os dois tipos valem igualmente como alvo de transmissões.

Os filtros atuam sobre campos do contato (e-mail, nome, estado de inscrição, data de criação) e sobre propriedades personalizadas, com operadores como igual, contém, definido / não definido e comparações de data. As condições combinam com e/ou.

DatasCopiar link da seção

created_at e qualquer propriedade aceitam quatro operadores de data:

{
  "match": "all",
  "conditions": [
    { "field": "property:last_login", "op": "not_in_last_days", "value": "90" }
  ]
}

A propriedade é lida como data do mesmo jeito que uma propriedade de data aceita uma. Um valor que não é data não entra em nenhum desses operadores, e uma data que ainda vai chegar não entra em in_last_days nem em not_in_last_days. Para achar contatos sem a propriedade, use is_not_set. Os operadores de texto valem para qualquer propriedade, seja qual for o tipo. No painel, os operadores de data aparecem para created_at e para as propriedades de data.

Usando segmentosCopiar link da seção

• Transmissões — envie para um segmento em vez de todos os contatos. O fan-out resolve quem faz parte do segmento no momento do envio usando o mesmo tradutor de filtros da contagem de contatos, então o que você prevê é o que sai.
• Filtro no painel — a visão de Contatos pode ser filtrada por segmento, e a exportação CSV respeita o filtro de segmento ativo.

APICopiar link da seção

POST/GET/PATCH/DELETE /segments e GET /segments/{id} (que inclui o contact_count ao vivo) — veja a referência da API. Expressões de filtro inválidas são rejeitadas com 422 e nunca armazenadas. Um PATCH sem name e sem filter também recebe 422.