# Adicionar um domínio de envio

> Adicione o seu domínio ao Emailit, publique os registros DNS que ele gera, envie-os para um desenvolvedor se precisar e verifique o domínio para poder enviar.

Este guia mostra como adicionar um domínio de envio, publicar os registros DNS dele e verificá-lo. São alguns minutos de trabalho, mais o tempo que o seu provedor de DNS levar para publicar os registros.

## Antes de começar

- Você precisa ter acesso às configurações de DNS do domínio, ou conhecer alguém que tenha. Você pode [enviar os registros por e-mail para essa pessoa](#send-the-records-to-someone-else).
- Decida de qual domínio você vai enviar. Usar um subdomínio como `mail.acme.com` mantém a sua reputação de envio separada da do domínio raiz. Consulte [Domínio raiz ou subdomínio?](/pt/docs/domains/#root-domain-or-subdomain)
- Confira se o seu plano comporta mais um domínio. Consulte [Limites de domínios](/pt/docs/domains/limits/).
- Para a API, use uma chave de API **Full Access**. Chaves só de envio não podem gerenciar domínios.

## Regras para o nome do domínio

- Digite só o domínio: `acme.com` ou `mail.acme.com`. Não inclua `http://`, `https://` nem o prefixo `www.`.
- Use letras, dígitos, hifens e pontos, com um domínio de primeiro nível de pelo menos duas letras. O Emailit armazena o nome em minúsculas.
- São permitidos subdomínios em qualquer nível, por exemplo `eu.mail.acme.com`. Cada um é um domínio separado, com os seus próprios registros.
- Um nome só pode ser adicionado uma vez por workspace. Adicioná-lo de novo retorna `409 Domain with this name already exists`.

## Adicionar o domínio

**Painel**

  1. **Abra Domains.** Acesse **Email API → Domains** e selecione **Add domain**.

     Se o botão estiver desativado, o seu workspace atingiu o limite de domínios. O selo ao lado do título da página mostra quantos você já usou.

  2. **Digite o domínio.** Em **Name**, digite o domínio de onde você envia, por exemplo `mail.acme.com`, e selecione **Create**.

  3. **Revise os registros.** O Emailit abre a página do domínio na aba **DNS Setup**. Ela lista cada registro com tipo, nome, valor, prioridade e TTL, e um botão de copiar para cada valor.

**API**

  Chame [Criar um domínio](/pt/docs/api-reference/domains/create/) com o nome do domínio.

```bash
curl https://api.emailit.com/v2/domains \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.acme.com" }'
```

  A resposta `201` inclui o `id` do domínio e um array `dns_records` com todos os registros a publicar:

```json
{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}
```

  A resposta completa lista os seis registros, incluindo DKIM, DMARC, rastreamento e recebimento. Você também pode definir estes campos opcionais ao criar o domínio:

  | Campo | Padrão | Descrição |
  | --- | --- | --- |
  | `tracking_key` | `go` | Prefixo do subdomínio para o CNAME de rastreamento. Consulte [Configurar um domínio de rastreamento personalizado](/pt/docs/tracking/custom-tracking-domain/). |
  | `inbound_key` | `inbound` | Prefixo do subdomínio para o registro MX de recebimento. |
  | `dmarc_reports` | `false` | Adiciona o endereço de relatórios do Emailit ao registro DMARC sugerido. Somente Pro, Business e Custom; nos outros planos, `403 plan_required`. |

  `track_loads` e `track_clicks` não podem ser ativados ao criar um domínio, porque o rastreamento precisa antes de um CNAME de rastreamento verificado. Enviar `true` retorna `422`.

Não há uma opção separada para e-mails de saída ou de entrada. Um domínio verificado pode enviar e recebe e-mails assim que o registro MX de recebimento dele é publicado. A API aceita os indicadores `outgoing` e `incoming` por compatibilidade, mas eles não mudam o comportamento do domínio.

## Publicar os registros DNS

Adicione os registros na empresa que hospeda o DNS do seu domínio. Muitas vezes é o seu registrador (GoDaddy, Namecheap) ou um serviço de DNS (Cloudflare, Amazon Route 53).

| Registro | Tipo | Host | O que fazer |
| --- | --- | --- | --- |
| Return path | MX | `emailit.<domain>` | Obrigatório. Prioridade 10. |
| SPF | TXT | `emailit.<domain>` | Obrigatório. |
| DKIM | TXT | `emailit._domainkey.<domain>` | Obrigatório. Cole o valor inteiro. |
| DMARC | TXT | `_dmarc.<domain>` | Recomendado. Pule-o se o domínio já tiver um registro DMARC. |
| Rastreamento | CNAME | `go.<domain>` | Somente se você quiser rastreamento de aberturas e cliques. |
| Recebimento | MX | `inbound.<domain>` | Somente se você quiser receber e-mails. Prioridade 10. |

A maioria dos provedores de DNS quer no campo de host só a parte antes do seu domínio (`emailit`, e não `emailit.acme.com`). [Registros DNS](/pt/docs/domains/dns-records/) traz os valores exatos, dicas para cada provedor e erros comuns.

Se o seu domínio usa o DNS do Cloudflare, a página do domínio oferece **Set up with Cloudflare**, que cria os registros para você. Consulte [Configurar o DNS com o Cloudflare](/pt/docs/domains/cloudflare/).

## Enviar os registros para outra pessoa

Se outra pessoa gerencia o seu DNS, envie os registros para ela por e-mail pelo painel.

1. **Abra o domínio.** Em **Email API → Domains**, selecione o domínio.

2. **Selecione Send to email.** A opção fica no canto superior direito do card **DNS Setup**.

3. **Digite o endereço da pessoa.** Em **Recipient Email**, digite o endereço do seu desenvolvedor ou administrador de TI e selecione **Send Instructions**.

A pessoa recebe um e-mail do Emailit com todos os registros e os valores deles. Peça para ela avisar quando os registros estiverem publicados, para você executar a verificação.

## Verificar o DNS e o domínio

**Painel**

  Na página do domínio, selecione **Check DNS**. O Emailit consulta todos os registros e atualiza o status ao lado de cada um: **OK**, **Missing**, **Invalid** ou **Not checked**. Passe o cursor sobre **Missing** ou **Invalid** para ver o que o Emailit encontrou.

**API**

  Chame [Verificar um domínio](/pt/docs/api-reference/domains/verify/). Você pode usar o ID ou o nome do domínio.

```bash
curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  A resposta contém o domínio atualizado. Confira `verification_status` e o `status` e o `error` de cada item de `dns_records`.

> **A verificação só é executada quando você pede:** O Emailit não verifica um domínio novo por conta própria. Depois de publicar ou corrigir registros, execute o **Check DNS** de novo. As mudanças de DNS costumam aparecer em minutos, mas alguns provedores levam até 48 horas.

O domínio é verificado quando SPF, DKIM e return path mostram **OK**. DMARC, rastreamento e recebimento são opcionais e não afetam a verificação.

## Confirmar que funcionou

- O domínio aparece como **Verified** em **Email API → Domains**, e as colunas **SPF**, **DKIM** e **Return Path** mostram **OK**.
- Envie uma mensagem de teste de um endereço do domínio. Na página **Emails**, selecione **Compose**, ou chame [Enviar um e-mail](/pt/docs/api-reference/emails/send/).

Se o domínio aparecer como **Pending verification**, ele está aguardando uma análise manual. Isso vale para domínios no Pay as you go registrados há menos de 30 dias. Consulte [Verificação de domínio](/pt/docs/domains/verification/#pending-verification).

> **Observação:** Um domínio verificado não tira o workspace do modo sandbox. Enquanto o seu workspace não tiver acesso de produção, você só pode enviar para os e-mails das contas dos membros do workspace. Consulte [Acesso de produção](/pt/docs/workspaces/production-access/).

## Solução de problemas

| Problema | Solução |
| --- | --- |
| **Add domain** está desativado | Você atingiu o limite de domínios do seu plano. Exclua um domínio que não usa ou aumente o limite. Consulte [Limites de domínios](/pt/docs/domains/limits/). |
| `The domain must be in apex format` | Remova `http://`, `https://` ou `www.` e confira se o nome termina com um domínio de primeiro nível real. |
| Os registros mostram **Missing** depois de uma hora | Provavelmente o host está duplicado, por exemplo `emailit.acme.com.acme.com`. Digite só `emailit` no campo de host. |
| O DKIM mostra **Invalid** | Parte do valor ficou de fora. Copie-o de novo com o botão de copiar. |

[Verificação de domínio](/pt/docs/domains/verification/#troubleshooting) trata de mais casos.

## Veja também

  - [Registros DNS](/pt/docs/domains/dns-records/): Referência de todos os registros que o Emailit gera.
  - [Verificação de domínio](/pt/docs/domains/verification/): Status, análise manual e nova verificação diária.
  - [Domínio de rastreamento personalizado](/pt/docs/tracking/custom-tracking-domain/): Configure o rastreamento de aberturas e cliques.
  - [Configurar o recebimento de e-mails](/pt/docs/inbound/set-up/): Receba e-mails no seu domínio.

---
Fonte: https://emailit.com/pt/docs/domains/add-a-domain/