Pular para o conteúdo
Esc
↑↓navegar↵abrir⌘Jpré-visualizar
Nesta página

Domínios

Verifique um domínio de envio, adicione os registros DNS e configure rastreamento, recebimento e aquecimento.

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

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 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.
  • 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.
  • 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.
  • 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. Ative com Ativar recebimento na página do domínio, ou com PATCH /domains/{id}:

{ "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 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 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 ou segmento está vinculado ao domínio. Exclua-o ou defina o domain_id dele como null.
  • Uma transmissão 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 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 lista tudo. Uma chave também pode ser limitada a uma caixa de entrada.

Esta página foi útil?