> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selltrust.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Campanhas de email

> Estados, público, fila de envio e descadastro

Uma campanha é um email (assunto + HTML com Liquid) enviado a um público dos clientes da própria loja.

## Estados

| `status` | Significado | Pode |
| - | - | - |
| `DRAFT` | Rascunho | Editar, enviar, agendar, duplicar, apagar |
| `SCHEDULED` | Agendada | Editar, reagendar, enviar agora, cancelar, duplicar |
| `SENDING` | Na fila de envio | Cancelar (interrompe), duplicar |
| `SENT` | Enviada | Duplicar, apagar |
| `CANCELED` | Cancelada | Duplicar, apagar |

## Público

`audience` tem `match` (`ALL` = todas as regras, `ANY` = qualquer regra) e `rules`. Sem regras, a campanha vai para todos os clientes da loja.

| `type` | Campos | Quem entra |
| - | - | - |
| `PURCHASED_LAST_DAYS` | `days` | Comprou nos últimos N dias |
| `NOT_PURCHASED_LAST_DAYS` | `days` | Já comprou, mas não nos últimos N dias |
| `NEVER_PURCHASED` | — | Tem cadastro ou pedido na loja, mas nenhum pedido aprovado |
| `PURCHASED_PRODUCT` | `product_id` | Comprou o produto (variações contam para o produto principal) |
| `PURCHASED_CATEGORY` | `category_id` | Comprou algo da categoria (subcategorias contam) |
| `USED_COUPON` | `coupon_code` | Usou o cupom em um pedido aprovado |
| `TOTAL_SPENT` | `operator` (`GT` ou `LT`), `value` | Total gasto maior ou menor que o valor |
| `ORDER_COUNT` | `operator` (`GT` ou `LT`), `value` | Número de pedidos aprovados maior ou menor que o valor |

```json theme={null}
{
  "match": "ALL",
  "rules": [
    {
      "type": "PURCHASED_LAST_DAYS",
      "days": 30
    },
    {
      "type": "TOTAL_SPENT",
      "operator": "GT",
      "value": 300
    }
  ]
}
```

O público é montado na hora do envio (em campanhas agendadas, no horário agendado). Cada email recebe uma única vez. Ficam sempre de fora: quem se descadastrou, clientes banidos e emails inválidos.

## Envio em fila

Enviar pela API é igual a enviar pelo painel: a campanha entra na mesma fila, sai aos poucos respeitando a cota de envio da plataforma e a lista de descadastro, e a falha de um destinatário não derruba os outros. Acompanhe o progresso em [Obter Campanha](https://docs.selltrust.com.br/api-reference/campaigns/get.md).

Todo email de campanha leva um link de descadastro. Se o HTML não usar `{{ unsubscribe_url }}`, um rodapé com o link é incluído automaticamente.

## Resultados

`attributed_orders` e `attributed_revenue` contam pedidos aprovados de quem chegou à loja clicando em um link do email (os links para a loja são marcados com UTM automaticamente).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.