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_trackingeclick_trackingemPATCH /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_pageemPATCH /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 /domainscom"receiving": "enabled"responde422: adicione o domínio, verifique e depois ative o recebimento. - Ativar adiciona dois registros
Receiving: registros MX que apontam paramx1.billionsend-dns.comemx2.billionsend-dns.com, ambos com prioridade10. 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 comoinbound.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_allemPATCH /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_iddele comonull. - 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.