आपका प्रोडक्ट जो मेल भेजता है
कॉल से नतीजे तक
आपका ऐप एक संदेश पोस्ट करता है और OpenEmail उसे आपके अपने डोमेन से भेजता है। हर कॉल उसी कुंजी के नाम दर्ज होती है जिसने उसे किया, और हर भेजे का नतीजा पढ़ा जा सकता है।
कॉल एक संदेश आईडी लौटाती है। आपके एंडपॉइंट पर आने वाले हर इवेंट में वही आईडी होती है।
यह कहाँ से शुरू होता है
आज यह कैसा दिखता है।
मेल आपके कोड से निकलता है
रसीदें, साइन-अप कोड और पासवर्ड रीसेट आपका बैकएंड भेजता है, कोई व्यक्ति टाइप नहीं करता।
भेजने के बाद कुछ लौटकर नहीं आता
ग्राहक कहता है कि कोड आया ही नहीं, और जाँचने के लिए पहुँचने का कोई रिकॉर्ड नहीं है।
एक साझा कुंजी, कॉल का कोई रिकॉर्ड नहीं
हर सेवा उसी एक गुप्त कुंजी से भेजती है, और कुछ नहीं बताता कि कौन-सी कॉल कब नाकाम हुई।
यह कैसे काम करता है
चार कदमों में चालू।
- 01
अपना डोमेन सत्यापित करें
सेटिंग्स में दिखाए गए रिकॉर्ड प्रकाशित करें, और सब मिल जाने पर डोमेन हरा हो जाता है।
- 02
सीमित दायरे वाली कुंजी जारी करें
कुंजी को उन्हीं पतों और डोमेन तक सीमित रखें जिनसे वह भेज सकती है, और भूमिका से तय करें कि वह कहाँ तक पहुँचे।
- 03
संदेश पोस्ट करें
एक कॉल में टेम्पलेट, उसकी वैल्यू और पाने वाला तय होता है, और दोबारा कोशिश करने पर भी वह दो बार नहीं जाता।
- 04
webhook लें, लॉग पढ़ें
आपका एंडपॉइंट हर घटना संदेश id के साथ सुनता है, और लॉग बताता है कि मेल पहुँचा, बाउंस हुआ या नाकाम रहा।
यह किस पर चलता है
काम करने वाले हिस्से।
यह दस्तावेज़ों वाले API, दायरे में बाँधी जा सकने वाली कुंजियों, टाइप वाले SDK, आपके एंडपॉइंट पर webhook, वर्शन वाले टेम्पलेट, और आपके भेजने वाले डोमेन के पीछे खड़े रिकॉर्ड पर चलता है।
एक दस्तावेज़ीकृत HTTP API, ऐसी कुंजियों के साथ जो जारी, सीमित और रद्द की जा सकती हैं।
पहले एक TypeScript क्लाइंट, फिर बाक़ी।
मेल आते ही आपके एंडपॉइंट को बता दें, आपसे बार-बार पुछवाने के बजाय।
एक बार लिखा गया मुख्य भाग, संस्करणों में रखा और कई बार भेजा: कंपोज़र से, आपके अपने कोड से, या किसी एजेंट से।
प्रेषक के बग़ल में एक चिह्न, जब भेजने वाले डोमेन के प्रकाशित रिकॉर्ड मेल खाते हैं।
शुरुआती p=none रिकॉर्ड, कॉपी करने के लिए छापा गया या सिंक से लिखा गया, आपके लिए कभी सख़्त नहीं किया जाता।
v=DMARC1; p=none; rua=…
व्यवहार में
हर हिस्सा, कदम दर कदम।
चार छोटे पेज पूरा रास्ता दिखाते हैं: अपने कोड से भेजना, कॉल लॉग पढ़ना, भेजने के बाद क्या हुआ, और टेस्ट रन के अंदर मेल, जो अभी आना बाकी है।
अपने कोड से रसीदें, कोड और रीसेट लिंक भेजें, और पहुँचने पर खबर पाएँ।
किसी कुंजी की हर कॉल, भेजा गया हर वेबहुक, कोड और समय के साथ।
हर टेस्ट रन को अपना पता दें और उसे मिला मेल पढ़ें।
सवाल
साइन अप से पहले पूछे गए।
दोबारा कोशिश करने पर वही ईमेल दो बार जाने से क्या रोकता है?
एक कॉल में टेम्पलेट, उसकी वैल्यू और पाने वाला तय होता है, और उसी कॉल को दोहराने पर मेल दो बार नहीं जाता। कॉल के जवाब में संदेश id मिलती है, और आपके एंडपॉइंट पर आने वाली हर घटना वही id लिए रहती है।
क्या मैं देख सकता हूँ कि भेजने के बाद क्या हुआ?
हाँ। हर भेजा मेल पहुँचा, बाउंस हुआ, शिकायत हुई या नाकाम रहा, यह दिन, स्रोत और भेजने वाले पते के हिसाब से दिखता है, और रिक्वेस्ट लॉग में हर कॉल का मेथड, पाथ, स्टेटस कोड और अवधि रहती है।
क्या मेरी भाषा के लिए SDK है?
ज़्यादातर के लिए अभी नहीं। टाइप वाला क्लाइंट पहले TypeScript में है और बाकी बाद में आएँगे, इसलिए फ़िलहाल हर दूसरी भाषा दस्तावेज़ों वाले HTTP API को सीधे कॉल करती है।
आस-पास
उसी मेलबॉक्स के दूसरे काम।
हर टिकट, रिकॉर्ड या ग्राहक का अपना पता हो सकता है। वहाँ भेजा मेल साइन की हुई घटना बनकर आपके एंडपॉइंट तक पहुँचता है, और आपका कोड उसी पते से जवाब देता है।
एजेंट को उसका अपना पता दें और एक कुंजी, जिसका दायरा उतना ही हो जितना उसे करना है। वह पढ़ता है, लेबल लगाता है, ड्राफ़्ट बनाता है और भेजता है, और उसकी हर कॉल लॉग होती है।
