# Cupons

> Dê a cada destinatário do e-mail um código de desconto próprio, de uso único, ou um código para todos, e veja quais códigos foram atribuídos e resgatados. Alfa: aberto apenas à equipe do Emailit.

Um cupom coloca um código de desconto nos seus e-mails com `{{coupon "key"}}`. Um cupom do tipo **unique codes** entrega a cada destinatário um código próprio, tirado de um pool, para que os códigos não possam ser compartilhados. Um cupom do tipo **one code for everyone** insere o mesmo código para todos. O Emailit distribui os códigos e a sua loja os valida no checkout, então crie os mesmos códigos na sua loja.

> **O e-commerce está em alfa:** O e-commerce está aberto apenas à equipe do Emailit enquanto o testamos. Consulte [Quem pode usar o e-commerce](/pt/docs/commerce/#who-can-use-commerce).

## Criar um cupom

1. **Abra Coupons.** Em **Email Marketing → Commerce**, abra a aba **Coupons** e selecione **Create coupon**.

2. **Preencha o cupom.**

   | Campo | Observações |
   | --- | --- |
   | **Name** | Para você, por exemplo `Welcome 10%`. |
   | **Key** | O que você escreve no conteúdo: `{{coupon "welcome10"}}`. Letras minúsculas, dígitos, `-` e `_`, até 64 caracteres. O conteúdo que usa uma chave antiga não renderiza nada, então não mude a chave depois que o cupom estiver em uso. |
   | **Type** | **Unique codes** ou **One code for everyone**. |
   | **Code** | Para um código para todos, o código. |
   | **Fallback code** | Para códigos únicos, opcional: enviado quando os códigos acabam ou o cupom expirou. Sem ele, a tag não renderiza nada nesses casos. |
   | **Discount** | Um rótulo como `10% off`, mostrado no painel. |
   | **Expires** | Opcional. Depois dessa data, os cupons de códigos únicos só enviam o código alternativo. |

3. **Adicione códigos** a um cupom de códigos únicos. Abra-o, selecione **Add codes** e escolha uma das opções:
   - **Upload codes**, para enviar os códigos da sua loja: um código por linha, ou um CSV com os códigos na primeira coluna, até 10.000 de cada vez. Os códigos que já estão no pool são ignorados.
   - **Generate codes**: o Emailit cria códigos aleatórios sem caracteres parecidos (sem 0, O, 1 ou I), com um prefixo opcional. Depois, selecione **Export CSV** e crie os mesmos códigos na sua loja.

4. **Use-o no conteúdo.** Coloque `{{coupon "welcome10"}}` em um e-mail de campanha ou de automação. Consulte [Produtos, cupons e o carrinho](/pt/docs/campaigns/products-and-coupons/#coupon-codes).

## Como os códigos são distribuídos

- Cada destinatário recebe um código por campanha ou automação. Se o mesmo e-mail for renderizado de novo para ele, por exemplo na versão web, ele recebe o mesmo código.
- Os códigos são atribuídos quando o e-mail é criado, então uma campanha grande usa tantos códigos quanto o número de destinatários dela. Mantenha o pool maior que o seu público.
- As pré-visualizações e os envios de teste mostram um código de exemplo como `WELCOME10-PREVIEW` e não consomem códigos.

## Acompanhar os resgates

Quando um [pedido](/pt/docs/api-reference/orders/create/) lista um código em `coupon_codes`, o Emailit marca o código como **Redeemed** com o pedido. Um código usado na sua loja antes de o Emailit distribuí-lo nunca é enviado. A página do cupom mostra quantos códigos estão **Available**, **Assigned** e **Redeemed** e lista os códigos com quem os recebeu e quando. **Export CSV** baixa a lista.

Os segmentos podem encontrar os contatos que usaram um cupom com a regra `used_coupon`. Consulte [Regras de atividade](/pt/docs/api-reference/segments/create/#activity-rules).

## Usar a API

| Endpoint | Use para |
| --- | --- |
| [Criar um cupom](/pt/docs/api-reference/coupons/create/) | Criar um cupom de códigos únicos ou de código fixo. |
| [Adicionar códigos a um cupom](/pt/docs/api-reference/coupons/add-codes/) | Enviar códigos, ou gerá-los com uma quantidade, um prefixo e um tamanho. |
| [Listar os códigos de um cupom](/pt/docs/api-reference/coupons/list-codes/) | Consultar o pool, filtrado por disponíveis, atribuídos ou resgatados. |
| [Listar](/pt/docs/api-reference/coupons/list/), [obter](/pt/docs/api-reference/coupons/get/), [atualizar](/pt/docs/api-reference/coupons/update/) e [excluir](/pt/docs/api-reference/coupons/delete/) | Gerenciar cupons. |

## Veja também

  - [Produtos, cupons e o carrinho](/pt/docs/campaigns/products-and-coupons/): Todas as tags de e-commerce para o conteúdo dos e-mails.
  - [E-commerce](/pt/docs/commerce/): Conecte a sua loja e veja a receita gerada pelos e-mails.

---
Fonte: https://emailit.com/pt/docs/commerce/coupons/