डेडिकेटेड IP और पूल

शेयर्ड इंफ्रास्ट्रक्चर पर आपका ईमेल उन IP पतों से भेजा जाता है जिन्हें आप दूसरे ग्राहकों के साथ साझा करते हैं। हम उन IP को स्वस्थ रखते हैं, फिर भी आपकी प्रतिष्ठा बाकी सभी की प्रतिष्ठा के साथ जुड़ी रहती है। डेडिकेटेड IP ऐसा पता है जिससे केवल आपका संगठन ईमेल भेजता है। इसलिए मेलबॉक्स प्रदाता आपके ट्रैफ़िक को सिर्फ़ आपके अपने रिकॉर्ड के आधार पर आंकते हैं। IP पूल डेडिकेटेड IP को रूट की जा सकने वाली इकाइयों में समूहित करते हैं। भेजते समय ip_pool_id फ़ील्ड उस संदेश के लिए पूल चुनता है।

ईमेल भेजने के लिए आपको डेडिकेटेड IP की कभी ज़रूरत नहीं होती। हर संगठन Shared Bird.com Pool को डिफ़ॉल्ट के रूप में लेकर शुरू करता है, इसलिए पहले दिन से ही बिना किसी कॉन्फ़िगरेशन के ईमेल भेजा जा सकता है। डेडिकेटेड IP एक सशुल्क ऐड-ऑन हैं। इनका फ़ायदा तभी मिलता है जब आप लगातार अच्छी मात्रा में ईमेल भेजते हैं। कम इस्तेमाल होने वाला डेडिकेटेड IP उतनी प्रतिष्ठा धीरे बनाता है जितनी शेयर्ड पूल के पास पहले से है। इसलिए कम मात्रा में भेजने वालों के लिए आमतौर पर शेयर्ड पूल पर बने रहना बेहतर होता है। क्या डेडिकेटेड IP ईमेल डिलीवरेबिलिटी सुधारता है? बताता है कि भेजने की मात्रा और प्रतिष्ठा इस फ़ैसले पर कैसे असर डालती हैं।

खरीदने से पहले दो बातें जान लें:

• नए IP पूरी मात्रा संभालने से पहले अपने-आप वार्मअप से गुज़रते हैं। इस दौरान अतिरिक्त ट्रैफ़िक शेयर्ड पूल से होकर जाता है।
• IP और पूल आपके संगठन के होते हैं।

इन्हें कहाँ प्रबंधित करें

पूल और IP को डैशबोर्ड में Email > IP Pools में प्रबंधित करें, या bird email ip-pools और bird email dedicated-ips CLI कमांड से। इन कार्रवाइयों के लिए संगठन-स्तर की अनुमतियाँ चाहिए। SDK में प्रबंधन के लिए टाइप किए गए मेथड शामिल नहीं हैं। किसी संदेश को किसी पूल से भेजने के लिए ip_pool_id सेट करें, जैसा भेजते समय पूल चुनें में बताया गया है।

डेडिकेटेड IP खरीदें

Dedicated IPs टैब से या CLI से IP खरीदें:

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

• पहली खरीद पर आप --ip-pool-id छोड़ सकते हैं: हम आपका पहला पूल बनाते हैं, जिसका नाम "Dedicated IPs" होता है, और IPs उसी में प्रोविज़न करते हैं। जब आपके संगठन में कम से कम एक पूल हो जाता है, तब यह फ़्लैग ज़रूरी हो जाता है, और हर नया IP कहाँ जाएगा, यह आप चुनते हैं।
• हर IP का बिल मासिक सब्सक्रिप्शन के रूप में आता है। अगर आपके वॉलेट का बैलेंस खरीद के लिए काफ़ी नहीं है, तो प्रतिक्रिया में requires_topup (आगे बढ़ने के लिए टॉप अप करें) या pending_topup (कार्ड से भुगतान प्रक्रिया में है) आता है। राशि पहुँचते ही IPs अपने आप प्रोविज़न हो जाते हैं।
• खरीद की सीमा आपके प्लान के email_ip_dedicated_max कोटा से तय होती है, और पूलों की सीमा email_ip_pools_max से।

हर प्रोविज़न किया गया IP warming स्थिति में शुरू होता है और अपने आप वॉल्यूम बढ़ाता है। शेड्यूल और उसकी निगरानी का तरीका IP वार्मअप में बताया गया है। IP का hostname उसका reverse-DNS (PTR) नाम है, यानी वह नाम जिससे वह प्राप्त करने वाले मेल सर्वरों के सामने अपनी पहचान बताता है। भेजने वाले होस्टनेम पर फ़िल्टर करने वाली हर अनुमति सूची में इसे जोड़ें।

IP खरीदने से आपका डिफ़ॉल्ट पूल नहीं बदलता। जब तक आप ख़ुद इसे नहीं बदलते, शेयर्ड पूल ही डिफ़ॉल्ट रहता है। वजह यह है कि बिना पूल बताए भेजा गया पूरा ट्रैफ़िक किसी नए, अभी वार्म हो रहे IP पर भेजने से आपकी डिलीवरेबिलिटी को नुकसान होगा।

किसी IP की स्थिति इन चार में से एक होती है:

IP पूल

पूल भेजने की धाराओं को अलग रखते हैं। एक आम सेटअप में ट्रांज़ैक्शनल मेल के लिए एक पूल और मार्केटिंग के लिए दूसरा पूल होता है, ताकि किसी कैंपेन की प्रतिष्ठा का असर आपके पासवर्ड रीसेट ईमेल पर कभी न पड़े। पूल बनाना मुफ़्त है, आपके प्लान के email_ip_pools_max कोटा तक।

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

पूल हमेशा नॉन-डिफ़ॉल्ट और खाली बनाए जाते हैं। आप उन्हें सीधे उनमें IP खरीदकर (खरीद पर --ip-pool-id देकर) या मौजूदा IP उनमें ले जाकर भरते हैं। किसी पूल को वापस पढ़ने पर उसके सदस्य 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"
}

पूल संगठन के स्वामित्व में होते हैं। हर IP का hostname उस IP के प्रोविज़न होते समय अपने-आप असाइन होता है। इसे केवल जानकारी के लिए मानें, यह ऐसी चीज़ नहीं है जिसे आप कॉन्फ़िगर करते हैं।

आपकी पूल सूची में हमेशा Shared Bird.com Pool शामिल रहता है, जिस पर protected: true अंकित होता है। यह किसी भी अन्य पूल की तरह एक पूल ID के साथ दिखता है, और जहाँ भी पूल ID स्वीकार की जाती है, वहाँ आरक्षित उपनाम ipp_shared इसी पूल को दर्शाता है। सुरक्षित होने का अर्थ है कि इसे हम प्रबंधित करते हैं: इसका नाम बदला या इसे हटाया नहीं जा सकता, इसमें डेडिकेटेड IP नहीं रखे जा सकते, और यह आपके पूल कोटा में नहीं गिना जाता। आप इसके बारे में केवल यह बदल सकते हैं कि यह डिफ़ॉल्ट है या नहीं।

किसी IP को एक पूल से दूसरे पूल में ले जाएँ

डेडिकेटेड IP हमेशा ठीक एक पूल में रहता है, बिना असाइन की कोई स्थिति नहीं होती। उसे ले जाने के लिए एक ही असाइनमेंट काफ़ी है:

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

शेयर्ड पूल को गंतव्य के रूप में नहीं चुना जा सकता, क्योंकि डेडिकेटेड IP केवल आपके अपने पूल में रहते हैं।

पूल हटाएँ

केवल खाली पूल हटाए जा सकते हैं। जिस पूल में अभी भी IP हैं, उसे हटाने का अनुरोध 409 के साथ अस्वीकार कर दिया जाता है। पहले उसके IP को किसी दूसरे पूल में ले जाएँ या रद्द करें। डिफ़ॉल्ट पूल को बिल्कुल नहीं हटाया जा सकता। उसे हटाने से पहले किसी दूसरे पूल को डिफ़ॉल्ट बनाएँ।

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

डिफ़ॉल्ट पूल

जब कोई सेंड पूल निर्दिष्ट नहीं करता, तो हम आपके डिफ़ॉल्ट पूल का उपयोग करते हैं। इसके नियम सख्त हैं, क्योंकि पूल न चुनने वाले हर सेंड को डिफ़ॉल्ट पूल ही संभालता है:

• हमेशा ठीक एक पूल डिफ़ॉल्ट होता है। शुरुआत में शेयर्ड पूल डिफ़ॉल्ट होता है, इसलिए यह नियम पहले दिन से लागू रहता है।
• डिफ़ॉल्ट को बदला जाता है, हटाया कभी नहीं जाता। इसे बदलने के लिए किसी दूसरे पूल को डिफ़ॉल्ट बनाएँ। इससे पिछला डिफ़ॉल्ट उसी क्षण बंद हो जाता है, इसलिए हर समय ठीक एक डिफ़ॉल्ट रहता है। मौजूदा डिफ़ॉल्ट पर is_default बंद करने का अनुरोध 422 के साथ अस्वीकार कर दिया जाता है। शेयर्ड रूटिंग पर लौटने के लिए शेयर्ड पूल को डिफ़ॉल्ट बनाएँ:

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

• किसी डेडिकेटेड पूल को डिफ़ॉल्ट बनने के लिए कम से कम एक ऐसा IP चाहिए जो बंद होने की प्रक्रिया में न हो। warming IP गिना जाता है, लेकिन pending_cancellation स्थिति वाला IP नहीं गिना जाता। आपका डिफ़ॉल्ट पूल केवल ऐसे IP पर निर्भर नहीं हो सकता जो हटाए जा रहे हों। शेयर्ड पूल पर यह नियम लागू नहीं होता और वह हमेशा एक वैध डिफ़ॉल्ट होता है।
• डिफ़ॉल्ट पूल का आखिरी IP उससे बाहर नहीं जा सकता। जब तक कोई पूल डिफ़ॉल्ट है, तब तक उसका आखिरी IP न रद्द किया जा सकता है और न ही दूसरे पूल में ले जाया जा सकता है। पहले डिफ़ॉल्ट बदलें, फिर पूल खाली करें।

इन नियमों के कारण आपके डिफ़ॉल्ट पूल में भेजने के लिए हमेशा कोई न कोई IP रहता है।

भेजते समय पूल चुनें

इस सुविधा में रूटिंग ही वह हिस्सा है जो सार्वजनिक API में उपलब्ध है। POST /v1/email/messages पर वैकल्पिक ip_pool_id फ़ील्ड से हर संदेश के लिए पूल चुनें:

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

पूल इस तरह तय होता है:

• ip_pool_id नहीं दिया गया: भेजा गया संदेश आपके डिफ़ॉल्ट पूल से जाता है।
• ip_pool_id: "ipp_shared": आपका डिफ़ॉल्ट चाहे जो हो, संदेश शेयर्ड पूल से भेजा जाता है। जब कोई डेडिकेटेड पूल आपका डिफ़ॉल्ट हो, तब कम महत्व वाली ईमेल को शेयर्ड इन्फ्रास्ट्रक्चर पर रखने के लिए यह उपयोगी है।
• ip_pool_id आपके किसी पूल ID पर सेट है: संदेश उसी पूल से भेजा जाता है।

अगर मान अज्ञात है, किसी दूसरे संगठन का है, या ऐसे पूल का है जिसमें कोई उपलब्ध IP नहीं है, तो अनुरोध 422 के साथ अस्वीकार हो जाता है। आपने जो पूल स्पष्ट रूप से चुना है, उसे हम शेयर्ड इन्फ्रास्ट्रक्चर पर नहीं भेजते।

डेडिकेटेड IP रद्द करना

रद्द करना दो चरणों में होता है। रद्द करने पर IP तुरंत नहीं हटता, बल्कि उसे हटाने का समय तय हो जाता है:

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

IP की स्थिति pending_cancellation हो जाती है और उसे cancels_at टाइमस्टैम्प मिलता है। यह उस बिलिंग अवधि का अंत है जिसका भुगतान आप कर चुके हैं। cancels_at तक IP अपने पूल के हिस्से के रूप में ईमेल भेजता रहता है। उसके बाद हम एक घंटे के भीतर उसे हटा देते हैं। जो IP पहले से रद्द होने की प्रतीक्षा में है, उसे दोबारा रद्द करने का कोई असर नहीं होता।

एक असर तुरंत होता है, इसलिए उसके अनुसार योजना बनाएँ: pending_cancellation IP उसी समय से डिफ़ॉल्ट पूल के नियमों में नहीं गिना जाता। डिफ़ॉल्ट पूल की सुरक्षा भी लागू रहती है: डिफ़ॉल्ट पूल का आखिरी IP रद्द नहीं किया जा सकता। पहले डिफ़ॉल्ट को शेयर्ड पूल या किसी दूसरे पूल पर ले जाएँ।

अगले कदम

• IP वार्मअप: नए डेडिकेटेड IP पूरी मात्रा तक कैसे पहुँचते हैं, और अपना डिफ़ॉल्ट कब बदलें
• ईमेल भेजना: ip_pool_id सहित भेजने का पूरा अनुरोध
• डिलीवरेबिलिटी · ईमेल: वह प्रतिष्ठा मॉडल जिससे डेडिकेटेड IP जुड़ते हैं
• डेडिकेटेड IP खरीदना: एक वीडियो, जिसमें डैशबोर्ड में एक IP खरीदा जाता है और वार्मअप शुरू होते हुए दिखाया जाता है