IP dedicati e pool

Sull'infrastruttura condivisa, le tue email partono da indirizzi IP che condividi con altri clienti. Manteniamo quegli IP in buono stato, ma la tua reputazione resta accomunata a quella di tutti gli altri. Un IP dedicato è un indirizzo da cui invia solo la tua organizzazione, così i provider di posta valutano il tuo traffico esclusivamente in base al tuo storico. Gli IP pool raggruppano gli IP dedicati in unità instradabili, e il campo ip_pool_id su un invio seleziona il pool per quel messaggio.

Non hai mai bisogno di IP dedicati per inviare. Ogni organizzazione parte con lo Shared Bird.com Pool come predefinito, quindi le email partono dal primo giorno senza nulla da configurare. Gli IP dedicati sono un componente aggiuntivo a pagamento che conviene solo con un volume costante. Un IP dedicato poco utilizzato costruisce reputazione più lentamente di quella che il pool condiviso ha già, quindi i mittenti a basso volume di solito stanno meglio restando sul condiviso. Un IP dedicato migliora la deliverability delle email? spiega come il volume di invio e la reputazione influenzano questa scelta.

Due cose da sapere prima di acquistare:

• I nuovi IP passano attraverso un warmup automatico prima di poter gestire il volume pieno; nel frattempo il traffico in eccesso transita dal pool condiviso.
• IP e pool appartengono alla tua organizzazione.

Dove gestirli

Gestisci pool e IP in Email > IP pools nella dashboard, oppure con i comandi CLI bird email ip-pools e bird email dedicated-ips. Queste operazioni richiedono permessi a livello di organizzazione. Gli SDK non includono metodi tipizzati per la gestione. Per instradare un messaggio attraverso un pool, imposta ip_pool_id come descritto in Selezionare un pool al momento dell'invio.

Se la tua organizzazione gestisce l'accesso ai pool per spazio di lavoro, la sua pagina Email > IP pools mostra l'inventario dell'organizzazione e le assegnazioni agli spazi di lavoro. La pagina di uno spazio di lavoro mostra i pool che quello spazio di lavoro può usare. Per modificare queste assegnazioni servono permessi di organizzazione; l'accesso a uno spazio di lavoro non dà accesso ai pool degli altri spazi di lavoro.

Acquistare un IP dedicato

Acquista un IP dalla scheda Dedicated IPs o con CLI:

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

• Al primo acquisto puoi omettere --ip-pool-id: creiamo il tuo primo pool, denominato "Dedicated IPs", e vi assegniamo gli IP. Una volta che la tua organizzazione ha almeno un pool, il flag è obbligatorio; scegli tu dove collocare ogni nuovo IP.
• Ogni IP è fatturato come abbonamento mensile. Quando il saldo del tuo wallet non copre l'acquisto, la risposta riporta requires_topup (ricarica per procedere) o pending_topup (un addebito su carta è in fase di regolamento); gli IP vengono assegnati automaticamente non appena i fondi arrivano.
• Gli acquisti sono limitati dalla quota email_ip_dedicated_max del tuo piano, e i pool dalla quota email_ip_pools_max.

Ogni IP assegnato parte con stato warming e scala automaticamente; IP warmup descrive la pianificazione e come monitorarla. Il campo hostname dell'IP è il suo nome reverse-DNS (PTR), il nome con cui si presenta ai mail server di destinazione; aggiungilo a qualsiasi allowlist che filtra per hostname di invio.

Acquistare un IP non cambia il tuo pool predefinito. Il pool condiviso resta il predefinito finché non lo cambi esplicitamente, perché instradare tutto il traffico non specificato su un IP freddo, ancora in warmup, danneggerebbe la tua deliverability.

Un IP riporta uno di quattro stati:

IP pool

I pool separano i flussi di invio: una configurazione comune prevede un pool per la posta transazionale e un altro per il marketing, in modo che la reputazione di una campagna non influenzi i tuoi messaggi di reset password. I pool sono gratuiti da creare, fino alla quota email_ip_pools_max del tuo piano.

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"
}

I pool vengono sempre creati come non predefiniti e vuoti. Li riempi acquistando direttamente al loro interno (--ip-pool-id sull'acquisto) o spostando IP esistenti. Leggere un pool restituisce i suoi IP membri per intero:

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"
}

I pool appartengono all'organizzazione. Il campo hostname di ogni IP viene assegnato automaticamente quando l'IP è assegnato; consideralo informativo, non qualcosa da configurare.

L'inventario dell'organizzazione include lo Shared Bird.com Pool, contrassegnato protected: true. Ha un pool ID, e l'alias riservato ipp_shared viene risolto verso quel pool. Lo gestisce Bird: non può essere rinominato né eliminato, non può contenere IP dedicati e non conta nella quota dei pool. Uno spazio di lavoro con pool assegnati lo vede quando il pool condiviso è assegnato a quello spazio di lavoro. Usare l'alias richiede lo stesso permesso necessario per usarne l'ID.

Quando le assegnazioni agli spazi di lavoro sono disponibili, la dashboard concede allo spazio di lavoro corrente l’accesso ai pool appena creati. Per il primo acquisto di un IP dedicato dalla dashboard, crea il relativo pool prima di confermare il pagamento. Gli acquisti tramite API o CLI senza un ID pool creano un pool dell’organizzazione che deve ancora essere assegnato a uno spazio di lavoro.

Quando le assegnazioni agli spazi di lavoro sono disponibili, concedi un pool senza cambiare il predefinito dello spazio di lavoro:

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

Per uno spazio di lavoro senza assegnazioni, questa operazione mantiene anche l'invio condiviso, assegnando il pool condiviso come predefinito. Se ometti --is-default o lo imposti su true, il primo pool assegnato diventa invece il predefinito e l'invio è limitato ai pool assegnati. Un pool dedicato in warmup richiede che sia assegnato anche il pool condiviso, perché il traffico in eccesso del warmup usa IP condivisi. Gli spazi di lavoro senza assegnazioni di pool usano il pool condiviso.

Per rimuovere un'assegnazione, sostituisci prima ogni selezione predefinita e ogni utilizzo salvato nei valori predefiniti dei domini, nelle caselle di posta, nelle impostazioni SMTP o nei broadcast in bozza, pianificati o non completati. Lo storico dei broadcast completati conserva l'identità del pool originale e non blocca la rimozione.

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

Spostare un IP tra pool

Un IP dedicato si trova sempre in esattamente un pool, senza stato non assegnato. Lo spostamento è una singola assegnazione:

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

Il pool condiviso non è una destinazione valida: gli IP dedicati risiedono solo nei tuoi pool.

Eliminare un pool

Solo i pool vuoti possono essere eliminati. L'eliminazione di un pool che contiene ancora IP viene rifiutata con un errore 409; sposta o cancella prima i suoi IP. Prima di eliminarlo, sostituisci le sue selezioni predefinite e rimuovi le sue assegnazioni agli spazi di lavoro e i suoi utilizzi salvati.

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv --yes

Il pool predefinito

Quando né un invio né il suo dominio di invio selezionano un pool, utilizziamo il tuo pool predefinito. Per le organizzazioni che gestiscono i pool per spazio di lavoro, questo è il pool predefinito dello spazio di lavoro. Le regole seguenti si applicano a questo valore predefinito:

• Esattamente un pool è sempre il predefinito. Il pool condiviso è il predefinito iniziale, quindi questo è vero dal primo giorno.
• Il predefinito viene spostato, mai rimosso. Cambialo rendendo un altro pool il predefinito. Questo disattiva il predefinito precedente nello stesso istante, così in ogni momento ce n'è esattamente uno. Disattivare is_default sul predefinito corrente viene rifiutato con un errore 422; per tornare all'instradamento condiviso, rendi invece il pool condiviso il predefinito:

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

Per le organizzazioni che gestiscono i pool per spazio di lavoro, seleziona invece il predefinito dello spazio di lavoro:

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

Usa le assegnazioni agli spazi di lavoro quando l'operazione update --is-default a livello di organizzazione restituisce IPPoolOrganizationDefaultRetired. Durante la transizione le modifiche alle assegnazioni possono essere temporaneamente non disponibili. Cambiare il predefinito di uno spazio di lavoro non modifica i predefiniti degli altri spazi di lavoro.

• Un pool dedicato ha bisogno di almeno un IP che non sia in fase di dismissione per diventare il predefinito. Un IP warming conta; un IP in pending_cancellation no. Il tuo predefinito non può mai essere supportato esclusivamente da IP in via di dismissione. Il pool condiviso è esente ed è sempre un predefinito valido.
• L'ultimo IP rimasto non può lasciare il pool predefinito. Finché un pool detiene la designazione di predefinito, il suo ultimo IP non può essere né cancellato né spostato; cambia prima il predefinito, poi svuota il pool.

Questi controlli proteggono le modifiche pianificate. Se un pool dedicato perde i suoi IP di invio o i permessi necessari, gli invii attraverso quel pool non riescono finché non lo ripristini o non scegli un altro predefinito consentito.

Selezionare un pool al momento dell'invio

L'instradamento è la parte di questa funzionalità che si trova nella API pubblica. Scegli un pool per ogni messaggio con il campo opzionale ip_pool_id su 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"
  }'

La risoluzione funziona così:

• ip_pool_id omesso: l'invio utilizza il pool predefinito del dominio di invio nello spazio di lavoro corrente, se impostato; altrimenti, utilizza l'instradamento predefinito.
• ip_pool_id: "ipp_shared": l'invio usa il pool condiviso quando il tuo spazio di lavoro può usarlo. Questo seleziona l'infrastruttura condivisa anche quando il tuo predefinito è un pool dedicato.
• ip_pool_id impostato su un pool ID: l'invio usa quel pool quando è disponibile per il tuo spazio di lavoro.

Un valore sconosciuto, non disponibile per lo spazio di lavoro o che indica un pool senza IP disponibili viene rifiutato con un errore 422. Un pool dedicato con IP in warmup ha bisogno anche del permesso di usare il pool condiviso per il traffico in eccesso durante il warmup. Se rimuovi il permesso sul pool condiviso, quell'instradamento in warmup non è più disponibile. Per i messaggi accettati, la scelta esplicita di un pool viene conservata e verificata di nuovo prima dell'invio; una rimozione successiva dei permessi può bloccare la consegna. Bird non sostituisce con un altro pool una scelta esplicita non disponibile.

Cancellare un IP dedicato

La cancellazione è in due fasi. Cancellare pianifica la rimozione anziché rimuovere l'IP immediatamente:

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

L'IP passa allo stato pending_cancellation e riceve un timestamp cancels_at, la fine del periodo di fatturazione già pagato. Fino a cancels_at continua a inviare come parte del suo pool; dopo, lo rimuoviamo entro un'ora. Cancellare un IP già in attesa non ha ulteriori effetti.

Pianifica tenendo conto dell'unica conseguenza immediata: un IP pending_cancellation smette subito di contare nelle regole del pool predefinito. E la protezione del pool predefinito resta attiva: l'ultimo IP nel pool predefinito non può essere cancellato; sposta prima il predefinito (sul pool condiviso o su un altro pool).

Passi successivi

• IP warmup: come i nuovi IP dedicati scalano fino al volume pieno e quando cambiare il predefinito
• Invio di email: la richiesta di invio completa, incluso ip_pool_id
• Deliverability · Email: il modello di reputazione in cui si inseriscono gli IP dedicati
• Acquistare un IP dedicato: un video che ne acquista uno nella dashboard e mostra l'inizio del warmup