डेडिकेटेड 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" होता है, और IP उसमें प्रोविज़न करते हैं। एक बार आपके संगठन में कम से कम एक पूल हो जाए, तो यह फ़्लैग ज़रूरी है; आप चुनते हैं कि हर नया IP कहाँ जाए।
- हर IP की बिलिंग मासिक सब्सक्रिप्शन के रूप में होती है। जब आपके वॉलेट का बैलेंस खरीदारी के लिए पर्याप्त नहीं होता, तो रिस्पॉन्स requires_topup (आगे बढ़ने के लिए टॉप अप करें) या pending_topup (कार्ड चार्ज सेटल हो रहा है) रिपोर्ट करता है; फ़ंड आते ही IP अपने आप प्रोविज़न हो जाते हैं।
- खरीदारी आपके प्लान के email_ip_dedicated_max कोटा से सीमित है, और पूल email_ip_pools_max से।
हर प्रोविज़न किया गया IP warming स्टेटस में शुरू होता है और अपने आप रैंप करता है; IP वॉर्मअप शेड्यूल और मॉनिटरिंग का तरीका बताता है। IP का hostname उसका reverse-DNS (PTR) नाम है, वही नाम जो वह प्राप्त करने वाले मेल सर्वर को अपनी पहचान के रूप में देता है; भेजने वाले होस्टनेम पर फ़िल्टर करने वाली किसी भी allowlist में इसे जोड़ें।
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-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 प्रोविज़निंग के समय अपने आप असाइन होता है; इसे कॉन्फ़िगर करने योग्य नहीं, बल्कि सूचनात्मक मानें।
आपकी पूल सूची में हमेशा Shared Bird.com Pool शामिल होता है, जो protected: true चिह्नित होता है। यह किसी भी अन्य पूल की तरह एक पूल ID के साथ दिखता है, और रिज़र्व्ड एलियास ipp_shared जहाँ भी पूल ID स्वीकार किया जाता है वहाँ इसी में रिज़ॉल्व होता है। सुरक्षा का अर्थ है कि हम इसे प्रबंधित करते हैं: इसका नाम बदला या हटाया नहीं जा सकता, इसमें डेडिकेटेड 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 को न तो रद्द किया जा सकता है न ही हटाया; पहले डिफ़ॉल्ट स्विच करें, फिर पूल खाली करें।
ये सभी नियम मिलकर सुनिश्चित करते हैं कि आपके डिफ़ॉल्ट पूल में भेजने के लिए हमेशा कुछ उपलब्ध हो।
भेजते समय पूल चुनें
रूटिंग इस फ़ीचर का वह हिस्सा है जो पब्लिक 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.devcurl -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_5g8r8h31kr8cz8zp1p4s837r4mIP pending_cancellation में बदलता है और उसे एक cancels_at टाइमस्टैम्प मिलता है, जो उस बिलिंग अवधि का अंत है जिसका आपने पहले ही भुगतान किया है। cancels_at तक यह अपने पूल के हिस्से के रूप में भेजता रहता है; उसके बाद हम इसे एक घंटे के भीतर डीप्रोविज़न कर देते हैं। पहले से पेंडिंग IP को रद्द करने का कोई अतिरिक्त प्रभाव नहीं होता।
एक तात्कालिक परिणाम के लिए योजना बनाएँ: pending_cancellation IP तुरंत डिफ़ॉल्ट-पूल नियमों की गणना में नहीं गिना जाता। और डिफ़ॉल्ट-पूल गार्ड अभी भी लागू होता है: डिफ़ॉल्ट पूल का अंतिम IP रद्द नहीं किया जा सकता; पहले डिफ़ॉल्ट को (शेयर्ड पूल या किसी अन्य पूल में) ले जाएँ।
अगले कदम
- IP वॉर्मअप: नए डेडिकेटेड IP कैसे पूर्ण वॉल्यूम तक पहुँचते हैं, और अपना डिफ़ॉल्ट कब बदलें
- ईमेल भेजना: पूरा भेजने का अनुरोध, ip_pool_id सहित
- डिलीवरेबिलिटी · Email: वह प्रतिष्ठा मॉडल जिसमें डेडिकेटेड IP जुड़ते हैं
- डेडिकेटेड IP खरीदना: एक वीडियो जिसमें डैशबोर्ड में IP खरीदकर वॉर्म-अप शुरू होते दिखाया गया है
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।