Sendgrid-nodejs: गतिशील टेम्पलेट समर्थन जोड़ें

कृपया अपना दस्तावेज़ अपडेट करें- मैंने यह पता लगाने की कोशिश में एक घंटा बिताया कि प्रतिस्थापन v3 API के साथ काम क्यों नहीं कर रहे थे।

खराब अनुभव @ झारिस-कोड के लिए मेरी माफ़ी।

मैंने इस मुद्दे को प्राथमिकता देने में मदद करने के लिए आपके वोट को इसमें जोड़ दिया है। मुझे लगता है कि इसे जल्द ही अपडेट किया जाएगा क्योंकि हमारे पास पीआर # 711 है।

यह बहुत ही मूर्खतापूर्ण बात है कि दस्तावेज़ीकरण की अनुपस्थिति वास्तविक कोड की रिलीज़ को अवरुद्ध करती है।

हाय @ कैटामफेटामाइन ,

कोड v6.3.1 में जारी किया गया था। मुझे आशा है कि यह मदद करता है, धन्यवाद!

शुभकामनाएं,

एल्मेरू

@ थिंकिंगसेरियस ओह, कूल, वास्तव में यह लाइब्रेरी के संस्करण को अपडेट करने के लिए मेरे दिमाग को पार नहीं कर पाया।
मैं इसे आजमाउंगा, thx।

उपयोगकर्ताओं के लिए नोट: टेम्प्लेट का उपयोग करते समय dynamic_template_data बजाय substitutions ।

अब आपको "प्रतिस्थापन:" को "dynamic_template_data:" में बदलना होगा

और टेम्प्लेट हैंडलबार का उपयोग करते हैं और "प्रतिस्थापनवापर्स" निर्दिष्ट करने की आवश्यकता नहीं है

आपके उपयोग के मामलों में यह उदाहरण अभी भी dynamic_template_data के बजाय प्रतिस्थापन का उपयोग करता है। कृपया अपडेट करें, मुझे निश्चित रूप से एसडीके के साथ खेलने और इस धागे को खोजने से पहले खोज करने में कुछ घंटे लगे। (इसके अलावा आपके एपीआई दस्तावेज़ इस बारे में कुछ भी उल्लेख नहीं करते हैं, जिसने या तो मदद नहीं की है।
साथ ही, प्रतिस्थापनवापर्स गतिशील_टेम्पलेट_डेटा के साथ बिल्कुल भी काम नहीं कर रहे हैं। मेरे संदेश ऑब्जेक्ट में कुंजी मूल्य जोड़ी substitutionWrappers: ['*|', '|*'] को शामिल करने के बावजूद, केवल घुंघराले ब्रेसिज़ में लिपटे टेम्पलेट वर्र्स भरे गए थे। (क्या आप लोग जानबूझकर सभी को टेम्पलेट्स के लिए हैंडलबार सिंटैक्स का उपयोग करने के लिए मजबूर कर रहे हैं?)

मेरी क्षमायाचना @ जोश-योनोमी,

मैंने आपके फ़ीडबैक के आधार पर दस्तावेज़ीकरण को अपडेट कर दिया है।

हमारे नए टेम्प्लेट के लिए, वे हैंडलबार सिंटैक्स का उपयोग करते हैं। लीगेसी टेम्प्लेट अभी भी पहले की तरह काम करते हैं।

शुभकामनाएं,

एल्मेरू

मुझे ईमेल प्राप्त होता है लेकिन प्रतिस्थापन कार्य नहीं करता है। क्या समस्या पैदा कर सकता है?

const msg = {
    to: email,
    from: sendGridMail,
    templateId: emailTemplate.confirmationEmail,
    dynamic_template_data: {
      firstName: firstName,
      lastName: lastName,
      link: link
    }
  };

@ सोच के माध्यम से संपादित करें

क्या आपको हमें यह बताने में कोई आपत्ति है कि समस्या कहां है? हमें आपकी कुंठाओं को समझना अच्छा लगेगा ताकि हम सुधार कर सकें।

@ ड्राव 96 ,

क्या आप यह साझा करना चाहते हैं कि आपका टेम्प्लेट कैसा दिखता है?

शुभकामनाएं,

एल्मेरू

आप प्रतिस्थापन में विशेष वर्ण क्यों छीनते हैं ??

dynamic_template_data: {
      'foo-bar': 'wtf',
      'bar_baz': 'wtf',
      'baz.bro': 'wtf',
      'foo': 'wtf'
    }

केवल {{foo}} ईमेल में wtf स्ट्रिंग लौटाएं।

मुझे यकीन नहीं है @larafale , लेकिन यह निश्चित रूप से उचित नहीं लगता है। इस एसडीके के स्रोत कोड को देखते हुए, मैं नहीं देखता कि उन चाबियों को कहां संशोधित किया जा रहा है।

क्या आप इस मुद्दे के लिए एक अलग मुद्दा बनाना चाहते हैं और इसमें शामिल हैं कि आपका एचटीएमएल टेम्पलेट कैसा दिखता है? मैं नए मुद्दे को एक बग के रूप में चिह्नित करूंगा और यदि आवश्यक हो तो पुन: पेश करने और ठीक करने का प्रयास करूंगा।

नमस्ते,

इसलिए, मैं एक गतिशील टेम्पलेट ईमेल भेजने की कोशिश कर रहा हूं, हालांकि, मैं प्रतिस्थापन या dynamic_template_data का उपयोग करने में सक्षम नहीं हूं।
मेरे टेम्पलेट में {{fullname}} या {{date}} जैसे टैग हैं और ये गुण send फ़ंक्शन पर भेजे गए हैं:

const msg = {
        to,
        from,
        templateId: template.id,
        dynamic_template_data: substitutions,
    };

    return sgMail.send(msg)

मैंने पुष्टि की है कि substitutions ऑब्जेक्ट में सही मानों के साथ सही गुण हैं लेकिन प्रतिस्थापन काम नहीं करता है।

कोई आइडिया है कि मैं क्या गलत कर रहा हूँ?

धन्यवाद।

@ जियानफेलिप93
संरचना सही है। मुझे भी यही समस्या थी।
मेरा समाधान मेरे प्रोजेक्ट से @sendgrid पैकेज को अनइंस्टॉल करना और इसे फिर से इंस्टॉल करना था
अगर यह आप के लिए काम करता है तो मुझे बतलाएगा
const msg= { to: email, from: sendGridMail, templateId: emailTemplate.requestDemoEmail, dynamic_template_data: { name: data.name, email: data.email, } };

@drav96 धन्यवाद दोस्त, यह अब काम कर रहा है

इस पर अपना एक और घंटा बर्बाद करने के बाद मुझे जो उम्मीद है उसे जोड़ना कुछ

1. यदि आपकी टेम्प्लेट आईडी d- शुरू होती है, तो substitutions काम नहीं करेगा, और आपको CAMEL-CASE dynamicTemplateData उपयोग करना चाहिए ( यहां देखें, जहां वे सांप_केस कुंजियों को किसी भी तरह से कैमलकेस में परिवर्तित करते हैं) )
2. यदि आपका टेम्प्लेट d- शुरू होता है, तो setSubstitutionWrappers को चुपचाप अनदेखा कर दिया जाता है, और आपको अपने टेम्प्लेट में {{ और }} का उपयोग करना चाहिए

इस पर अपना एक और घंटा बर्बाद करने के बाद मुझे जो उम्मीद है उसे जोड़ना कुछ

1. यदि आपकी टेम्प्लेट आईडी d- शुरू होती है, तो substitutions काम नहीं करेगा, और आपको CAMEL-CASE dynamicTemplateData उपयोग करना चाहिए ( यहां देखें, जहां वे सांप_केस कुंजियों को किसी भी तरह से कैमलकेस में परिवर्तित करते हैं) )
2. यदि आपका टेम्प्लेट d- शुरू होता है, तो setSubstitutionWrappers को चुपचाप अनदेखा कर दिया जाता है, और आपको अपने टेम्प्लेट में {{ और }} का उपयोग करना चाहिए

मेरे मामले में यह dynamic_template_data साथ काम करता है, भले ही टेम्पलेट आईडी में अक्षर d-

हां, यह सांप के मामले की चाबियों के साथ काम करता है, लेकिन ऐसा प्रतीत होता है जैसे देवों ने ऊंट के मामले में आंतरिक रूप से प्रतिबद्ध किया है (ऊपर मेरी रिपोर्ट में मैंने जो लाइन लिंक की है उसे देखें)। इस प्रकार, मैं सभी नए कोड उपयोग ऊंट मामले की सिफारिश करूंगा।

हैलो @ केल-शिपमैन,

मदद करने के लिए समय निकालने के लिए धन्यवाद, हम इसकी बहुत सराहना करते हैं!

क्या आपको यह दस्तावेज़ीकरण देखने को मिला ? यदि नहीं, तो क्या आप अपनी खोज के उस पथ का वर्णन करना चाहेंगे जिसके कारण एक घंटा बर्बाद हुआ। मैं चाहूंगा कि ऐसा फिर कभी न हो और खराब अनुभव के लिए मैं क्षमा चाहता हूं।

शुभकामनाएं,

एल्मेरू

@ थिंकिंगसीरियस , आपकी समझ और स्थिति को सुधारने की इच्छा के लिए धन्यवाद। और वहां पर स्निपेट होने के लिए खेद है। एक loooooooooooooooong दिन था;)।

वैसे भी, समस्या इतनी नहीं है कि सही (ईश) दस्तावेज कहीं मौजूद है, यह है कि बहुत सारे पुराने दस्तावेज अभी भी Google खोजों में पकड़े गए हैं। मैंने "sendgrid टेम्प्लेट फ़ील्ड" (अभी-अभी) की खोज की और पहला गैर-विज्ञापन परिणाम यह है , जो सभी संकेतों से आधिकारिक दस्तावेज़ीकरण है, लेकिन स्पष्ट रूप से पुराना है। इतना ही नहीं, बल्कि इसके दो अलग-अलग प्रतिस्थापन प्रारूप भी हैं ( -firstName- और %firstName% ) और केवल "आप जो उपयोग करते हैं वह आपके द्वारा उपयोग की जाने वाली एसडीके लाइब्रेरी पर निर्भर हो सकता है" कहता है, जो वास्तव में बंद लगता है, कि सभी एसडीके पुस्तकालय संभावित रूप से एक ही मंदिर को इंगित करेंगे (जिसमें प्रतिस्थापन टैग की केवल एक शैली है)।

प्रेषक के साथ मेरे अनुभव में, जबकि मैं जो बनाया गया है उसकी बहुत सराहना करता हूं, यह दस्तावेज़ीकरण भ्रम वास्तव में नियम है, अपवाद नहीं। मुझे पता है कि यह शायद उतना ही आगे बढ़ रहा है जितना कि बाकी सॉफ्टवेयर की दुनिया है, लेकिन सभी दस्तावेजों को सामान्य करने के लिए एक या एक महीने का समय लेना अच्छा होगा, इस पर संस्करण संख्याएं डालें, आदि, और शायद इसके बारे में कुछ करें शीर्ष गूगल हिट।

वैसे भी, फिर से धन्यवाद!

साथ ही, आपके द्वारा लिंक किया गया दस्तावेज़ अभी भी सांप के मामले में dynamic_template_data दिखाता है, और यदि यह सही है, तो मुझे यकीन नहीं है कि कोड स्वयं इसे कैमलकेस में क्यों परिवर्तित कर रहा है। जैसा कि ऊपर उल्लेख किया गया है, मैं मानता हूं कि सांप का मामला काम करता है, लेकिन कोड को देखते हुए, ऐसा नहीं लगता कि प्रलेखन को इसका उपयोग करने की सिफारिश करनी चाहिए।

हैलो @ केल-शिपमैन,

विस्तृत प्रतिक्रिया देने के लिए समय निकालने के लिए धन्यवाद!

आपके द्वारा प्रदान किए गए लिंक के संबंध में, वह दस्तावेज़ीकरण हमारे SendGrid SMTP API के संदर्भ में है, न कि SendGrid v3 REST API जिसका यह SDK समर्थन करता है। उस ने कहा, आपसे यह जानने की उम्मीद नहीं की जानी चाहिए। यह देखने के लिए कि क्या इसे स्पष्ट करने का कोई तरीका है, मैं इस मुद्दे को हमारी दस्तावेज़ीकरण टीम के ध्यान में लाऊंगा।

हमने अभी हाल ही में अपने ओपन सोर्स दस्तावेज़ों को अद्यतन और

मैं संगतता के लिए कैमलकेस का उपयोग करने के लिए रीडमे को ठीक कर दूंगा। इसे पकड़ने और इसे हमारे ध्यान में लाने के लिए धन्यवाद!

फिर से धन्यवाद और आपकी विस्तृत प्रतिक्रिया के लिए हमारी प्रशंसा के प्रतीक के रूप में, हम आपको कुछ स्वैग की पेशकश करना चाहते हैं। आनंद लेना!

शुभकामनाएं,

एल्मेरू

अरे मस्त, धन्यवाद :D

मंगलवार, 18 सितंबर, 2018 को शाम 6:09 बजे एल्मर थॉमस नोटिफिकेशन @github.com
लिखा था:

हैलो @ केल-शिपमैन https://github.com/kael-shipman ,

विस्तृत प्रतिक्रिया देने के लिए समय निकालने के लिए धन्यवाद!

आपके द्वारा प्रदान किए गए लिंक के संबंध में, वह दस्तावेज़ीकरण संदर्भ में है
हमारे सेंडग्रिड एसएमटीपी एपीआई के लिए, न कि सेंडग्रिड v3 आरईएसटी एपीआई जो यह एसडीके
समर्थन करता है। उस ने कहा, आपसे यह जानने की उम्मीद नहीं की जानी चाहिए। मैं ले आऊंगा
इस मुद्दे को हमारी दस्तावेज़ीकरण टीम के ध्यान में यह देखने के लिए कि क्या कोई है
इसे स्पष्ट करने का तरीका।

हमने अभी हाल ही में अपने खुले स्रोत वाले दस्तावेज़ों को अद्यतन और पुन: लॉन्च किया है
https://sendgrid.com/blog/how-to-get-the-most-from-sendgrids-new-knowledge-center/ ।
मुझे आशा है कि आपको नेविगेट करना आसान लगेगा।

मैं संगतता के लिए कैमलकेस का उपयोग करने के लिए रीडमे को ठीक कर दूंगा। शुकि्रया
इसे पकड़ना और इसे हमारे ध्यान में लाना!

फिर से धन्यवाद और आपके विस्तृत विवरण के लिए हमारी प्रशंसा के प्रतीक के रूप में
प्रतिक्रिया, हम आपको कुछ स्वैग की पेशकश करना चाहेंगे
https://dx.sendgrid.com/swag । आनंद लेना!

शुभकामनाएं,

एल्मेरू

-
आप इसे प्राप्त कर रहे हैं क्योंकि आपका उल्लेख किया गया था।
इस ईमेल का सीधे उत्तर दें, इसे GitHub पर देखें
https://github.com/sendgrid/sendgrid-nodejs/issues/703#issuecomment-422588492 ,
या थ्रेड को म्यूट करें
https://github.com/notifications/unsubscribe-auth/ADUIglZIH2d7imy-H7dekTo5A-v2Xau8ks5ucX0agaJpZM4Vev8b
.

मैं सामान्य ईमेल चर के लिए काम करने के लिए dynamic_template_data प्राप्त करने में सक्षम हूं, लेकिन क्या होगा यदि हमें प्रति प्राप्तकर्ता गतिशील डेटा भी जोड़ने की आवश्यकता है? जैसे ऑर्डर नंबर, ऑर्डर मात्रा, इत्यादि। मुझे दस्तावेज़ों में इसके लिए उपयोग केस नहीं दिख रहा है, लेकिन शायद मैं इसे देख रहा हूं।

उपयोगकर्ताओं के लिए नोट: टेम्प्लेट का उपयोग करते समय dynamic_template_data बजाय substitutions ।

@catamphetamine दुर्भाग्य से, मैंने आपकी टिप्पणी को कम कर दिया है क्योंकि मैंने अभी यह पता लगाने में बहुत समय बिताया है कि हर किसी का कोड dynamicTemplateData साथ क्यों काम कर रहा है, लेकिन मेरे मामले में प्रतिस्थापन बस हटा दिए जाते हैं। मुझे उम्मीद है कि दूसरों के पास बेहतर अनुभव होगा।

मेरा संस्करण:
"@sendgrid/mail": "^6.3.1"

पता चला कि मेरे लिए मुझे निम्नलिखित करना था (लोग जो कहते हैं उसके विपरीत):

// This seems to be the default, however, to avoid unexpected API changes,
// I'd rather set this manually
setSubstitutionWrappers("{{", "}}");

{
      subject: EMAIL_SUBJECT_ONBOARDING,
      templateId: "templateId",
      personalizations: [{
        to,
        // NOT WORKING WITH THIS ❌
        // dynamicTemplateData: {
        //   senderName: EMAIL_FROM_NAME,
        //   senderAddress: "an actual adress",
        // },

        // WORKS WITH THIS ✅
        substitutions: {
            senderName: EMAIL_FROM_NAME,
            senderAddress: "an actual adress",
        },
    }],
}

@ थिंकिंगसीरियस टूल से प्यार है। कृपया डॉक्स में सुधार करना जारी रखें, एज-केस आदि को कवर करें। ❤️

अपडेट करें:

@catamphetamine डाउनवोट के लिए धन्यवाद। यह मुझे सोच रहा था कि substitutions काम कर सकता है क्योंकि मैंने setSubstitutionWrappers("{{", "}}"); । काश, नहीं। मुझे नहीं पता कि क्या हुआ मैं थक गया हो सकता है, लेकिन dynamicTemplateData काम करता है । ध्यान दें, कि यह कैमलकेस _(@ kael-shipman comment देखें)_ मैं सांप के मामले के अधिकांश उदाहरण देखता हूं। साथ ही, मैं प्रेषक के लिए टीएस प्रकारों का उपयोग कर रहा हूं। परिभाषा में कोई स्नेक_केस कुंजी उपलब्ध नहीं है।

अद्यतन २:

उपलब्ध प्रकारों के संबंध में। मुझे dynamic_template_data PersonalizationJSON प्रकार में मिला। यदि आप निम्न का उपयोग करते हैं:
import { send } from "@sendgrid/mail";
फिर भेजने के लिए पहले परम की जाँच करने के बाद आपको MailData दिखाई देगा जिसकी निम्नलिखित परिभाषा है:

export interface MailData {
  // ...
  personalizations?: PersonalizationData[],
  // ...
}

तब मैं निम्नलिखित 2 प्रकारों पर ठोकर खाता हूं:

export interface PersonalizationData {
  // omitted keys...
  dynamicTemplateData?: { [key: string]: string; };
  customArgs?: { [key: string]: string };
  sendAt?: number;
}

export interface PersonalizationJSON {
  // same omitted keys...
  dynamic_template_data?: { [key: string]: string; };
  custom_args?: { [key: string]: string; };
  send_at?: number;
}

अंत में, मुझे लगातार काम करने के लिए dynamic_template_data है:

{
    templateId: "d-templateId",
    dynamic_template_data: { name: "elton yet again"}, // <-- either here
    personalizations: [{
        to,
        dynamic_template_data: { name: "Elton again" }, // <-- or here
    }],
}

@ थिंकिंगसीरियस स्पष्ट रूप से, टाइप डेफिनिशन मुद्दे हैं जिन्हें ठीक करने की आवश्यकता है। मैं बाद में पीआर बना सकता हूं।

ठीक है, मुझे फिर से जांच करने की ज़रूरत है। मैं स्तब्ध हूं क्योंकि अब न तो dynamicTemplateData और न ही substitutions मेरे लिए काम करता है।

अपडेट करें:
कुछ तालिकाओं को फ़्लिप किया, लेकिन इसे काम करने के लिए मिला और मेरी पिछली टिप्पणी अपडेट की।

अंत में, मुझे लगातार काम करने के लिए dynamic_template_data है:

{
    templateId: "d-templateId",
    dynamic_template_data: { name: "elton yet again"}, // <-- either here
    personalizations: [{
        to,
        dynamic_template_data: { name: "Elton again" }, // <-- or here
    }],
}

यह मेरे लिए एक महत्वपूर्ण बिंदु था। मैं बनाम सीसी ईमेल के लिए अलग-अलग लेनदेन टेम्पलेट में विषय सेट करने का प्रयास कर रहा था। यह तब काम करता था जब मैंने ऊपर के अनुसार वैयक्तिकरण सरणी के अंदर dynamic_template_data गुण रखा था।

    const msg = {


         personalizations: [
            {
              to: req.body.to,
              dynamic_template_data : {
                subject: "Just to adsf...",
                full_name_from: req.body.full_name_from,
                full_name_to: req.body.full_name_to,
                manager: req.body.manager,
                message: req.body.message,
                badge: req.body.badge,
                badge_image: 'https://asdf' + req.body.badge_image
             }
            },
            {
              to: req.body.manager,
              dynamic_template_data : {
                subject: req.body.full_name_from + ' received a asdf asdf',
                full_name_from: req.body.full_name_from,
                full_name_to: req.body.full_name_to,
                manager: req.body.manager,
                message: req.body.message,
                badge: req.body.badge,
                badge_image: 'https://asdf' + req.body.badge_image
             }
            }
          ]
    };

मेरे लिए काम करने वाला समाधान डायनामिक_टेम्पलेट_डेटा को वैयक्तिकरण ऑब्जेक्ट के अंदर ठीक नीचे देखे गए तरीके से रख रहा है:

    "personalizations": [
        {
              "dynamic_template_data": {
            "fullname": "full Name",
            "useremail": ":[email protected]",
            "userphone": "56456",
            "usermsg": "tex fdsfgasdf t"
    },
            "to": [
                {
                    "email": "[email protected]"
                }
            ],
            "cc": [
                {
                    "email": "[email protected]"
                }
            ]
        }
]