Dedykowane adresy IP i pule

W infrastrukturze współdzielonej Twoje wiadomości e-mail wychodzą z adresów IP wspólnych z innymi klientami. Dbamy o kondycję tych adresów, ale Twoja reputacja jest wciąż łączona z reputacją pozostałych nadawców. Dedykowany adres IP to adres, z którego wysyła wyłącznie Twoja organizacja, więc dostawcy skrzynek pocztowych oceniają Twój ruch wyłącznie na podstawie Twojej historii. Pule IP grupują dedykowane adresy IP w jednostki routingu, a pole ip_pool_id w wysyłce wskazuje pulę dla danej wiadomości.

Nie potrzebujesz dedykowanych adresów IP, żeby wysyłać. Każda organizacja zaczyna z pulą Shared Bird.com Pool jako domyślną, więc e-mail działa od pierwszego dnia bez konfiguracji. Dedykowane adresy IP to płatny dodatek, który opłaca się tylko przy stałym wolumenie. Rzadko używany dedykowany adres IP buduje reputację wolniej niż pula współdzielona, która już ją ma, więc nadawcy z małym wolumenem zwykle lepiej wychodzą na puli współdzielonej. Czy dedykowany adres IP poprawia dostarczalność e-maili? wyjaśnia, jak wolumen wysyłek i reputacja wpływają na ten wybór.

Dwie rzeczy, które warto wiedzieć przed zakupem:

• Nowe adresy IP przechodzą automatyczny warmup, zanim będą mogły obsłużyć pełny wolumen; nadmiar ruchu w tym czasie trafia przez pulę współdzieloną.
• Adresy IP i pule należą do Twojej organizacji.

Gdzie nimi zarządzasz

Zarządzaj pulami i adresami IP w Email > IP pools w dashboardzie albo za pomocą komend CLI bird email ip-pools i bird email dedicated-ips. Te operacje wymagają uprawnień na poziomie organizacji. SDK nie zawierają typowanych metod zarządzania. Aby skierować wiadomość przez pulę, ustaw ip_pool_id zgodnie z opisem w Wybierz pulę w momencie wysyłki.

Jeśli Twoja organizacja zarządza dostępem do pul osobno dla każdego obszaru roboczego, jej strona Email > IP pools pokazuje zasoby organizacji i przypisania do obszarów roboczych. Strona obszaru roboczego pokazuje pule, z których ten obszar roboczy może korzystać. Zmiana tych przypisań wymaga uprawnień organizacji; dostęp do jednego obszaru roboczego nie daje dostępu do pul pozostałych obszarów roboczych.

Kup dedykowany adres IP

Kup adres IP z zakładki Dedicated IPs lub za pomocą CLI:

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

• Przy pierwszym zakupie możesz pominąć --ip-pool-id: tworzymy Twoją pierwszą pulę o nazwie "Dedicated IPs" i przypisujemy do niej adresy IP. Gdy Twoja organizacja ma już co najmniej jedną pulę, flaga jest wymagana; sam wybierasz, gdzie trafia każdy nowy adres IP.
• Każdy adres IP jest rozliczany jako miesięczna subskrypcja. Gdy saldo portfela nie pokrywa zakupu, odpowiedź zwraca requires_topup (doładuj konto, aby kontynuować) lub pending_topup (trwa rozliczanie płatności kartą); adresy IP zostaną udostępnione automatycznie po zaksięgowaniu środków.
• Zakupy są ograniczone limitem email_ip_dedicated_max Twojego planu, a pule limitem email_ip_pools_max.

Każdy udostępniony adres IP zaczyna ze statusem warming i rozgrzewa się automatycznie; IP warmup opisuje harmonogram i sposób monitorowania. Wartość hostname adresu IP to jego nazwa reverse-DNS (PTR), czyli nazwa, którą przedstawia się serwerom odbierającym pocztę; dodaj ją do każdej listy dozwolonych, która filtruje po nazwie hosta nadawcy.

Zakup adresu IP nie zmienia Twojej domyślnej puli. Pula współdzielona pozostaje domyślna, dopóki jej jawnie nie przełączysz, ponieważ skierowanie całego nieokreślonego ruchu na zimny, wciąż rozgrzewający się adres IP zaszkodziłoby Twojej dostarczalności.

Adres IP zgłasza jeden z czterech statusów:

Pule IP

Pule rozdzielają strumienie wysyłek: typowa konfiguracja to jedna pula dla maili transakcyjnych i druga dla marketingowych, dzięki czemu reputacja kampanii nie wpływa na resetowanie haseł. Tworzenie pul jest bezpłatne, do limitu email_ip_pools_max Twojego planu.

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

Pule są zawsze tworzone jako niedomyślne i puste. Wypełniasz je, kupując adresy IP bezpośrednio do nich (--ip-pool-id przy zakupie) lub przenosząc istniejące adresy IP. Odczyt puli zwraca pełną listę przypisanych adresów IP:

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

Pule należą do organizacji. Wartość hostname każdego adresu IP jest przypisywana automatycznie przy udostępnianiu; traktuj ją jako informacyjną, a nie konfigurowalną.

Zasoby organizacji obejmują pulę Shared Bird.com Pool, oznaczoną protected: true. Ma ona identyfikator puli, a zarezerwowany alias ipp_shared wskazuje na tę pulę. Zarządza nią Bird: nie można zmienić jej nazwy ani jej usunąć, nie może zawierać dedykowanych adresów IP i nie jest wliczana do limitu pul. Obszar roboczy z przypisanymi pulami widzi ją, gdy pula współdzielona jest przypisana do tego obszaru roboczego. Użycie aliasu wymaga tych samych uprawnień co użycie identyfikatora.

Gdy przypisania do obszarów roboczych są dostępne, panel przyznaje bieżącemu obszarowi roboczemu dostęp do nowo utworzonych pul. Przy pierwszym zakupie dedykowanego adresu IP w panelu utwórz jego pulę przed potwierdzeniem płatności. Zakupy przez API lub CLI bez identyfikatora puli tworzą pulę organizacji, która nadal wymaga przypisania do obszaru roboczego.

Gdy przypisania do obszarów roboczych są dostępne, przyznaj pulę bez zmiany domyślnej puli obszaru roboczego:

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

W obszarze roboczym bez przypisań ta operacja zachowuje też wysyłkę przez pulę współdzieloną, przypisując ją jako domyślną. Pominięcie --is-default lub ustawienie go na true sprawia natomiast, że domyślna staje się pierwsza przypisana pula, a wysyłka jest ograniczona do przypisanego zestawu. Rozgrzewająca się pula dedykowana wymaga także przypisania puli współdzielonej, ponieważ nadmiar ruchu podczas rozgrzewania korzysta ze współdzielonych adresów IP. Obszary robocze bez przypisanych pul korzystają z puli współdzielonej.

Aby usunąć przypisanie, najpierw zastąp domyślny wybór oraz zapisane użycia w ustawieniach domyślnych domen, skrzynkach pocztowych, ustawieniach SMTP oraz w wersjach roboczych, zaplanowanych lub niedokończonych broadcastach. Historia zakończonych broadcastów zachowuje pierwotną pulę i nie blokuje usunięcia.

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

Przenieś adres IP między pulami

Dedykowany adres IP jest zawsze w dokładnie jednej puli, bez stanu nieprzypisanego. Przeniesienie to pojedyncze przypisanie:

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

Pula współdzielona nie jest prawidłowym celem: dedykowane adresy IP mogą znajdować się tylko w Twoich własnych pulach.

Usuń pulę

Usunąć można tylko puste pule. Próba usunięcia puli, która wciąż zawiera adresy IP, jest odrzucana z błędem 409; najpierw przenieś lub anuluj jej adresy IP. Przed usunięciem puli zastąp jej domyślne wybory i usuń jej przypisania do obszarów roboczych oraz zapisane użycia.

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv --yes

Domyślna pula

Gdy ani wysyłka, ani jej domena nadawcza nie wskazuje puli, używamy Twojej domyślnej puli. W organizacjach zarządzających pulami osobno dla każdego obszaru roboczego jest to domyślna pula danego obszaru roboczego. Poniższe reguły dotyczą tej puli domyślnej:

• Dokładnie jedna pula jest zawsze domyślna. Pula współdzielona jest początkową domyślną, więc ta zasada obowiązuje od pierwszego dnia.
• Domyślną pulę przenosi się, a nie usuwa. Zmień ją, wyznaczając inną pulę jako domyślną. Poprzednia domyślna traci status w tej samej chwili, więc w każdym momencie jest dokładnie jedna domyślna. Wyłączenie is_default na bieżącej domyślnej jest odrzucane z błędem 422; aby wrócić do routingu współdzielonego, ustaw pulę współdzieloną jako domyślną:

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

W organizacjach, które zarządzają pulami osobno dla każdego obszaru roboczego, wybierz zamiast tego domyślną pulę obszaru roboczego:

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

Korzystaj z przypisań do obszarów roboczych, gdy operacja update --is-default na poziomie organizacji zwraca IPPoolOrganizationDefaultRetired. Zmiany przypisań mogą być tymczasowo niedostępne w okresie przejściowym. Zmiana domyślnej puli jednego obszaru roboczego nie zmienia domyślnych pul innych obszarów roboczych.

• Dedykowana pula potrzebuje co najmniej jednego adresu IP, który nie jest wygaszany, aby mogła zostać domyślną. Adres IP w statusie warming się liczy; adres IP w statusie pending_cancellation nie. Twoja domyślna pula nigdy nie może opierać się wyłącznie na adresach IP na drodze do wycofania. Pula współdzielona jest wyjątkiem i jest zawsze prawidłową domyślną.
• Ostatni pozostały adres IP nie może opuścić domyślnej puli. Dopóki pula ma status domyślnej, jej ostatniego adresu IP nie można ani anulować, ani przenieść; najpierw przełącz domyślną, potem opróżnij pulę.

Te kontrole chronią planowane zmiany. Jeśli pula dedykowana straci adresy IP do wysyłki lub potrzebne uprawnienia, wysyłki przez tę pulę kończą się błędem, dopóki jej nie przywrócisz lub nie wybierzesz innej dozwolonej domyślnej puli.

Wybierz pulę w momencie wysyłki

Routing to część tej funkcji, która działa w publicznym API. Wybierz pulę na wiadomość za pomocą opcjonalnego pola ip_pool_id w 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"
  }'

Rozwiązywanie działa następująco:

• ip_pool_id pominięte: wysyłka korzysta z domyślnej puli domeny nadawczej w bieżącym obszarze roboczym, jeśli została ustawiona; w przeciwnym razie korzysta z domyślnego routingu.
• ip_pool_id: "ipp_shared": wysyłka korzysta z puli współdzielonej, gdy Twój obszar roboczy może z niej korzystać. Ta wartość wybiera infrastrukturę współdzieloną nawet wtedy, gdy Twoją domyślną jest pula dedykowana.
• ip_pool_id ustawione na identyfikator puli: wysyłka korzysta z tej puli, gdy jest ona dostępna dla Twojego obszaru roboczego.

Wartość nieznana, niedostępna dla obszaru roboczego lub wskazująca pulę bez dostępnych adresów IP jest odrzucana z błędem 422. Dedykowana pula z rozgrzewającymi się adresami IP potrzebuje też uprawnienia do korzystania z puli współdzielonej, która przyjmuje nadmiar ruchu podczas rozgrzewania. Odebranie uprawnienia do puli współdzielonej sprawia, że ta trasa rozgrzewania staje się niedostępna. Jawny wybór puli jest zachowywany dla przyjętych wiadomości i sprawdzany ponownie przed wysłaniem; późniejsze odebranie uprawnienia może zatrzymać doręczenie. Bird nie zastępuje niedostępnego jawnego wyboru inną pulą.

Anulowanie dedykowanego adresu IP

Anulowanie jest dwuetapowe. Anulowanie planuje usunięcie zamiast natychmiastowego usuwania adresu IP:

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

Adres IP przechodzi w status pending_cancellation i otrzymuje znacznik czasu cancels_at, oznaczający koniec opłaconego okresu rozliczeniowego. Do momentu cancels_at wysyła dalej jako część swojej puli; po tym czasie deaktywujemy go w ciągu godziny. Anulowanie adresu IP, który już oczekuje na usunięcie, nie ma dalszego efektu.

Uwzględnij jedną natychmiastową konsekwencję: adres IP w statusie pending_cancellation natychmiast przestaje być liczony w regułach domyślnej puli. Zabezpieczenie domyślnej puli nadal obowiązuje: ostatniego adresu IP w domyślnej puli nie można anulować; najpierw przenieś domyślną (na pulę współdzieloną lub inną pulę).

Następne kroki

• IP warmup: jak nowe dedykowane adresy IP rozgrzewają się do pełnego wolumenu i kiedy przełączyć domyślną
• Wysyłanie e-maili: pełne żądanie wysyłki, w tym ip_pool_id
• Dostarczalność · Email: model reputacji, w który wpinają się dedykowane adresy IP
• Zakup dedykowanego IP: wideo pokazujące zakup w dashboardzie i początek rozgrzewania