डेडिकेटेड 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 सेट करें, जैसा भेजते समय पूल चुनें में बताया गया है।

अगर आपका संगठन पूल की पहुँच हर वर्कस्पेस के लिए अलग से प्रबंधित करता है, तो उसके Email > IP pools पेज पर संगठन की पूरी सूची और वर्कस्पेस असाइनमेंट दिखते हैं। किसी वर्कस्पेस के पेज पर वे पूल दिखते हैं जिनका वह वर्कस्पेस उपयोग कर सकता है। इन असाइनमेंट को बदलने के लिए संगठन की अनुमतियाँ चाहिए। किसी एक वर्कस्पेस की पहुँच होने से उसी संगठन के दूसरे वर्कस्पेस के पूलों की पहुँच नहीं मिलती।

डैशबोर्ड में IP Pools व्यू, जिसमें वार्मअप हो रहे IP वाला एक कस्टम पूल और डिफ़ॉल्ट के रूप में चिह्नित संरक्षित Shared Bird.com Pool दिख रहा है

डेडिकेटेड 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 की स्थिति इन चार में से एक होती है:

स्थिति	मतलब
`warming`	IP नया है और वार्म हो रहा है। यह आपके ट्रैफ़िक का बढ़ता हुआ हिस्सा संभालता है, और बाकी ट्रैफ़िक शेयर्ड पूल में चला जाता है।
`active`	वार्मअप पूरा हो गया है। IP पूरा वॉल्यूम संभालता है।
`suspended`	IP अस्थायी रूप से निलंबित है।
`pending_cancellation`	आपने 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 होती है, और आरक्षित उपनाम ipp_shared इसी पूल को दर्शाता है। इसे Bird प्रबंधित करता है: इसका नाम बदला या इसे हटाया नहीं जा सकता, इसमें डेडिकेटेड IP नहीं रखे जा सकते, और यह आपके पूल कोटा में नहीं गिना जाता। असाइन किए गए पूल वाला वर्कस्पेस इसे तभी देखता है जब शेयर्ड पूल उस वर्कस्पेस को असाइन हो। उपनाम के उपयोग के लिए वही अनुमति चाहिए जो इसकी ID के उपयोग के लिए चाहिए।

जब वर्कस्पेस असाइनमेंट उपलब्ध होते हैं, तो डैशबोर्ड नए बनाए गए पूल का ऐक्सेस मौजूदा वर्कस्पेस को देता है। डैशबोर्ड से पहली डेडिकेटेड IP खरीदते समय भुगतान की पुष्टि करने से पहले उसका पूल बनाएं। पूल ID के बिना API या CLI से की गई खरीदारी संगठन का एक पूल बनाती है, जिसे अभी भी वर्कस्पेस को असाइन करना होगा।

जब वर्कस्पेस असाइनमेंट उपलब्ध हों, तो वर्कस्पेस का डिफ़ॉल्ट बदले बिना उसे कोई पूल दें:

कोड उदाहरण

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

जिस वर्कस्पेस का कोई असाइनमेंट नहीं है, उसके लिए यह शेयर्ड पूल को डिफ़ॉल्ट के रूप में असाइन करके शेयर्ड पूल से भेजना भी जारी रखता है। अगर आप --is-default छोड़ देते हैं या उसे true पर सेट करते हैं, तो पहला असाइन किया गया पूल डिफ़ॉल्ट बन जाता है और भेजना केवल असाइन किए गए पूलों तक सीमित हो जाता है। वार्म हो रहे डेडिकेटेड पूल के साथ शेयर्ड पूल भी असाइन होना चाहिए, क्योंकि वार्मअप का अतिरिक्त ट्रैफ़िक शेयर्ड IP से जाता है। जिन वर्कस्पेस का कोई पूल असाइनमेंट नहीं है, वे शेयर्ड पूल का उपयोग करते हैं।

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

कोड उदाहरण

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

किसी 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 --yes

डिफ़ॉल्ट पूल

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

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

कोड उदाहरण

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

जो संगठन हर वर्कस्पेस के लिए अलग से पूल प्रबंधित करते हैं, वे इसके बजाय वर्कस्पेस का डिफ़ॉल्ट चुनें:

कोड उदाहरण

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

जब संगठन-स्तर की update --is-default कार्रवाई IPPoolOrganizationDefaultRetired लौटाए, तब वर्कस्पेस असाइनमेंट का उपयोग करें। बदलाव की अवधि के दौरान असाइनमेंट में बदलाव कुछ समय के लिए उपलब्ध नहीं हो सकते। एक वर्कस्पेस का डिफ़ॉल्ट बदलने से दूसरे वर्कस्पेस के डिफ़ॉल्ट नहीं बदलते।

किसी डेडिकेटेड पूल को डिफ़ॉल्ट बनने के लिए कम से कम एक ऐसा 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 वाले डेडिकेटेड पूल को वार्मअप के अतिरिक्त ट्रैफ़िक के लिए शेयर्ड पूल के उपयोग की अनुमति भी चाहिए। शेयर्ड पूल की अनुमति हटाने पर वार्मअप वाला वह रूट उपलब्ध नहीं रहता। स्वीकार किए गए संदेशों के लिए स्पष्ट रूप से चुना गया पूल बना रहता है और भेजने से पहले उसकी फिर से जाँच होती है। बाद में अनुमति हटाने से डिलीवरी रुक सकती है। Bird किसी अनुपलब्ध स्पष्ट चुनाव की जगह कोई दूसरा पूल नहीं लगाता।

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

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

कोड उदाहरण

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

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

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

अगले कदम

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

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ

संबंधित संसाधन