Email का अवलोकन

POST /v1/email/messages के ज़रिए ट्रांज़ैक्शनल और मार्केटिंग ईमेल भेजें। bk_{region}_... key का उपयोग उसके मैचिंग रीजनल होस्ट के साथ करें: https://us1.platform.bird.com या https://eu1.platform.bird.com। हम मैसेज को DKIM से साइन करते हैं, डिलीवर करते हैं, और हर प्राप्तकर्ता का परिणाम रिपोर्ट करते हैं।

आगे पढ़ने से पहले कुछ भेजने के लिए, क्विकस्टार्ट आपको API key से डिलीवर हुए मैसेज तक ले जाता है। यह पेज उस मॉडल को कवर करता है जो इस सेक्शन का बाकी हिस्सा मानता है, और हर भाग की गाइड की ओर इशारा करता है।

एक कॉल में send स्वीकार होता है और asynchronously डिलीवर होता है। POST /v1/email/messages पेलोड और sending domain को validate करता है, फिर एक em_ message ID के साथ 202 Accepted लौटाता है। हर प्राप्तकर्ता का परिणाम webhook events या message endpoints से पढ़ें। ईमेल भेजना में पेलोड, field limits और response शामिल हैं।

इस मॉडल के दो परिणाम इस सेक्शन के बाकी हिस्से को आकार देते हैं।

एक संदेश, कई प्राप्तकर्ता, हर एक का अपना lifecycle। पाँच पतों पर भेजा गया एक संदेश पाँच स्वतंत्र परिणाम देता है, और आप जो message-level status पढ़ते हैं वह उन सबका aggregate है। Suppression का मूल्यांकन भी उसी तरह होता है: एक suppressed पता rejected लौटता है जबकि बाकी चार डिलीवर हो जाते हैं।

हर संदेश बताता है कि आप इसे क्यों भेज रहे हैं। transactional या marketing की category तय करती है कि कौन-से suppressions उस पर लागू होंगे। जिसने आपके newsletter से unsubscribe किया है, उसे भी अपना password reset मिलना चाहिए, और category ही हमें यह अंतर बताती है।

एक send किसी दूसरे रास्ते से भी आ सकता है, या बाद में जा सकता है। SMTP उस protocol को बोलने वाली किसी भी चीज़ से submissions स्वीकार करता है, और शेड्यूल्ड सेंडिंग संदेश को आपके तय किए गए समय तक रोककर रखता है।

Email डैशबोर्ड साइडबार के चैनलों में से एक है। इसके पेज, जिस क्रम में दिखते हैं:

प्राप्तकर्ता Email सेक्शन के बाहर, साइडबार में Contacts के अंदर रहते हैं: All contacts में लोग typed custom properties के साथ स्टोर होते हैं (देखें Contacts), और Audiences उन्हें उन पुन: उपयोग योग्य सूचियों में समूहित करता है जिन पर broadcast भेजा जाता है (देखें Audiences)।

भेजना। ईमेल भेजना सबसे पहले पढ़ें: इसमें वह पेलोड है जिसका हर दूसरा send path एक variation है। वहाँ से, templates आपके पुन: उपयोग किए जाने वाले content को स्टोर करते हैं, attachments फ़ाइलें जोड़ते हैं, batch sending एक request में 100 तक संदेश सबमिट करता है, और broadcasts पूरी audience को एक ईमेल भेजता है।

Domains और authentication। Sending domains में domain रजिस्टर करना और उसे verify कराना शामिल है। DKIM, SPF, और DMARC बताता है कि हर record प्राप्तकर्ता mailbox provider को क्या साबित करता है, और BIMI इसे सपोर्ट करने वाले email apps में आपके संदेशों के बगल में आपका logo दिखाता है।

Reputation। Suppressions उन पतों की सूची है जिन पर हम भेजना बंद कर देते हैं; यह hard bounces और complaints से अपने आप भरती है; unsubscribes भी उसी तरह delivery रोकते हैं, लेकिन suppression record की जगह एक स्पष्ट प्राथमिकता के ज़रिए। Dedicated IPs and pools और IP warmup में उन IP addresses से भेजना शामिल है जो केवल आपका संगठन उपयोग करता है। Email deliverability इन सबको एक साथ जोड़ता है।

क्या हुआ, यह जानना। email log एक संदेश और उसकी per-recipient timeline दिखाता है। Email metrics आपके ट्रैफ़िक को aggregate करता है। Events event vocabulary है और बताता है कि webhooks इसे आपके endpoint तक कैसे पहुँचाते हैं।

प्राप्त करना। ईमेल प्राप्त करना दोनों तरीके कवर करता है: एक forwarding address जो हम generate करते हैं और जिसे DNS की ज़रूरत नहीं, या आपके अपने subdomain पर MX records। Agent mailboxes इसके ऊपर ऐसे इनबॉक्स बनाता है जिनसे आपका कोड भेजता भी है और पढ़ता भी है।

टेस्टिंग। mail sandbox आपके integration को कहीं भी डिलीवर किए बिना end to end टेस्ट करता है। असली event और webhook pipeline के ज़रिए hard bounce generate करने के लिए bounce@messagebird.dev पर भेजें। यह टेस्ट आपकी suppression list में कुछ नहीं लिखता।

प्रोडक्शन ईमेल किसी दूसरे provider से माइग्रेट करने के लिए migration guide का पालन करें। इसमें request mapping, DNS, suppressions, webhooks, sandbox testing और traffic cutover शामिल हैं।