ट्रांजैक्शनल ईमेल को Cloudflare ईमेल सेवा में माइग्रेट करें

मैं इस कोडबेस के आउटबाउंड ईमेल को वर्तमान प्रदाता (Postmark / SES / Resend / SendGrid / Mailgun / आदि) से Cloudflare Email Service (पब्लिक बीटा, अप्रैल 2026 में लॉन्च) में माइग्रेट करना चाहता हूँ। इसे सावधानी से करने में मेरी मदद करें। ## संदर्भ: Cloudflare Email Service क्या है Cloudflare का एक नया ट्रांजेक्शनल ईमेल API। एंडपॉइंट: ``` POST https://api.cloudflare.com/client/v4/accounts/{ACCOUNT_ID}/email/sending/send Authorization: Bearer {API_TOKEN} Content-Type: application/json ``` रिक्वेस्ट बॉडी: ```json { "to": "user@example.com", // स्ट्रिंग या स्ट्रिंग्स की ऐरे "from": "no-reply@yourdomain.com", // स्ट्रिंग या {"address":"x@y","name":"Display"} "subject": "...", "html": "<p>...</p>", // वैकल्पिक "text": "...", // वैकल्पिक (html/text में से एक आवश्यक) "cc": ["..."], // वैकल्पिक, ऐरे "bcc": ["..."], // वैकल्पिक, ऐरे "reply_to": "...", // वैकल्पिक, सिंगल स्ट्रिंग "headers": {"List-Unsubscribe": "<...>"} // वैकल्पिक, जैसे न्यूज़लेटर के लिए } ``` सफलता प्रतिक्रिया: HTTP 200 + `{"success":true,"result":{"delivered":[],"queued":[],"permanent_bounces":[]}}`। विफलता: गैर-200 या `success:false` या गैर-खाली `permanent_bounces`। हमेशा तीनों की जाँच करें। मूल्य निर्धारण: $5/माह Workers Paid प्लान + 3,000 ईमेल मुफ्त + उसके बाद $0.35 प्रति 1k। Postmark से लगभग 5x सस्ता। कोई बैच सेंड एंडपॉइंट नहीं - सिंगल सेंड्स को लूप करें। ## आपको जिन चरणों का पालन करना चाहिए ### 1. मेरे साथ पूर्वापेक्षाएँ सत्यापित करें कोई कोड लिखने से पहले, मुझसे पुष्टि करने के लिए कहें: - मेरे पास Cloudflare Workers Paid प्लान है ($5/माह) - मैंने Cloudflare डैशबोर्ड → Email → Email Sending → Onboard Domain में अपने सेंडर डोमेन(s) को ऑनबोर्ड किया है (यह स्वचालित रूप से SPF/DKIM/DMARC + cf-bounce MX रिकॉर्ड्स जोड़ता है) - मेरे पास `email_sending:write` स्कोप वाला API टोकन है (https://dash.cloudflare.com → Custom Token पर बनाया गया) - मेरे पास मेरा Cloudflare खाता ID है जब तक आपके पास ये न हों, आगे न बढ़ें। ### 2. डोमेन प्रतिष्ठा रणनीति की सिफारिश करें अधिकांश ऐप्स को सेंडर्स को 2-3 सबडोमेन में विभाजित करना चाहिए ताकि एक पर स्पैम शिकायतें दूसरों की डिलीवरेबिलिटी को नीचे न खींचें: - `mail.<domain>` या `members.<domain>` → ट्रांजेक्शनल (लॉगिन, रसीदें, पासवर्ड रीसेट, इन-ऐप नोटिफिकेशन) - `e.<domain>` → कोल्ड/रिकवरी (परित्यक्त कार्ट, विन-बैक कैंपेन) - `newsletter.<domain>` → List-Unsubscribe हेडर्स के साथ ऑप्ट-इन न्यूज़लेटर प्रत्येक सबडोमेन को Cloudflare में अलग से ऑनबोर्ड करने की आवश्यकता है। मुझसे पूछें कि मैं कौन सा चाहता हूँ। ### 3. मौजूदा ईमेल सेंड्स का ऑडिट करें इस कोडबेस में हर उस जगह को खोजने के लिए grep/search का उपयोग करें जहाँ ईमेल भेजा जाता है। देखें: - वर्तमान प्रदाता के SDK क्लास नाम, API URLs, env/config वेरिएबल्स - `mail()`, SMTP उपयोग, `nodemailer`, आदि जैसे सामान्य पैटर्न निष्कर्षों को फ़ाइल के बजाय ईमेल प्रकार/उद्देश्य के अनुसार समूहित करें (जैसे "मैजिक-लिंक लॉगिन", "भुगतान रसीद", "साप्ताहिक न्यूज़लेटर")। कुछ भी बदलने से पहले मुझे बताएं कि आपको क्या मिला। ### 4. एक सिंगल हेल्पर फंक्शन जोड़ें कोडबेस में Cloudflare API कॉल्स न छिड़कें। एक हेल्पर जोड़ें (प्रदाता-विशिष्ट नाम जैसे `sendEmailViaCloudflare()`) जो: - `from` को कॉन्फ़िग वेरिएबल से डिफ़ॉल्ट करता है (हार्डकोड न करें) - `"Name <email@domain>"` स्ट्रिंग्स को API के `{address, name}` ऑब्जेक्ट रूप में पार्स करता है - `cc`/`bcc` को स्ट्रिंग या ऐरे के रूप में स्वीकार करता है - `headers` डिक्शनरी स्वीकार करता है (न्यूज़लेटर्स को `List-Unsubscribe` + `List-Unsubscribe-Post` चाहिए) - `bool` लौटाता है (सफलता पर true, किसी भी विफलता पर false) - विफलता पर, कहीं लॉग/अलर्ट करता है जहाँ मैं देख सकूँ (Telegram, Sentry, लॉग फ़ाइल - जो कोडबेस पहले से करता है उससे मिलाएँ) - curl/fetch टाइमआउट सेट करता है (5s कनेक्ट, 15s कुल) ताकि अटका हुआ CF API रिक्वेस्ट को हैंग न कर सके - `permanent_bounces: [...]` गैर-खाली को सॉफ्ट विफलता के रूप में मानता है ### 5. पहले एक कम-जोखिम वाला ईमेल प्रकार माइग्रेट करें सब कुछ एक साथ माइग्रेट न करें। ऑडिट में सबसे कम-जोखिम वाला ईमेल प्रकार चुनें (ऐसा कुछ जहाँ स्पैम में जाने से मुझे पैसे या उपयोगकर्ता न खोने पड़ें - जैसे "आंतरिक व्यवस्थापक अलर्ट", "प्रोफ़ाइल फोटो अस्वीकृति") और केवल उसे माइग्रेट करें। इसे एंड-टू-एंड टेस्ट करें। पुष्टि करें कि ईमेल वास्तव में पहुँचता है। उसके बाद ही अगला माइग्रेशन प्रस्तावित करें। ### 6. मुझे अभी लॉगिन ईमेल माइग्रेट करने से रोकें यदि मेरा कोडबेस मैजिक-लिंक लॉगिन या पासवर्ड-रीसेट ईमेल भेजता है, तो उन्हें अभी Cloudflare में माइग्रेट न करें। Cloudflare Email Service बिल्कुल नया है (लिखने के समय ~1 महीना पुराना)। इसकी IP/डोमेन प्रतिष्ठा अप्रमाणित है। लॉगिन ईमेल का स्पैम में जाना = उपयोगकर्ता लॉक आउट। उन्हें कम-जोखिम वाले प्रकारों पर कम से कम 3 महीने के साफ डिलीवरेबिलिटी डेटा तक वर्तमान प्रदाता पर रखें। मुझे यह स्पष्ट रूप से बताएं। ### 7. कमिट सीमाएँ सुझाएँ प्रत्येक सफल माइग्रेशन के बाद, स्पष्ट संदेश के साथ एक केंद्रित git कमिट सुझाएँ। असंबंधित परिवर्तनों को बंडल न करें। ## मुझे बताने के लिए महत्वपूर्ण चेतावनियाँ - बीटा उत्पाद। मूल्य निर्धारण पूरी तरह से अंतिम नहीं है। SLA अपरिभाषित है। बदल सकता है। - कोई बैच एंडपॉइंट नहीं। बड़े पैमाने पर सेंड्स (1000+ प्राप्तकर्ताओं को न्यूज़लेटर) को लूप की आवश्यकता होती है - ~150ms/सेंड पर वह ~2.5 मिनट प्रति 1000 है। क्रॉन्स के लिए ठीक है, सिंक यूज़र-फेसिंग फ्लो के लिए खराब। - अभी तक कोई बाउंस वेबहुक नहीं। प्रतिक्रिया बॉडी के `permanent_bounces` ऐरे के माध्यम से विफलताओं को सतह पर लाएँ। - सप्रेशन लिस्ट स्वचालित रूप से प्रबंधित। हार्ड बाउंस, बार-बार सॉफ्ट बाउंस, और स्पैम शिकायतें ब्लॉक हो जाती हैं। स्पैम-शिकायत सप्रेशन को हटाना कठिन है (एंटी-एब्यूज़)। - अभी तक कोई प्रति-संदेश लॉग/डैशबोर्ड नहीं। यदि मुझे ट्रैकिंग की आवश्यकता हो तो प्रतिक्रिया के `messageId` का उपयोग करें। - List-Unsubscribe हेडर्स वर्बेटिम पास किए जाते हैं - Gmail की बल्क-सेंडर आवश्यकता अभी भी पूरी होती है, लेकिन केवल तभी जब मैं उन्हें `headers` में शामिल करूँ। ## आपकी पहली कार्रवाई कोई कोड लिखने से पहले: चरण 1 (पूर्वापेक्षाएँ पूछें) और चरण 3 (मौजूदा सेंड्स का ऑडिट) करें, फिर तर्क के संक्षिप्त विवरण के साथ माइग्रेशन क्रम प्रस्तावित करें। परिवर्तन करने से पहले मेरी पुष्टि की प्रतीक्षा करें।