---
title: Domínios
description: Verifique um domínio de envio, adicione os registros DNS e configure rastreamento, recebimento e aquecimento.
ai:
  exclude: true
---

Todo e-mail precisa sair de um domínio que sua equipe verificou. Qualquer outro endereço em `from` é recusado com `422`. Adicione e verifique domínios no painel, em **Domínios**, ou pela API.

## Adicionar e verificar um domínio

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

A resposta lista os registros DNS a criar no seu provedor de DNS. Um subdomínio como `mail.example.com` é uma boa escolha para enviar. Quando os registros estiverem no ar, clique em **Verificar** na página do domínio ou chame `POST /domains/{id}/verify`.

| Registro | Para que serve |
| --- | --- |
| DKIM (dois CNAMEs, `bs1._domainkey` e `bs2._domainkey`) | Assina seus e-mails para que os provedores saibam que são seus. |
| MAIL FROM (MX e TXT) | Um endereço de bounce no seu próprio domínio, para o SPF alinhar. |
| DMARC (TXT, recomendado) | Diz aos provedores o que fazer com e-mails que falham nas verificações. Não bloqueia o envio. |

DKIM e MAIL FROM precisam estar verificados antes de você enviar. No Cloudflare, deixe esses registros como **somente DNS** (nuvem cinza).

A página do domínio mostra cada registro como encontrado, ausente ou divergente, conferido ao vivo no DNS público. `GET /domains/{id}` devolve o mesmo em `records[]`. Cada registro traz um `status` (`not_started`, `pending`, `verified` ou `failed`), um valor `live` com o que o DNS público responde agora e, quando algo está errado, um `detail` curto.

### As chaves DKIM giram sozinhas

O BillionSend cria uma chave DKIM para cada domínio e a troca a cada 180 dias, alternando entre os dois CNAMEs. Você adiciona os registros uma vez e nunca mais mexe neles. Dá para desligar a rotação automática na aba **Configurações** do domínio.

### Região

`POST /domains` aceita um `region` opcional. Um domínio vive em uma região. Para movê-lo, exclua e adicione de novo na outra região; os registros DNS mudam.

### Limites do plano

| | Free | Starter | Pro e Scale |
| --- | --- | --- | --- |
| Domínios de envio por equipe | 3 | 10 | Ilimitados |

Passando do limite, `POST /domains` responde `403 plan_limit_reached`. Um nome de domínio que outra equipe já tem responde `409`.

## Aquecimento de domínio novo

Um domínio recém-registrado envia um volume diário limitado enquanto constrói reputação. O limite depende da idade do domínio registrado (`example.com` para `mail.example.com`) e conta por dia UTC:

| Idade do domínio | E-mails por dia |
| --- | --- |
| Menos de 1 dia | 100 |
| 1 a 7 dias | 300 |
| 7 a 30 dias | 2.000 |
| 30 dias ou mais | Só o limite do seu plano |

- Um domínio que envia bem, com poucos bounces e nenhuma reclamação, sobe de faixa mais cedo.
- O limite vale além do seu plano. Fazer upgrade não o remove.
- Seus domínios novos dividem um único volume diário: adicionar outro domínio novo não aumenta o volume.
- O e-mail acima do limite não se perde. Ele aparece como **Aguardando** e sai no dia seguinte, do mais antigo ao mais novo. Se já há muito e-mail esperando, o envio responde `429 daily_quota_exceeded`; tente de novo depois da virada do dia UTC.

A página do domínio mostra "Aquecendo: N/dia hoje" enquanto um limite vale. Veja [Limites de envio](/docs/pt-br/concepts/sending-limits) para todas as proteções do envio.

## Configurações

Depois de verificado, o domínio tem estas configurações:

- **Rastreamento de abertura e de cliques.** Os dois vêm desligados. Ligue na aba **Links** do domínio, ou com `open_tracking` e `click_tracking` em `PATCH /domains/{id}`. Veja [Rastreamento](/docs/pt-br/concepts/tracking).
- **Subdomínios próprios de rastreamento e de descadastro.** Sirva links rastreados e links de descadastro do seu domínio. Exige um plano pago. Veja [Rastreamento](/docs/pt-br/concepts/tracking).
- **Página de descadastro.** O visual da página que seus destinatários veem: nome, logo, cores e textos. Defina na aba **Marca** do domínio, ou com `unsubscribe_page` em `PATCH /domains/{id}`. Veja [Marcas e descadastros](/docs/pt-br/concepts/unsubscribes).
- **TLS obrigatório.** Entrega só a servidores que aceitam TLS. Defina na aba **Configurações**.
- **Nome do remetente, endereço de remetente e reply-to padrão.** Defina na aba **Configurações**.

## Recebimento

Um domínio verificado também pode [receber e-mails](/docs/pt-br/receiving). Ative com **Ativar recebimento** na página do domínio, ou com `PATCH /domains/{id}`:

```json
{ "capabilities": { "receiving": "enabled" } }
```

- Só um domínio verificado pode ativar o recebimento. `POST /domains` com `"receiving": "enabled"` responde `422`: adicione o domínio, verifique e depois ative o recebimento.
- Ativar adiciona dois registros `Receiving`: registros MX que apontam para `mx1.billionsend-dns.com` e `mx2.billionsend-dns.com`, ambos com prioridade `10`. Publique os dois, para que um remetente que encontre um deles fora do ar tente de novo no outro. Eles não afetam o envio. Se o domínio já recebe e-mails em outro lugar, ponha os registros MX em um subdomínio como `inbound.example.com`, porque um MX de número menor receberia os e-mails no lugar.
- Um nome recebe em uma equipe só. Um nome que outra equipe já recebe responde `409`.
- Por padrão, só os endereços das suas [caixas de entrada](/docs/pt-br/inboxes) recebem. O **catch-all** aceita todos os endereços do domínio. Exige um plano pago e é definido no painel ou com `receiving_catch_all` em `PATCH /domains/{id}`.

## Subdomínio compartilhado

Toda equipe também ganha um subdomínio em um domínio compartilhado do BillionSend, onde suas [caixas de entrada](/docs/pt-br/inboxes) compartilhadas recebem os endereços. Ele aparece no fim de `GET /domains` com `shared: true`. Já vem verificado e é somente leitura: `PATCH`, verificar e `DELETE` respondem `403 forbidden`, e ele não conta no seu limite de domínios. Só envia dos endereços das suas caixas de entrada.

## Excluir um domínio

`DELETE /domains/{id}`, ou **Excluir** na página do domínio, é recusado com `409` em dois casos:

- Um [tópico](/docs/pt-br/concepts/topics) ou [segmento](/docs/pt-br/concepts/segments) está vinculado ao domínio. Exclua-o ou defina o `domain_id` dele como `null`.
- Uma [transmissão](/docs/pt-br/concepts/broadcasts) agendada ou em envio usa o domínio. Cancele-a ou espere ela sair.

Excluir um domínio também exclui suas caixas de entrada. Os [descadastros](/docs/pt-br/concepts/unsubscribes) dos destinatários desse domínio são mantidos e voltam a valer se você adicionar o mesmo nome de novo.

## Chaves de API e domínios

Uma chave de API pode ser limitada a um domínio. Essa chave só envia desse domínio, e qualquer outro `from` responde `403 restricted_api_key`. Ela lê só os e-mails recebidos nesse domínio, vê e altera só esse domínio em `/domains` (qualquer outro responde `404`), e as chaves que ela cria ficam limitadas ao mesmo domínio. Webhooks, supressões, templates e o resto do que pertence à equipe inteira respondem `403 restricted_api_key`; a página de [chaves de API](/docs/pt-br/api-keys) lista tudo. Uma chave também pode ser limitada a uma [caixa de entrada](/docs/pt-br/inboxes).
