IPs dedicados e pools

Na infraestrutura compartilhada, seu e-mail sai de endereços IP que você divide com outros clientes. Nós mantemos esses IPs saudáveis, mas sua reputação ainda é compartilhada com a de todos os outros. Um IP dedicado é um endereço do qual apenas a sua organização envia, então os provedores de caixa de entrada avaliam seu tráfego exclusivamente pelo seu próprio histórico. IP pools agrupam IPs dedicados em unidades roteáveis, e o campo ip_pool_id em um envio escolhe o pool para aquela mensagem.

Você nunca precisa de IPs dedicados para enviar. Toda organização começa com o Shared Bird.com Pool como padrão, então o e-mail flui desde o primeiro dia sem nada a configurar. IPs dedicados são um complemento pago que só compensa com volume consistente. Um IP dedicado pouco utilizado constrói reputação mais devagar do que o pool compartilhado já tem, então remetentes de baixo volume geralmente se saem melhor permanecendo no compartilhado. Um IP dedicado melhora a entregabilidade de e-mail? explica como o volume de envio e a reputação afetam essa escolha.

Duas coisas para saber antes de comprar:

• Novos IPs passam por um aquecimento automático antes de suportar volume total; o excedente é roteado pelo pool compartilhado nesse meio-tempo.
• IPs e pools pertencem à sua organização.

Onde você os gerencia

Gerencie pools e IPs em Email > IP pools no dashboard, ou com os comandos CLI bird email ip-pools e bird email dedicated-ips. Essas operações exigem permissões no nível da organização. Os SDKs não incluem métodos tipados de gerenciamento. Para rotear uma mensagem por um pool, defina ip_pool_id conforme descrito em Selecionar um pool no momento do envio.

Se a sua organização gerencia o acesso aos pools por espaço de trabalho, a página Email > IP pools da organização mostra o inventário da organização e as atribuições dos espaços de trabalho. A página de um espaço de trabalho mostra os pools que esse espaço de trabalho pode usar. É preciso ter permissões da organização para alterar essas atribuições; ter acesso a um espaço de trabalho não concede acesso aos pools dos outros espaços de trabalho.

Comprar um IP dedicado

Compre um IP na aba Dedicated IPs ou com o CLI:

bird email dedicated-ips create --quantity 1 --ip-pool-id ipp_1btmn1nnkd8y6a4jckbkvvt9eh

• Na sua primeira compra você pode omitir --ip-pool-id: nós criamos seu primeiro pool, chamado "Dedicated IPs", e provisionamos os IPs nele. Quando sua organização já tem pelo menos um pool, o campo é obrigatório; você escolhe onde cada novo IP é alocado.
• Cada IP é cobrado como assinatura mensal. Quando o saldo da sua carteira não cobre a compra, a resposta reporta requires_topup (adicione saldo para prosseguir) ou pending_topup (uma cobrança no cartão está sendo processada); os IPs são provisionados automaticamente assim que os fundos chegam.
• Compras são limitadas pela cota de email_ip_dedicated_max do seu plano, e pools pela cota de email_ip_pools_max.

Cada IP provisionado começa com o status warming e aumenta automaticamente; Aquecimento de IP cobre o cronograma e como monitorá-lo. O hostname do IP é seu nome de DNS reverso (PTR), o nome com o qual ele se apresenta aos servidores de e-mail receptores; adicione-o a qualquer lista de permissões que filtre por hostname de envio.

Comprar um IP não altera seu pool padrão. O pool compartilhado permanece como padrão até você trocá-lo explicitamente, porque rotear todo o seu tráfego não especificado para um IP frio, ainda em aquecimento, prejudicaria sua entregabilidade.

Um IP reporta um de quatro status:

IP pools

Pools separam fluxos de envio: uma configuração comum é um pool para e-mail transacional e outro para marketing, para que a reputação de uma campanha nunca afete suas redefinições de senha. Pools são gratuitos para criar, até a cota de email_ip_pools_max do seu plano.

bird email ip-pools create Transactional

{
  "created_at": "2026-07-23T14:48:28Z",
  "id": "ipp_01ky7q6288fqnsghxyem91ryjv",
  "ips": [],
  "is_default": false,
  "name": "Transactional",
  "organization_id": "org_01ky7m21hjffg9pxj5xz6nx6ew",
  "protected": false,
  "updated_at": "2026-07-23T14:48:28Z"
}

Pools são sempre criados como não padrão e vazios. Você os preenche comprando diretamente neles (--ip-pool-id na compra) ou movendo IPs existentes para dentro. Ao consultar um pool, a resposta retorna seus IPs membros por completo:

bird email ip-pools get ipp_1btmn1nnkd8y6a4jckbkvvt9eh

{
  "created_at": "2026-06-29T13:56:39Z",
  "id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
  "ips": [
    {
      "address": "198.51.100.21",
      "created_at": "2026-06-29T13:56:39Z",
      "hostname": "mta1.send.goldcrest.dev",
      "id": "dip_5g8r8h31kr8cz8zp1p4s837r4m",
      "ip_pool_id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
      "organization_id": "org_01ky7m235keybaf72b0fdgfwj4",
      "purchased_at": "2026-06-29T13:56:39Z",
      "status": "active",
      "updated_at": "2026-07-23T13:56:39Z",
      "warmup_completed_at": "2026-07-15T13:56:39Z",
      "warmup_progress": 100,
      "warmup_started_at": "2026-06-29T13:56:39Z"
    }
  ],
  "is_default": false,
  "name": "Goldcrest Pool",
  "organization_id": "org_01ky7m235keybaf72b0fdgfwj4",
  "protected": false,
  "updated_at": "2026-07-23T13:56:39Z"
}

Pools pertencem à organização. O hostname de cada IP é atribuído automaticamente quando o IP é provisionado; trate-o como informativo, não como algo que você configura.

O inventário da organização inclui o Shared Bird.com Pool, marcado como protected: true. Ele tem um pool ID, e o alias reservado ipp_shared resolve para esse pool. Bird o gerencia: ele não pode ser renomeado nem excluído, não pode conter IPs dedicados e não conta na sua cota de pools. Um espaço de trabalho com pools atribuídos o vê quando o pool compartilhado está atribuído a esse espaço de trabalho. Usar o alias exige a mesma permissão que usar o ID.

Quando as atribuições a espaços de trabalho estão disponíveis, o painel concede ao espaço de trabalho atual acesso aos pools recém-criados. Na primeira compra de um IP dedicado pelo painel, crie o pool antes de confirmar o pagamento. Compras pela API ou CLI sem um ID de pool criam um pool da organização que ainda precisa ser atribuído a um espaço de trabalho.

Quando as atribuições por espaço de trabalho estão disponíveis, conceda um pool sem alterar o padrão do espaço de trabalho:

bird email ip-pools workspaces assign ipp_1btmn1nnkd8y6a4jckbkvvt9eh ws_01krdgeqcxet5s7t44vh8rt9mg --is-default=false

Para um espaço de trabalho sem atribuições, isso também preserva o envio compartilhado, atribuindo o pool compartilhado como padrão. Se você omitir --is-default ou defini-lo como true, o primeiro pool atribuído se torna o padrão e o envio fica limitado ao conjunto atribuído. Um pool dedicado em aquecimento também precisa do pool compartilhado atribuído, porque o excedente do aquecimento usa IPs compartilhados. Espaços de trabalho sem atribuições de pool usam o pool compartilhado.

Para remover uma atribuição, primeiro substitua qualquer seleção de padrão e os usos salvos nos padrões dos domínios, nas caixas de correio, nas configurações de SMTP ou nos broadcasts em rascunho, agendados ou não concluídos. O histórico de broadcasts concluídos mantém a identidade original do pool e não impede a remoção.

bird email ip-pools workspaces remove ipp_1btmn1nnkd8y6a4jckbkvvt9eh ws_01krdgeqcxet5s7t44vh8rt9mg --yes

Mover um IP entre pools

Um IP dedicado está sempre em exatamente um pool, sem estado de não atribuído. Mover é uma única atribuição:

bird email dedicated-ips assign dip_5g8r8h31kr8cz8zp1p4s837r4m --ip-pool-id ipp_01ky7q6288fqnsghxyem91ryjv

O pool compartilhado não é um destino válido: IPs dedicados só ficam nos seus próprios pools.

Excluir um pool

Apenas pools vazios podem ser excluídos. Excluir um pool que ainda contém IPs é rejeitado com um 409; mova ou cancele seus IPs primeiro. Antes de excluir o pool, substitua as seleções de padrão que o usam e remova suas atribuições a espaços de trabalho e seus usos salvos.

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv --yes

O pool padrão

Quando nem um envio nem seu domínio de envio selecionam um pool, usamos seu pool padrão. Para organizações que gerenciam pools por espaço de trabalho, este é o padrão do espaço de trabalho. As regras abaixo se aplicam a esse padrão:

• Exatamente um pool é sempre o padrão. O pool compartilhado é o padrão inicial, então isso é verdade desde o primeiro dia.
• O padrão é movido, nunca removido. Altere-o tornando outro pool o padrão. Isso desativa o padrão anterior no mesmo instante, então todo momento tem exatamente um padrão. Desativar is_default no padrão atual é rejeitado com um 422; para voltar ao roteamento compartilhado, torne o pool compartilhado o padrão:

bird email ip-pools update ipp_shared --is-default

Para organizações que gerenciam pools por espaço de trabalho, selecione o padrão do espaço de trabalho:

bird email ip-pools workspaces assign ipp_shared ws_01krdgeqcxet5s7t44vh8rt9mg --is-default

Use as atribuições por espaço de trabalho quando a operação update --is-default no nível da organização retornar IPPoolOrganizationDefaultRetired. As alterações de atribuição podem ficar temporariamente indisponíveis durante a transição. Alterar o padrão de um espaço de trabalho não altera o padrão dos outros espaços de trabalho.

• Um pool dedicado precisa de pelo menos um IP que não esteja em encerramento para se tornar o padrão. Um IP warming conta; um IP em pending_cancellation não conta. Seu padrão nunca pode ser sustentado exclusivamente por IPs a caminho da desativação. O pool compartilhado é isento e é sempre um padrão válido.
• O último IP restante não pode sair do pool padrão. Enquanto um pool detém a designação de padrão, seu último IP não pode ser cancelado nem movido; troque o padrão primeiro, depois esvazie o pool.

Essas verificações protegem alterações planejadas. Se um pool dedicado perder seus IPs de envio ou as permissões de que precisa, os envios por esse pool falham até que você o restaure ou escolha outro padrão permitido.

Selecionar um pool no momento do envio

O roteamento é a parte desse recurso que vive na API pública. Escolha um pool por mensagem com o campo opcional ip_pool_id em POST /v1/email/messages:

await bird.email.send({
  from: "noreply@yourdomain.com",
  to: ["delivered@messagebird.dev"],
  subject: "Your receipt",
  html: "<p>Thanks for your order.</p>",
  ip_pool_id: "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
});

client.email.send(
    from_="noreply@yourdomain.com",
    to=["delivered@messagebird.dev"],
    subject="Your receipt",
    html="<p>Thanks for your order.</p>",
    ip_pool_id="ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
)

_, err := client.Email.Send(context.Background(), bird.EmailSendParams{
	From:     "noreply@yourdomain.com",
	To:       []string{"delivered@messagebird.dev"},
	Subject:  "Your receipt",
	HTML:     "<p>Thanks for your order.</p>",
	IpPoolId: "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
})

$bird->email->send(
    from: 'noreply@yourdomain.com',
    to: ['delivered@messagebird.dev'],
    subject: 'Your receipt',
    html: '<p>Thanks for your order.</p>',
    ipPoolId: 'ipp_1btmn1nnkd8y6a4jckbkvvt9eh',
);

bird email send \
  --from noreply@yourdomain.com \
  --html '<p>Thanks for your order.</p>' \
  --ip-pool-id ipp_1btmn1nnkd8y6a4jckbkvvt9eh \
  --subject 'Your receipt' \
  --to delivered@messagebird.dev

curl -X POST https://us1.platform.bird.com/v1/email/messages \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@yourdomain.com",
    "to": ["delivered@messagebird.dev"],
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "ip_pool_id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh"
  }'

A resolução funciona assim:

• ip_pool_id omitido: o envio usa o pool padrão do domínio de envio no espaço de trabalho atual, se estiver definido; caso contrário, usa seu roteamento padrão.
• ip_pool_id: "ipp_shared": o envio usa o pool compartilhado quando seu espaço de trabalho pode usá-lo. Isso seleciona a infraestrutura compartilhada mesmo quando um pool dedicado é seu padrão.
• ip_pool_id definido como um pool ID: o envio usa esse pool quando ele está disponível para seu espaço de trabalho.

Um valor desconhecido, indisponível para o espaço de trabalho ou que nomeia um pool sem IPs disponíveis é rejeitado com um 422. Um pool dedicado com IPs em aquecimento também precisa de permissão para usar o pool compartilhado para o excedente do aquecimento. Remover a permissão do pool compartilhado torna essa rota de aquecimento indisponível. Uma escolha explícita de pool é mantida para mensagens aceitas e verificada novamente antes do envio; uma remoção posterior de permissão pode interromper a entrega. Bird não substitui uma escolha explícita indisponível por outro pool.

Cancelar um IP dedicado

O cancelamento tem duas fases. Cancelar agenda a remoção em vez de remover o IP imediatamente:

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

O IP transiciona para pending_cancellation e recebe um timestamp cancels_at, o fim do período de cobrança que você já pagou. Até cancels_at ele continua enviando como parte do seu pool; depois disso, nós o desprovisionamos dentro de uma hora. Cancelar um IP que já está pendente não tem efeito adicional.

Planeje considerando a única consequência imediata: um IP pending_cancellation para de contar nas regras do pool padrão imediatamente. E a proteção do pool padrão ainda se aplica: o último IP no pool padrão não pode ser cancelado; mova o padrão (para o pool compartilhado ou outro pool) primeiro.

Próximos passos

• Aquecimento de IP: como novos IPs dedicados aumentam até o volume total e quando trocar seu padrão
• Envio de e-mail: a solicitação completa de envio, incluindo ip_pool_id
• Entregabilidade · Email: o modelo de reputação no qual os IPs dedicados se encaixam
• Comprar um IP dedicado: um vídeo que compra um no dashboard e mostra o início do aquecimento