সরাসরি মূল কন্টেন্টে যান
FormFlow

ওয়েবহুকের মাধ্যমে সাবমিশন Slack-এ পাঠান

ফর্মের «ডেলিভারি» ট্যাবে ওয়েবহুক এন্ডপয়েন্ট যোগ করুন, Slack বার্তার ফরম্যাট বেছে নিন এবং আপনার মালিকানাধীন ইনকামিং ওয়েবহুক ঠিকানা বসান। এটি একটি পেলোড ফরম্যাট, নেটিভ Slack ইন্টিগ্রেশন নয়।

এই পোস্টটি যন্ত্রের মাধ্যমে অনুবাদ করা হয়েছে। ইংরেজিতে মূল পোস্টটি পড়ুন

A dark plate titled 'Send Submissions to Slack through a webhook', listing a webhook endpoint on the Delivery tab, a Slack-shaped message payload, and a receiver address you own.

ফর্ম কোনো সাবমিশন পেলেই FormFlow Slack-এ একটি ছোট বার্তা পোস্ট করতে পারে। এটি করে ওয়েবহুক এন্ডপয়েন্টের মাধ্যমে, অর্থাৎ যে ব্যবস্থায় সাবমিশন আপনার মালিকানাধীন যেকোনো URL-এ ফরওয়ার্ড হয়। এটি নেটিভ Slack ইন্টিগ্রেশন নয়: ইনস্টল করার মতো কোনো Slack অ্যাপ নেই, Slack দিয়ে সাইন-ইন নেই এবং চ্যানেল বাছাইয়ের ব্যবস্থা নেই। আপনি FormFlow-কে একটি ইনকামিং ওয়েবহুক ঠিকানা দেন, আর FormFlow সেখানে Slack-আকৃতির একটি বার্তা পাঠায়। এই টিউটোরিয়ালে তা সেট করার ধাপ দেখানো হয়েছে এবং বার্তায় কী থাকে ও কী থাকে না, তা স্পষ্ট করে বলা হয়েছে।

প্রথমে যা লাগবে

  • আপনার টিমের একটি ফর্ম, যা আপনি সম্পাদনা করতে পারেন।

  • আপনার মালিকানাধীন একটি ইনকামিং ওয়েবহুক ঠিকানা: আপনার Slack ওয়ার্কস্পেসের ইনকামিং ওয়েবহুক URL, অথবা আপনার যেকোনো এন্ডপয়েন্টের ঠিকানা যা Slack-এর বার্তা ফরম্যাট গ্রহণ করে। Slack-এর নিজস্ব ডকুমেন্টেশন অনুসরণ করে এটি Slack-এ তৈরি করুন; এই লেখায় সেই দিকটি আলোচনা করা হয়নি।

  • একটি https ঠিকানা। ওয়েবহুক এন্ডপয়েন্টের জন্য FormFlow সাধারণ http প্রত্যাখ্যান করে।

এন্ডপয়েন্ট যোগ করুন

  1. ফর্ম খুলে তার «ডেলিভারি» ট্যাবে যান।

  2. «ওয়েবহুক এন্ডপয়েন্টসমূহ» খুঁজে «এন্ডপয়েন্ট যোগ করুন» বেছে নিন।

  3. «যে নামে পাঠানো হবে» লেবেলের ফিল্ডে «Slack বার্তা» বেছে নিন। ডিফল্ট হলো «FormFlow JSON (স্বাক্ষরিত)», তাই এই পরিবর্তনটিই Slack এন্ডপয়েন্ট ও সাধারণ ওয়েবহুকের মধ্যে পুরো পার্থক্য।

  4. URL ফিল্ডের লেবেল এখন «ইনকামিং ওয়েবহুক URL»। আপনার ঠিকানা তাতে বসান। টাইপ করার সময় ফিল্ডটি আড়াল করা থাকে, আর যা বসিয়েছেন তা যাচাই করতে আপনি সেটি দেখাতে পারেন।

  5. «ডেলিভার করা হচ্ছে» চালু রাখুন। এটি ডিফল্টভাবে চালু থাকে; এই এন্ডপয়েন্টে ডেলিভারি বন্ধ করতে এটি বন্ধ করুন।

  6. ফর্মটি সংরক্ষণ করুন।

«যে নামে পাঠানো হবে»-এর নিচের সহায়ক লেখায় বলা আছে যে ঠিকানাটি এনক্রিপ্টেড অবস্থায় সংরক্ষিত থাকে এবং ইমেইলে কখনো ফেরত পাঠানো হয় না। এন্ডপয়েন্টের গুটিয়ে রাখা সারিতে ঠিকানা ছাপানোর বদলে ফরম্যাটের নাম দেখানো হয়, যাতে 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 ফরম্যাটের দ্বিতীয় একটি এন্ডপয়েন্ট যোগ করুন।