सबमिशन को Microsoft Teams या Discord चैनल में पोस्ट करें
फ़ॉर्म के डिलीवरी टैब में वेबहुक एंडपॉइंट जोड़ें, «Teams संदेश» या «Discord संदेश» चुनें और अपनी मालिकाना वेबहुक URL पेस्ट करें। यह एक पेलोड फ़ॉर्मैट है, Teams या Discord के साथ नेटिव इंटीग्रेशन नहीं।
यह पोस्ट मशीन द्वारा अनुवादित है। अंग्रेज़ी में मूल पोस्ट पढ़ें
जब भी किसी फ़ॉर्म को सबमिशन मिलता है, FormFlow Microsoft Teams या Discord चैनल में एक छोटा संदेश पोस्ट कर सकता है। यह वेबहुक एंडपॉइंट के ज़रिए होता है, यानी उसी तरीक़े से जो सबमिशन को आपके किसी भी URL पर आगे भेजता है; फ़र्क़ सिर्फ़ «के रूप में भेजें» के चुनाव का है। यह Teams या Discord का नेटिव इंटीग्रेशन नहीं है: इंस्टॉल करने के लिए कोई ऐप नहीं है और चैनल चुनने की सुविधा भी नहीं। आप एक वेबहुक पता पेस्ट करते हैं, और FormFlow उस पर उस सेवा के अनुरूप रूप में संदेश भेजता है। इसी सेटअप का Slack संस्करण वेबहुक के ज़रिए सबमिशन Slack पर भेजें में समझाया गया है। Teams और Discord के फ़ॉर्मैट एक साथ रिलीज़ v1.73.12 में आए।
पहले आपको क्या चाहिए
आपकी टीम का एक फ़ॉर्म जिसे आप संपादित कर सकते हैं।
Teams के लिए: टेम्पलेट "Post to a channel when a webhook request is received" से बना Teams वर्कफ़्लो, जिसमें "Who can trigger" को "Anyone" पर सेट किया गया हो। इसे Teams में Microsoft के अपने दस्तावेज़ों के अनुसार बनाएँ; यह लेख केवल FormFlow वाले हिस्से को कवर करता है।
Discord के लिए: आपके चैनल की «इंटीग्रेशन» सेटिंग से मिला वेबहुक URL। फ़ोरम और मीडिया चैनल समर्थित नहीं हैं।
एक https पता। FormFlow वेबहुक एंडपॉइंट के लिए सादा http स्वीकार नहीं करता।
एंडपॉइंट जोड़ें
फ़ॉर्म खोलें और उसके «डिलीवरी» टैब पर जाएँ।
«वेबहुक एंडपॉइंट» ढूँढें और «एंडपॉइंट जोड़ें» चुनें।
«के रूप में भेजें» नाम के फ़ील्ड में «Teams संदेश» या «Discord संदेश» चुनें। डिफ़ॉल्ट «FormFlow JSON (हस्ताक्षरित)» है, इसलिए यही चुनाव चैट एंडपॉइंट और सादे वेबहुक के बीच पूरा फ़र्क़ है।
URL फ़ील्ड का नाम अब «इनकमिंग वेबहुक यूआरएल» है। उसमें Teams वर्कफ़्लो का URL या Discord का वेबहुक URL पेस्ट करें। टाइप करते समय फ़ील्ड छिपा रहता है, और जो आपने पेस्ट किया उसे जाँचने के लिए आप उसे दिखा सकते हैं।
«डिलीवर किया जा रहा है» को चालू रहने दें। यह डिफ़ॉल्ट रूप से चालू होता है; इस एंडपॉइंट पर डिलीवरी रोकने के लिए इसे बंद करें।
फ़ॉर्म सहेजें।
«के रूप में भेजें» के नीचे का सहायक पाठ बताता है कि चुने हुए फ़ॉर्मैट के लिए कौन सा पता पेस्ट करना है, और यह भी कि पता एन्क्रिप्टेड रूप में सहेजा जाता है और कभी ईमेल से वापस नहीं भेजा जाता। एंडपॉइंट की सिमटी हुई पंक्ति पता दिखाने के बजाय फ़ॉर्मैट का नाम बताती है, ताकि URL पूरे पेज पर सादे पाठ में न दिखे।
एक परीक्षण भेजें
हर एंडपॉइंट पंक्ति में «परीक्षण भेजें» कार्रवाई होती है। यह पंक्ति के पते पर एक ही लाइन पोस्ट करती है, "FormFlow test — submissions from this form will arrive here.": Teams में कार्ड के रूप में, Discord में संदेश के रूप में। अनुरोध सफल हो तो आपको «परीक्षण डिलीवर किया गया।» दिखता है; विफल हो तो «परीक्षण डिलीवरी विफल रही।» दिखता है, साथ में प्राप्तकर्ता का अपना त्रुटि पाठ, जो 300 अक्षरों पर काट दिया जाता है।
Teams वर्कफ़्लो चलने से पहले ही अनुरोध स्वीकार कर लेता है, इसलिए «परीक्षण डिलीवर किया गया।» का मतलब है कि Teams ने अनुरोध ले लिया, यह नहीं कि कार्ड दिख गया। पहला परीक्षण भेजने के बाद चैनल देखें।
दो शर्तें लागू होती हैं। पहले फ़ॉर्म सहेजें: जो एंडपॉइंट कभी सहेजा नहीं गया उसका परीक्षण नहीं हो सकता, और कार्रवाई आपको यह बता देती है। और हर व्यक्ति प्रति घंटे 20 परीक्षण डिलीवरी भेज सकता है, विफल हुई भी गिनी जाती हैं। परीक्षण एक बटन है, रोक नहीं: आपने उसे दबाया हो या नहीं, एंडपॉइंट सबमिशन डिलीवर करता है।
चैनल में क्या पहुँचता है
संदेश एक दरवाज़े की घंटी है, रिकॉर्ड नहीं। दोनों फ़ॉर्मैट वही बातें उस सिंटैक्स में कहते हैं जिसे हर सेवा पढ़ती है: फ़ॉर्म का नाम, अधिकतम पाँच उत्तर, कितने फ़ील्ड छोड़े गए, और आपके पैनल में उस सबमिशन का लिंक।
Teams में
एक कार्ड जिसकी पहली लाइन "New submission — " और उसके बाद फ़ॉर्म का नाम है।
अधिकतम पाँच उत्तर, हर लाइन में एक, हर एक में बोल्ड लेबल और मान।
जब फ़ॉर्म में पाँच से ज़्यादा उत्तर हों तो "and 3 more fields" जैसी एक लाइन।
एक View submission बटन जो आपके पैनल में सबमिशन खोलता है।
हर उत्तर, लेबल और फ़ॉर्म का नाम सादे पाठ के रूप में भेजा जाता है। Teams किसी शीर्षक या तथ्यों की सूची में markdown को रेंडर कर देता, इसलिए FormFlow उनका उपयोग किसी ऐसी चीज़ के लिए नहीं करता जो सबमिट करने वाले ने लिखी हो: वह कार्ड में लिंक नहीं जोड़ सकता। कोई उल्लेख (मेंशन) भी कभी नहीं भेजा जाता, इसलिए उत्तर में <at> लिखने से किसी को सूचना नहीं जाती। लेबल, मान और फ़ॉर्म का नाम हर एक 200 अक्षरों पर काट दिया जाता है।
Discord में
बोल्ड पहली लाइन: "New submission — " और उसके बाद फ़ॉर्म का नाम।
अधिकतम पाँच उत्तर, हर लाइन में एक, हर एक में बोल्ड लेबल और मान।
जब फ़ॉर्म में पाँच से ज़्यादा उत्तर हों तो इटैलिक में "and 3 more fields" जैसी एक लाइन।
अंत में View submission लिंक, जो आपके पैनल में सबमिशन खोलता है।
उत्तर में markdown के चिह्नों को एस्केप कर दिया जाता है, इसलिए सबमिट करने वाला बोल्ड लेबल, शीर्षक, छिपा हुआ लिंक या कोड ब्लॉक नहीं बना सकता। संदेश Discord से कहता है कि कोई भी उल्लेख हल न करे, इसलिए @everyone वाला उत्तर किसी को सूचित नहीं करता, और वह लिंक प्रीव्यू न दिखाने को भी कहता है। Discord 2000 अक्षरों से लंबे संदेश को अस्वीकार कर देता है; FormFlow उस सीमा तक पहुँचने से पहले उत्तरों को छोटा कर देता है, इसलिए सबमिशन का लिंक बना रहता है। दो उत्तरों वाले फ़ॉर्म के लिए FormFlow यह पाठ भेजता है:
**New submission — Contact form**
**Name:** Ada Lovelace
**Message:** Can you send a quote
[View submission](<link to the Submission in your panel>)दोनों सेवाओं में मान के भीतर की ख़ाली जगहें समेट दी जाती हैं, इसलिए कोई मान हमेशा एक ही लाइन का होता है।
जानने लायक़ सीमाएँ
एकतरफ़ा। FormFlow भेजता है; Teams या Discord में जो कुछ होता है वह FormFlow तक वापस नहीं आता।
अधिकतम पाँच उत्तर, हर एक 200 अक्षर तक। पूरा सबमिशन देखने के लिए लिंक या सबमिशन इनबॉक्स का उपयोग करें।
Teams और Discord हस्ताक्षर को नज़रअंदाज़ करते हैं। हर वेबहुक फ़ॉर्मैट पर हस्ताक्षर होता है, लेकिन इनमें से कोई भी सेवा उसे जाँचती नहीं, इसलिए इन एंडपॉइंट के लिए कॉपी करने लायक़ कोई हस्ताक्षर सीक्रेट नहीं है।
जिन सबमिशन को FormFlow स्पैम मानता है, वे आगे नहीं भेजे जाते। वेबहुक एंडपॉइंट तक केवल स्वीकृत, ग़ैर-स्पैम सबमिशन पहुँचते हैं।
पुनः प्रयास, उनके बीच का इंतज़ार और निष्क्रियकरण सभी वेबहुक फ़ॉर्मैट में साझा हैं। जो प्राप्तकर्ता लगातार विफल होता रहे, उसका एंडपॉइंट निष्क्रिय किया जा सकता है, इसलिए संदेश आने बंद हों तो पंक्ति जाँचें।
Discord के फ़ोरम और मीडिया चैनल समर्थित नहीं हैं।
पता एक क्रेडेंशियल है। Teams वर्कफ़्लो का URL या Discord का वेबहुक URL जिसके पास भी हो, वह उस चैनल में पोस्ट कर सकता है। इसे पासवर्ड की तरह सँभालें, और लीक होने पर Teams या Discord में नया बनाएँ।
यह क्या तय नहीं करता
यह आपका चैनल नहीं चुनता, और आपके लिए Teams या Discord को नहीं सँभालता: आपका पेस्ट किया हुआ पता तय करता है कि संदेश कहाँ पहुँचेंगे, और वह सेवा में ही कॉन्फ़िगर होता है। यह चैट को आपका इनबॉक्स नहीं बनाता; सबमिशन पढ़ना, खोजना और एक्सपोर्ट करना FormFlow में ही रहता है। और यह संदेश को डेटा की प्रतिलिपि नहीं बनाता। अगर आपको हर फ़ील्ड संरचित डेटा के रूप में चाहिए, तो डिफ़ॉल्ट FormFlow JSON फ़ॉर्मैट वाला दूसरा एंडपॉइंट जोड़ें, जैसा सबमिशन को वेबहुक पर भेजें और जो आपका प्राप्तकर्ता चूक गया उसे दोबारा आज़माएँ में बताया गया है।