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

# Pré-teste de e-mail

> Crie um pré-teste de e-mail marketing.

Use `channel: "email"` para e-mails. O criativo é uma **imagem** do e-mail (uma captura da peça): vídeo não é aceito e responde [`upload_invalid`](https://docs.myunite.ai/errors#upload_invalid).

## Campos

| Campo | Obrigatório | Descrição |
| - | - | - |
| `uploadId` | Sim | Imagem do e-mail. |
| `channel` | Sim | `email`. |
| `email.subject` | Sim | Assunto, não vazio (até 500 caracteres). |
| `email.preheader` | Sim | Pré-cabeçalho, não vazio (até 500 caracteres). |
| `email.stage` | Não | `draft` (padrão) ou `final_review`. |
| `email.type` | Não | `promotional`, `newsletter`, `transactional`, `lifecycle` ou `welcome`. |
| `title`, `brandId`, `locale`, `metadata` | Não | Iguais ao [pré-teste OOH](https://docs.myunite.ai/pretests/ooh.md). |

## Exemplo

```bash curl theme={null}
curl -X POST https://myunite.ai/api/v1/pretests \
  -H "Authorization: Bearer $UNITE_API_KEY" \
  -H "Idempotency-Key: verao-relogio-urbano-email-001" \
  -H "Content-Type: application/json" \
  -d '{
    "uploadId": "upl_0123456789abcdef0123456789abcdef.png",
    "title": "Verão · relógio urbano",
    "channel": "email",
    "email": {
      "subject": "O relógio do verão chegou",
      "preheader": "Edição limitada, só esta semana",
      "stage": "draft",
      "type": "promotional"
    }
  }'
```

```javascript JavaScript theme={null}
const res = await fetch("https://myunite.ai/api/v1/pretests", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.UNITE_API_KEY}`,
    "Idempotency-Key": "verao-relogio-urbano-email-001",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    uploadId: "upl_0123456789abcdef0123456789abcdef.png",
    title: "Verão · relógio urbano",
    channel: "email",
    email: {
      subject: "O relógio do verão chegou",
      preheader: "Edição limitada, só esta semana",
      stage: "draft",
      type: "promotional",
    },
  }),
});
console.log(res.status, await res.json()); // 202
```

```python Python theme={null}
import os
import requests

res = requests.post(
    "https://myunite.ai/api/v1/pretests",
    headers={
        "Authorization": f"Bearer {os.environ['UNITE_API_KEY']}",
        "Idempotency-Key": "verao-relogio-urbano-email-001",
    },
    json={
        "uploadId": "upl_0123456789abcdef0123456789abcdef.png",
        "title": "Verão · relógio urbano",
        "channel": "email",
        "email": {
            "subject": "O relógio do verão chegou",
            "preheader": "Edição limitada, só esta semana",
            "stage": "draft",
            "type": "promotional",
        },
    },
)
print(res.status_code, res.json())  # 202
```

## PDF da análise

O PDF de um pré-teste de e-mail só é gerado quando você o pede (por `GET /pretests/{id}/report` ou por uma exportação no produto), e o evento [`pretest.report_ready`](https://docs.myunite.ai/webhooks) só chega depois disso. Não espere esse evento sem pedir o PDF antes. Até lá, `report.status` fica `pending`. Chame `GET /pretests/{id}/report` com o pré-teste em `completed`: a resposta é `202` com `Retry-After` enquanto o PDF é gerado e `200` com a `url` quando estiver pronto. O passo a passo está no [primeiro pré-teste](https://docs.myunite.ai/quickstart.md). O resultado completo também está no campo `result` (veja [Resultados](https://docs.myunite.ai/results.md)).


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