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

v1.75: সংরক্ষণ করে পরে শেষ করুন, UTM ফিল্ড ও দেশের নিয়ম

v1.75.0-এ বহু-ধাপের ফর্ম ৭ দিনের মধ্যে আবার শুরু করা যায়, এক ক্রিয়ায় UTM লুকানো ফিল্ড যোগ হয়, প্রতিটি সাবমিশনে সাবমিটারের দেশ দেখা যায় এবং অনুমতি ও ব্লকের নিয়ম মেলে, আর ম্যানেজমেন্ট API-এর টোকেন সাবমিশন আপডেট করতে পারে। এই পোস্টে প্রতিটি এন্ট্রি ও তার সীমা ব্যাখ্যা করা হয়েছে।

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

A dark plate titled 'v1.75: save and finish later, UTM fields and country rules', listing resuming a multi-step Form within 7 days, hidden UTM fields filled from the page address, the country shown per Submission with allow or block rules, and the Management API updating Submissions.

২৭ অক্টোবর ২০২৬-এ প্রকাশিত FormFlow v1.75.0-এ চারটি এন্ট্রি, সবগুলোই নতুন যোগ। এই পোস্টে প্রতিটি ও তার সীমা ব্যাখ্যা করা হয়েছে; এই রিলিজের অফিসিয়াল রেকর্ড হলো পরিবর্তনের তালিকায় v1.75.0। v1.75.1 ও v1.75.2 আলাদা প্যাচ রিলিজ, যাদের নিজস্ব এন্ট্রি পরিবর্তনের তালিকায় আছে; এই পোস্টে সেগুলো আলোচনা করা হয়নি।

বহু-ধাপের ফর্ম সংরক্ষণ করে পরে শেষ করতে দিন

ফর্মের “ফিল্ডসমূহ” ট্যাবে “ধাপগুলোর মাঝে উত্তর সংরক্ষণ করুন” চালু করুন। ফর্মে একাধিক ধাপ থাকলে তবেই সুইচটি দেখা যায়, আর এটি সব সাবস্ক্রিপশন প্ল্যানে আছে।

  • FormFlow-এর হোস্ট করা পেজে, অথবা “লাইভ রেন্ডারিং”সহ এমবেড করা ফর্মে এটি কাজ করে। বাস্তবে লিখা উত্তর প্রতিবার সংরক্ষিত হয়, যখন কেউ এক ধাপ থেকে আরেক ধাপে যায়।

  • মানুষটি ৭ দিনের মধ্যে একই ডিভাইসে ফিরে এসে যেখানে ছেড়েছিলেন সেখান থেকেই আবার শুরু করতে পারেন, অথবা “নতুন করে শুরু করুন” বেছে নিতে পারেন।

  • ফাইল কখনও সংরক্ষিত হয় না। একটি বিজ্ঞপ্তি মানুষকে জানায় যে তাদের উত্তর রাখা হচ্ছে: “আপনার উত্তর লেখার সাথে সাথে সংরক্ষিত হয়, যাতে আপনি পরে শেষ করতে পারেন।”, ফর্মটি সাবমিটারকে যে ভাষায় দেখানো হয় সেই ভাষায়।

  • সংরক্ষিত উত্তর এনক্রিপ্ট করা অবস্থায় রাখা হয়, তার পাশে কোনো IP ঠিকানা, অবস্থান বা ব্রাউজারের বিবরণ থাকে না।

  • এক ঘণ্টা সংরক্ষণ না হলে এন্ট্রিটি প্যানেলে “অসমাপ্ত”-এর অধীনে দেখা যায়, আর আপনার সামারিতে সেই মানুষদের হিসেবে যারা ফর্ম শুরু করেছে কিন্তু শেষ করেনি।

  • অসমাপ্ত এন্ট্রি আপনার ব্যবহারে কখনও গণনা হয় না, ডেলিভার বা এক্সপোর্ট করা হয় না। ফর্ম শেষ হলে, সর্বোচ্চ ৩০ দিন পর, অথবা ফর্মের সংরক্ষণ সময়কাল অনুযায়ী তার আগেই সেগুলো মুছে ফেলা হয়; সংরক্ষণ সময়কাল ব্যাখ্যা করে v1.18।

আপনার ফর্মে UTM প্যারামিটার ধরুন

বিল্ডারে “UTM ফিল্ড যোগ করুন” বেছে নিন, তাহলে utm_source, utm_medium, utm_campaign, utm_term ও utm_content-এর জন্য লুকানো ফিল্ড যোগ হয়। এমবেড করা ফর্ম এবং React, Vue, HTML ও Blade কমপোনেন্ট পেজের ঠিকানা থেকে যেকোনো খালি লুকানো ফিল্ড ভরে দেয়, তাই প্রতিটি সাবমিশন দেখায় কোন ক্যাম্পেইন তাকে এনেছে। এটি সব প্ল্যানে আছে।

  • ফর্মে যে কীগুলো এখনও নেই শুধু সেগুলোই যোগ করে; পাঁচটিই আগে থেকে থাকলে সেটা জানায় আর কিছু বদলায় না।

  • এটি ফিল্ড তালিকার সাধারণ সম্পাদনা: আপনি “সংরক্ষণ” চাপার আগে কিছুই সংরক্ষিত হয় না।

  • বহু-ধাপের ফর্মে লুকানো ফিল্ডগুলো প্রথম ধাপে যায়, কারণ লুকানো ফিল্ড সেখানেই থাকতে হয়।

লুকানো মান আপনার নিজে লেখা লিঙ্ক থেকেও আসতে পারে; দেখুন ফর্মকে তার লিঙ্ক থেকে আগে থেকে ভরে নিন ও ক্যাম্পেইনের উৎস সঙ্গে রাখুন।

প্রতিটি সাবমিটারের দেশ দেখুন, আর দেশগুলোকে অনুমতি দিন বা ব্লক করুন

এখন প্রতিটি সাবমিশন ইনবক্স, এক্সপোর্ট ও ম্যানেজমেন্ট API-এ সাবমিটারের দেশ দেখায়। FormFlow তা নিজের সার্ভারে IP ঠিকানা থেকে বের করে এবং শুধু দুই অক্ষরের দেশ কোড রাখে, ঠিকানা কখনও নয়। এজন্য FormFlow-এর সার্ভারে দেশের একটি ডেটাবেস ফাইল পড়া হয়, যা প্রতি মাসে হালনাগাদ করা হয়; সাবমিটারের কোনো তথ্য তার প্রকাশক DB-IP-কে পাঠানো হয় না।

ফর্মের “নিরাপত্তা” সেটিংসে একটি “দেশের নিয়ম”ও আছে: ডিফল্টে “সব দেশ গ্রহণ করুন”, অথবা “শুধু আমার বাছাই করা দেশগুলোকে অনুমতি দিন”, অথবা “আমার বাছাই করা দেশগুলোকে ব্লক করুন”। এটি সব প্ল্যানে আছে।

  • প্রত্যাখ্যাত সাবমিশন “প্রত্যাখ্যাত সাবমিশন”-এ থাকে, তাই আপনি তা পুনরুদ্ধার করতে পারেন।

  • যে সাবমিশনের দেশ জানা যায় না, তা সবসময় পার হয়ে যায়।

ম্যানেজমেন্ট API দিয়ে সাবমিশন আপডেট করুন

একটি API টোকেন এখন কোনো সাবমিশনকে সমাধান করা হয়েছে বা না, স্প্যাম বা স্প্যাম নয় চিহ্নিত করতে এবং তার ব্যর্থ ডেলিভারি আবার চেষ্টা করতে পারে, যেমন আপনি প্যানেলে করেন। এজন্য “submissions:write” অ্যাবিলিটি লাগে, আর এটি সব সাবস্ক্রিপশন প্ল্যানে আছে।

  • আপডেট: PATCH /api/v1/manage/submissions/{uuid}, বুলিয়ান মান read, handled ও spam-সহ। সাবমিশনের যে মান আগে থেকেই আছে তাতে কিছু বদলায় না।

  • “পড়া হয়েছে” চিহ্ন একমুখী। read: false পাঠালে HTTP 422 ও read_cannot_be_unset ত্রুটিসহ প্রত্যাখ্যাত হয়।

  • আবার চেষ্টা: POST /api/v1/manage/submissions/{uuid}/deliveries/retry, প্যানেল যে রিট্রাই ব্যবহার করে সেটিই, একবারের অনুরোধে সর্বোচ্চ ৫০০টি ডেলিভারি।

  • টোকেন নিজের ওয়েবহুকও (REST hooks) নিবন্ধন করতে পারে, POST /api/v1/manage/hooks দিয়ে, প্রতি ফর্মে সর্বোচ্চ ১০টি। একটি তৈরির জন্য “hooks:write” ও “submissions:read” অ্যাবিলিটি লাগে, কারণ হুক উত্তর বাইরে পাঠায়। টোকেন বাতিল বা মেয়াদোত্তীর্ণ হলে হুকটি সরিয়ে দেওয়া হয়, আর সেগুলোকে তালিকাভুক্ত করার কোনো এন্ডপয়েন্ট নেই।

আগে টোকেন দিয়ে পড়তে চাইলে দেখুন সীমাবদ্ধ অ্যাক্সেসের ম্যানেজমেন্ট API টোকেন দিয়ে সাবমিশন পড়ুন।

এই রিলিজ যা করে না

  • পুনরায় শুরু করা প্রতি ডিভাইস ও একাধিক ধাপের ফর্মে সীমাবদ্ধ, সাবস্ক্রিপশন প্ল্যানে। এটি ফাইল বহন করে না আর মানুষটিকে অন্য ডিভাইসে অনুসরণ করে না।

  • অসমাপ্ত এন্ট্রি সাবমিশন নয়: এটি কখনও ডেলিভার, এক্সপোর্ট বা গণনা হয় না, তাই ফর্ম শেষ না হওয়া পর্যন্ত কিছুই আপনার ওয়েবহুক বা এক্সপোর্টে পৌঁছায় না। আপনার সামারি তাকে শুধু সেই মানুষদের হিসেবে উল্লেখ করে যারা শুরু করেছে কিন্তু শেষ করেনি।

  • “UTM ফিল্ড যোগ করুন” পাঁচটি মানক কী যোগ করে এবং আর কিছু নয়, আর পেজের ঠিকানা শুধু সেই ফিল্ডগুলো ভরে যেগুলো এখনও খালি।

  • দেশের নিয়ম সাবমিটারের IP ঠিকানা থেকে বিচার করা হয়। কোনো দেশ বের করা না গেলে কিছু লেখা হয় না আর সাবমিশন গৃহীত হয়।

  • ম্যানেজমেন্ট API কোনো সাবমিশনকে “অপঠিত” চিহ্নিত করতে পারে না, আর টোকেন এই কাজগুলো শুধু তখনই করতে পারে যখন আপনি তাকে সেই অ্যাবিলিটি দিয়েছেন।

প্রতিটি এন্ট্রির পুরো পাঠ পরিবর্তনের তালিকায় v1.75.0-এর এন্ট্রিতে আছে।