वेबहुक के ज़रिए सबमिशन Slack पर भेजें
फ़ॉर्म के «डिलीवरी» टैब पर वेबहुक एंडपॉइंट जोड़ें, Slack संदेश का फ़ॉर्मैट चुनें और अपना इनकमिंग वेबहुक पता चिपकाएँ। यह पेलोड फ़ॉर्मैट है, नेटिव Slack इंटीग्रेशन नहीं।
यह पोस्ट मशीन द्वारा अनुवादित है। अंग्रेज़ी में मूल पोस्ट पढ़ें
फ़ॉर्म को जब भी कोई सबमिशन मिलता है, FormFlow Slack पर एक छोटा संदेश पोस्ट कर सकता है। वह यह वेबहुक एंडपॉइंट के ज़रिए करता है, यानी उसी व्यवस्था से जो सबमिशन को आपके किसी भी URL पर आगे भेजती है। यह नेटिव Slack इंटीग्रेशन नहीं है: इंस्टॉल करने के लिए कोई Slack ऐप नहीं है, Slack से साइन-इन नहीं है और चैनल चुनने की सुविधा नहीं है। आप FormFlow को एक इनकमिंग वेबहुक पता देते हैं, और FormFlow उस पर Slack के रूप का संदेश भेजता है। यह ट्यूटोरियल इसे सेट करने के चरण बताता है और साफ़ कहता है कि संदेश में क्या होता है और क्या नहीं।
पहले आपको क्या चाहिए
आपकी टीम का एक फ़ॉर्म जिसे आप संपादित कर सकते हैं।
आपके स्वामित्व वाला इनकमिंग वेबहुक पता: आपके Slack वर्कस्पेस का इनकमिंग वेबहुक URL, या आपके किसी भी एंडपॉइंट का पता जो Slack का संदेश फ़ॉर्मैट स्वीकार करता हो। इसे Slack के अपने दस्तावेज़ों का पालन करके Slack में बनाएँ; यह पोस्ट उस पक्ष को कवर नहीं करती।
एक https पता। FormFlow वेबहुक एंडपॉइंट के लिए सादा http अस्वीकार करता है।
एंडपॉइंट जोड़ें
फ़ॉर्म खोलें और उसके «डिलीवरी» टैब पर जाएँ।
«वेबहुक एंडपॉइंट» खोजें और «एंडपॉइंट जोड़ें» चुनें।
«के रूप में भेजें» नाम के फ़ील्ड में «Slack संदेश» चुनें। डिफ़ॉल्ट «FormFlow JSON (हस्ताक्षरित)» है, इसलिए यही बदलाव Slack एंडपॉइंट और सादे वेबहुक के बीच का पूरा अंतर है।
URL फ़ील्ड का नाम अब «इनकमिंग वेबहुक यूआरएल» है। अपना पता उसमें चिपकाइएँ। टाइप करते समय फ़ील्ड छिपा रहता है, और आप जो चिपकाया है उसे जाँचने के लिए उसे दिखा सकते हैं।
«डिलीवर किया जा रहा है» को चालू रहने दें। यह डिफ़ॉल्ट रूप से चालू होता है; इस एंडपॉइंट पर डिलीवरी रोकने के लिए इसे बंद करें।
फ़ॉर्म सहेजें।
«के रूप में भेजें» के नीचे का सहायक पाठ बताता है कि पता एन्क्रिप्टेड रूप में सहेजा जाता है और ईमेल से कभी वापस नहीं भेजा जाता। एंडपॉइंट की सिमटी हुई पंक्ति पता छापने के बजाय फ़ॉर्मैट का नाम बताती है, ताकि URL पूरे पेज पर सादे पाठ में न दिखे।
टेस्ट भेजें
हर एंडपॉइंट पंक्ति में «परीक्षण भेजें» कार्रवाई है। यह पंक्ति के पते पर एक ही पंक्ति पोस्ट करती है, «FormFlow test — submissions from this form will arrive here.» सफल होने पर आपको «परीक्षण डिलीवर किया गया» दिखता है; विफल होने पर «परीक्षण डिलीवरी विफल रही» दिखता है, साथ में प्राप्तकर्ता का अपना त्रुटि-पाठ, जो 300 अक्षरों पर काट दिया जाता है।
दो शर्तें लागू होती हैं। पहले फ़ॉर्म सहेजें: जो एंडपॉइंट कभी सहेजा नहीं गया उसका परीक्षण नहीं हो सकता, और कार्रवाई आपको यह बता देती है। और हर व्यक्ति एक घंटे में 20 परीक्षण डिलीवरी भेज सकता है, विफल हुई डिलीवरी गिनकर। परीक्षण एक बटन है, कोई द्वार नहीं; आपने उसे दबाया हो या नहीं, एंडपॉइंट डिलीवर करता है।
चैनल में क्या पहुँचता है
संदेश एक दरवाज़े की घंटी है, रिकॉर्ड नहीं। इसमें होता है:
बोल्ड में पहली पंक्ति: «New submission — » और उसके बाद फ़ॉर्म का नाम।
अधिकतम पाँच उत्तर, हर पंक्ति में एक, हर एक बोल्ड लेबल और एक मान के रूप में। मान 200 अक्षरों पर काट दिया जाता है।
एक पंक्ति जो बताती है कि और कितने फ़ील्ड हैं, जब फ़ॉर्म में पाँच से ज़्यादा हों।
आपके डैशबोर्ड में सबमिशन का «View submission» लिंक।
मान के भीतर की खाली जगह समेट दी जाती है, इसलिए मान केवल एक पंक्ति का ही हो सकता है। वर्ण &, < और > को एस्केप किया जाता है ताकि Slack सबमिटर के पाठ को मार्कअप न समझे, और मान में तारे (*) को मिलते-जुलते वर्ण से बदल दिया जाता है ताकि सबमिटर बोल्ड लेबल की नकल न कर सके। संदेश केवल सादा पाठ है; यह Slack के Block Kit का उपयोग नहीं करता।
जानने लायक सीमाएँ
एकतरफ़ा। FormFlow भेजता है; Slack में कुछ भी FormFlow तक वापस नहीं आता।
अधिकतम पाँच उत्तर, हर एक 200 अक्षर का। पूरा सबमिशन देखने के लिए लिंक या सबमिशन इनबॉक्स का उपयोग करें।
Slack हस्ताक्षर को अनदेखा करता है। हर वेबहुक फ़ॉर्मैट हस्ताक्षरित होता है, लेकिन Slack हस्ताक्षर वाला हेडर छोड़ देता है, इसलिए Slack एंडपॉइंट के लिए कॉपी करने लायक कोई हस्ताक्षर-गुप्त कुंजी नहीं है।
जिन सबमिशन को FormFlow स्पैम मानता है, उन्हें आगे नहीं भेजा जाता। केवल स्वीकार किए गए, गैर-स्पैम सबमिशन ही वेबहुक एंडपॉइंट तक पहुँचते हैं।
पुनः प्रयास, बैकऑफ़ और निष्क्रियकरण सभी वेबहुक फ़ॉर्मैट में साझा हैं। जो प्राप्तकर्ता बार-बार विफल होता रहे, उसका एंडपॉइंट निष्क्रिय किया जा सकता है, इसलिए संदेश आना बंद हो जाएँ तो पंक्ति जाँचें।
पता एक क्रेडेंशियल है। जिसके पास भी Slack इनकमिंग वेबहुक URL है, वह उस चैनल में पोस्ट कर सकता है। इसे पासवर्ड की तरह मानें, और लीक होने पर Slack में उसे बदल दें।
यह क्या तय नहीं करता
यह आपका चैनल नहीं चुनता, और आपके लिए Slack का प्रबंधन नहीं करता: आप जो पता चिपकाते हैं वही तय करता है कि संदेश कहाँ पहुँचेंगे, और वह Slack में कॉन्फ़िगर होता है। यह Slack को आपका इनबॉक्स नहीं बना देता; सबमिशन पढ़ना, खोजना और निर्यात करना FormFlow में ही रहता है। और यह Slack संदेश को डेटा की प्रति नहीं बनाता। अगर आपको हर फ़ील्ड संरचित डेटा के रूप में चाहिए, तो इसके बजाय डिफ़ॉल्ट FormFlow JSON फ़ॉर्मैट वाला दूसरा एंडपॉइंट जोड़ें।