n8n Error Workflow ব্যবহার: ব্যর্থতার অ্যালার্ট, প্রেক্ষাপট আর নিরাপদে আবার চালানো
n8n Error Workflow দিয়ে একটি কেন্দ্রীয় হ্যান্ডলার বানান: Error Trigger, Slack অ্যালার্ট, এক্সিকিউশন লিংক, গুরুত্ব অনুযায়ী ভাগ আর নিরাপদে আবার চালানোর নিয়ম।
n8n Error Workflow হলো আলাদা একটি হ্যান্ডলার ওয়ার্কফ্লো, যা মূল ওয়ার্কফ্লোর প্রোডাকশন এক্সিকিউশন ব্যর্থ হলে চালু হয় এবং আপনাকে খবর দেয়। হ্যান্ডলারটি Error Trigger নোড দিয়ে শুরু করতে হয়, তারপর মূল ওয়ার্কফ্লোর Settings থেকে সেটি বেছে দিতে হয়। একটি হ্যান্ডলার অনেক ওয়ার্কফ্লো ব্যবহার করতে পারে, তবে না দেখে আবার চালালে একই অর্ডার বা পেমেন্ট দুবার তৈরি হতে পারে।
এক নজরে
- নতুন ওয়ার্কফ্লোর প্রথম নোড হিসেবে Error Trigger রাখুন, Save করুন, তারপর মূল ওয়ার্কফ্লোর Options > Settings > Error workflow থেকে সেটি বেছে নিন।
- Error Trigger পায় ওয়ার্কফ্লোর নাম, ভুলের বার্তা, শেষ চলা নোড, আর এক্সিকিউশন সেভ হলে তার ID ও URL।
- ট্রিগার নোড চালু হতেই ব্যর্থ হলে পেলোড আলাদা হয়, তখন execution.id ও url নাও থাকতে পারে।
- Stop And Error দিয়ে ব্যবসার নিয়ম ভাঙলে ইচ্ছা করে ব্যর্থ করানো যায়, কিন্তু আবার চালানো শুধু এমন কাজে দিন যা দুবার চললেও ক্ষতি নেই।
- অ্যালার্টে কাস্টমারের ব্যক্তিগত তথ্য বা secret নয়, নিরাপদ রেফারেন্স আর এক্সিকিউশনের লিংক রাখুন।
n8n Error Workflow আসলে কোন ব্যর্থতা ধরে?
মূল ওয়ার্কফ্লোর কোনো এক্সিকিউশন ভুল দিয়ে শেষ হলে n8n আপনার ঠিক করে রাখা হ্যান্ডলার ওয়ার্কফ্লোটি চালায়, এটাই Error Workflow। কোনো নোডের সেটিংসে ভুল, বাইরের API সাড়া না দেওয়া, মেমোরির সমস্যা, কিংবা Stop And Error নোড দিয়ে ইচ্ছা করে ব্যর্থ করানো, এর সবই এখানে ধরা পড়ে। মনে রাখবেন, এটি ভুল লুকিয়ে ওয়ার্কফ্লো চালু রাখে না। ব্যর্থ হওয়ার পর সে আপনাকে জানায়, যাতে কেউ গিয়ে দেখতে পারে।
একটা সূক্ষ্ম জায়গা আছে। কোনো নোডের On Error সেটিং যদি ভুলটা গিলে ফেলে পরের ধাপে চলে যায়, তাহলে মূল এক্সিকিউশন ব্যর্থ হিসেবে গণ্য হয় না, আর কেন্দ্রীয় হ্যান্ডলারও তখন নাও চলতে পারে। তাই ডিজাইনের সময়ই ঠিক করে নিন কোন ভুল ওয়ার্কফ্লো নিজে সামলে নেবে, আর কোনটায় পুরো রান থেমে যাওয়া উচিত।
এই বিষয়টা হাতে-কলমে শিখতে চাইলে: AI অটোমেশন Masterclass (৳2,399)
আরেকটি বিষয় শুরুতেই জেনে রাখা ভালো। ক্যানভাসে হাতে চালানো টেস্ট আর আসল ট্রিগারে চলা রানের আচরণ এক নয়, আর Error Trigger হাতে চালানো এক্সিকিউশন থেকে চালু হয় না। তাই অ্যালার্ট পরীক্ষা করতে হবে আসল ট্রিগারের পথে। হ্যান্ডলারের জন্য আরেকটা হ্যান্ডলার, তার জন্য আরও একটা, এমন অন্তহীন শিকলও বানাবেন না। হ্যান্ডলারকে যতটা সম্ভব কম নির্ভরতায় রাখুন।
Error Workflow সেট করার ধাপগুলো কী?
প্রথমে Error Trigger দিয়ে শুরু হওয়া একটি হ্যান্ডলার বানিয়ে সেভ করুন, তারপর মূল ওয়ার্কফ্লোর সেটিংসে সেটি বেছে দিন। পুরো কাজটা পাঁচ ধাপে হয়:
- নতুন একটি ওয়ার্কফ্লো খুলে প্রথম নোড হিসেবে Error Trigger যোগ করুন।
- একটা চেনা নাম দিন, যেমন Ops Error Handler। অ্যালার্ট পাঠানোর আর কাকে পাঠানো হবে তা ঠিক করার নোডগুলো যোগ করে Save চাপুন।
- এবার মূল ওয়ার্কফ্লো খুলে Options > Settings-এ যান।
- Error workflow ঘরে সদ্য সেভ করা হ্যান্ডলারটি বেছে নিন।
- মূল ওয়ার্কফ্লো সেভ করে আসল ট্রিগারের মতো পরিবেশে নিয়ন্ত্রিতভাবে একটি ব্যর্থতা ঘটিয়ে দেখুন।
একটি হ্যান্ডলার অনেকগুলো ওয়ার্কফ্লোর সঙ্গে জুড়ে দেওয়া যায়। এতে অ্যালার্টের চেহারা, গুরুত্বের মাত্রা আর কে দায়িত্বে আছেন, এসবের নিয়ম এক জায়গায় থাকে। পুরো টিমের জন্য একটি হ্যান্ডলার রাখলে ওয়ার্কফ্লোর নাম দেখে দায়িত্বপ্রাপ্ত মানুষ খুঁজে বের করার একটা ছোট তালিকা রাখুন। তালিকায় নেই এমন ওয়ার্কফ্লোর অ্যালার্ট যেন চুপচাপ হারিয়ে না যায়, সেটি সাধারণ অপারেশনস চ্যানেলে পাঠিয়ে দিন।
Error Trigger কোন তথ্য হাতে পায়?
সাধারণ অবস্থায় Error Trigger পায় ওয়ার্কফ্লোর পরিচয় আর ব্যর্থ এক্সিকিউশনের বিবরণ: workflow.id, workflow.name আর একটি execution অবজেক্ট। এই অবজেক্টের ভেতরে সেভ হওয়া এক্সিকিউশনের ID ও URL, retryOf, ভুলের বার্তা, stack, lastNodeExecuted আর mode থাকতে পারে।
তবে ID আর URL পেতে হলে এক্সিকিউশনটি ডেটাবেসে সেভ হতে হয়। আবার মূল ওয়ার্কফ্লোর ট্রিগার নোড নিজেই যদি চালু হওয়ার সময় ব্যর্থ হয়, তাহলে স্বাভাবিক এক্সিকিউশন শুরুই হয় না। সে ক্ষেত্রে পেলোডে এক্সিকিউশনের বিবরণ কম থাকে, তার বদলে আসে trigger.error কাঠামো।
এর ব্যবহারিক মানে হলো, অ্যালার্টের এক্সপ্রেশন লেখার সময় ঐচ্ছিক ঘরগুলো সাবধানে পড়তে হবে। execution.url সবসময় থাকবে ধরে নিয়ে Slack বার্তা বানালে ট্রিগার চালুর ভুলের দিন হ্যান্ডলার নিজেই ভেঙে পড়বে। ঘরটি না থাকলে একটা বিকল্প লেখা বসিয়ে দিন।
ঢাকার অনলাইন দোকানে কুরিয়ার বুকিং ব্যর্থ হলে হ্যান্ডলার কী করে?
ধরা যাক ঢাকার কাল্পনিক দোকান MeghMart-এ পেমেন্ট হয়ে যাওয়া অর্ডার এলেই ওয়ার্কফ্লো কুরিয়ারে বুকিং দেয়। এক সন্ধ্যায় কুরিয়ারের API সময়মতো সাড়া দিল না। ডেটাবেসে অর্ডারটি পরিশোধিত দেখাচ্ছে, অথচ পার্সেল তৈরি হয়নি। অপারেশনসের কর্মীর তখন জানা দরকার কোন অর্ডার, কোন নোডে আটকেছে, এক্সিকিউশনের লিংক কোথায় আর কে দেখবেন। কাস্টমারের ফোন নম্বর বা পুরো ঠিকানা Slack-এ যাওয়ার কোনো দরকার নেই।
তাই মূল ওয়ার্কফ্লোতে বুকিংয়ের আগেই একটি পরিষ্কার রেফারেন্স তৈরি করা হলো: orderRef=MM-260184। কুরিয়ারের উত্তর সফল না হলে Stop And Error নোড বার্তা দিল COURIER_BOOKING_FAILED: MM-260184। হ্যান্ডলারে Error Trigger-এর পরে একটি Set নোড বার্তাটি এভাবে সাজাল:
Severity: HIGH | Workflow: [ওয়ার্কফ্লোর নাম] | শেষ নোড: [execution.lastNodeExecuted, না থাকলে trigger] | বার্তা: [execution.error.message] | এক্সিকিউশন: [execution.url, না থাকলে No saved URL] | করণীয়: আবার চালানোর আগে কুরিয়ার বুকিং ID খুঁজে দেখুন।
নিয়ম রাখা হলো, কুরিয়ার পোর্টালে অর্ডারের রেফারেন্স দিয়ে খোঁজার আগে কেউ রানটি আবার চালাবেন না। বুকিং পাওয়া গেলে শুধু মূল ডেটাবেস আপডেট হবে, নতুন বুকিং নয়। না পাওয়া গেলে ব্যর্থ এক্সিকিউশনের ইনপুট লোড করে আবার চালানো যাবে। এই ছোট যাচাইটুকুই একই অর্ডারের দুটো পার্সেল হওয়া ঠেকায়।
কোন অ্যালার্ট জরুরি আর কোনটা অপেক্ষা করতে পারে, সেটা কীভাবে ঠিক করবেন?
শুধু ভুলের বার্তার লেখা দেখে গুরুত্ব ঠিক করবেন না, ওয়ার্কফ্লোর নাম, নোডের নাম, সময় আর ব্যবসার প্রেক্ষাপট মিলিয়ে মাত্রা বসান। পেমেন্ট নেওয়া হয়েছে কি না অনিশ্চিত, ডুপ্লিকেটের ঝুঁকি আছে, কিংবা কাস্টমার সরাসরি ভুগছেন, এগুলো উচ্চ মাত্রার। প্রতিদিনের রিপোর্ট রিফ্রেশ মাঝারি, আর ডেভেলপমেন্টের টেস্ট নিম্ন মাত্রার। উচ্চ মাত্রার অ্যালার্ট ফোনে বা জরুরি চ্যানেলে যেতে পারে, মাঝারিগুলো টিকিটের সারিতে, আর বারবার আসা ছোট ভুল দিনের শেষে একটি সারাংশে।
একই ভুল যদি ৫০০টি আইটেমে ঘটে, ৫০০টি বার্তা পাঠাবেন না। ওয়ার্কফ্লো ID, নোড, ভুলের একটা নির্দিষ্ট কোড আর সময়ের পরিসর মিলিয়ে একটি পরিচয়চিহ্ন বানান, তারপর সেই অনুযায়ী অ্যালার্টগুলো একসঙ্গে করুন। প্রথমবার সঙ্গে সঙ্গে খবর যাক, পরেরবারগুলোতে শুধু সংখ্যা বাড়ুক। হ্যান্ডলারের নিজের কাছে স্থায়ীভাবে তথ্য রাখার জায়গা না থাকলে বাইরের একটি ঘটনার তালিকা বা টেবিল ব্যবহার করুন। একসঙ্গে করার সময় খেয়াল রাখুন, কাস্টমারের ক্ষতি করছে এমন গুরুতর ভুল যেন চাপা পড়ে না যায়।
Stop And Error নোড কখন কাজে লাগে?
নোড প্রযুক্তিগতভাবে সফল হলেও ব্যবসার শর্ত না মিললে Stop And Error দিয়ে ইচ্ছা করে এক্সিকিউশন ব্যর্থ করানো যায়। যেমন কুরিয়ারের API 200 ফেরত দিল কিন্তু বুকিং ID ফাঁকা, ইনভয়েসের মোট অঙ্ক ঋণাত্মক, কিংবা দরকারি অনুমোদন নেই। এতে কেন্দ্রীয় হ্যান্ডলার চালু হয় আর ব্যাপারটা কারও চোখে পড়ে। বার্তায় নিরাপদ রেফারেন্স আর কারণের কোড রাখুন। গোপন চাবি, পুরো পেলোড বা কাস্টমারের ব্যক্তিগত তথ্য সেখানে দেবেন না।
তবে প্রত্যাশিত প্রতিটি শাখাই সিস্টেমের ভুল নয়। স্টক না থাকলে কাস্টমারকে জানানোর একটি আলাদা শাখা থাকতেই পারে। যেখানে কোনো মৌলিক নিয়ম ভেঙেছে এবং মানুষের হাত লাগানো দরকার, শুধু সেখানেই ইচ্ছাকৃত ব্যর্থতা ব্যবহার করুন।
ব্যর্থ রান আবার চালানো কখন নিরাপদ?
যে কাজ শুধু তথ্য পড়ে, সেটা সাধারণত আবার চালানো নিরাপদ, কিন্তু অর্ডার তৈরি, SMS পাঠানো বা কার্ডে চার্জ করা নিরাপদ নয়। এখানে একটা ফাঁদ আছে। টাইমআউট মানেই অনুরোধ পৌঁছায়নি, তা নয়। হয়তো অনুরোধ পৌঁছেছে, শুধু উত্তরটা পথে হারিয়েছে। তখন না দেখে আবার চালালে দ্বিতীয় অর্ডার, দ্বিতীয় বার্তা বা দ্বিতীয় পেমেন্ট তৈরি হয়।
গাজীপুরের একজন পাইকারি বিক্রেতার কথা ভাবুন। তাঁর স্টক মেলানোর ওয়ার্কফ্লো সরবরাহকারীর API টাইমআউটে ব্যর্থ হলো, আর হ্যান্ডলার এক্সিকিউশনের লিংক, ব্যর্থ নোড ও পণ্যের SKU রেফারেন্স পাঠাল। আবার চালানোর আগে তিনি সরবরাহকারীর পোর্টালে দেখে নিলেন স্টক আগেই আপডেট হয়েছে কি না। না দেখে চালালে একই হিসাব দুবার বসে যেতে পারত।
বাইরের API যদি idempotency key সমর্থন করে, প্রতিবার একই স্থির ব্যবসায়িক চাবি পাঠান। আবার চালানোর আগে বাইরের সিস্টেমের অবস্থা দেখুন, আর সর্বোচ্চ কতবার চেষ্টা হবে, প্রতিবারের মাঝে কতটা বিরতি, শেষে কী হবে তা ঠিক করে রাখুন। আবার চালানো এক্সিকিউশনে execution.retryOf ঘর থাকতে পারে, তাই অ্যালার্টে মূল ব্যর্থতার লিংক দিন আর চেষ্টার সংখ্যা বাইরের কোথাও লিখে রাখুন। অন্তহীন লুপ চললে সরবরাহকারীর বিভ্রাট আরও খারাপ হয়।
অ্যালার্টে কোন তথ্য থাকবে আর কোনটা থাকবে না?
অ্যালার্টে থাকবে ওয়ার্কফ্লোর নাম, এক্সিকিউশন ID বা লিংক, সময়, ভুলের সংক্ষিপ্ত বিবরণ, বাইরের কেউ বুঝতে পারবে না এমন একটি ব্যবসায়িক রেফারেন্স, দায়িত্বপ্রাপ্ত মানুষ আর পরের করণীয়। কাস্টমারের পুরো তথ্য, গোপন চাবি বা authorization header কখনো Slack বা ইমেইলে দেবেন না। লিংকটি কে খুলতে পারবেন, তা নির্ভর করে এক্সিকিউশন সেভ করার নিয়ম আর ব্যবহারকারীর অনুমতির ওপর। Slack-এ বার্তার দৈর্ঘ্যের সীমা থাকলে পুরো stack trace না পাঠিয়ে শুধু লিংক দিন।
হ্যান্ডলার নিজেই ব্যর্থ হলে কী করবেন?
হ্যান্ডলার ব্যর্থ হলে মূল ব্যর্থতার খবরটাই হারিয়ে যেতে পারে, তাই একে ছোট আর মজবুত রাখুন। যেমন Slack-এর credential অচল হয়ে গেলে কোনো অ্যালার্টই আর পৌঁছাবে না।
- Error Trigger-এর পরে যত কম সম্ভব নোড রাখুন, আর ঐচ্ছিক ঘরগুলো নিরাপদ এক্সপ্রেশনে পড়ুন।
- প্রধান অ্যালার্ট মাধ্যম বন্ধ থাকলে দ্বিতীয় একটি চ্যানেল বা log streaming রাখুন।
- হ্যান্ডলারের credential কবে মেয়াদোত্তীর্ণ হবে তা নজরে রাখুন।
- হ্যান্ডলারকে তার নিজেরই Error workflow বানিয়ে পুনরাবৃত্তির ফাঁদ তৈরি করবেন না।
- হ্যান্ডলার ব্যর্থ হলে সেই এক্সিকিউশনটিও ইতিহাসে খুঁজে দেখুন।
পুরো ব্যবস্থাটা কীভাবে পরীক্ষা করবেন?
চার ধরনের ব্যর্থতা আলাদা করে ঘটিয়ে দেখুন: পরের দিকের কোনো নোডে API-এর ভুল, Stop And Error দিয়ে ব্যবসায়িক ব্যর্থতা, ট্রিগার চালুর ভুল, আর অ্যালার্ট মাধ্যম নিজেই বন্ধ। প্রতিবার দেখুন ঠিক চ্যানেলে, ঠিক মাত্রায়, ওয়ার্কফ্লোর নাম আর লিংকসহ বার্তা গেছে কি না। এক্সিকিউশন সেভের নিয়ম অনুযায়ী URL আসছে কি না সেটাও মিলিয়ে নিন। আসল কাস্টমারের তথ্য নয়, বানানো অর্ডার ব্যবহার করুন, আর এমন টেস্ট ট্রিগার নিন যাতে সত্যিকারের ইমেইল বা পেমেন্ট চলে না যায়।
টেস্ট শেষে ইচ্ছাকৃত Stop And Error পথটি বন্ধ করুন, অথবা শর্তটি প্রোডাকশনের জন্য নিরাপদ করুন। তারপর হ্যান্ডলার সেভ আছে কি না, আর মূল ওয়ার্কফ্লোর সেটিংসে Error workflow এখনো বসানো আছে কি না, আবার খুলে দেখে নিন।
অ্যালার্ট আসার পর তদন্ত কোথা থেকে শুরু করবেন?
অ্যালার্ট শুধু শুরুর বিন্দু, আসল প্রমাণ থাকে এক্সিকিউশনের রেকর্ডে। n8n-এর Executions তালিকা থেকে একটি ওয়ার্কফ্লোর, অথবা আপনার দেখার অনুমতি আছে এমন সব ওয়ার্কফ্লোর ব্যর্থ এক্সিকিউশন দেখা যায়। আগের এক্সিকিউশনের ডেটা বর্তমান ওয়ার্কফ্লোতে লোড করেও ডিবাগ করা যায়, যদিও এই সুবিধা প্ল্যানভেদে আলাদা হতে পারে। বাইরের কোনো পর্যবেক্ষণ ব্যবস্থায় তথ্য পাঠাতে চাইলে log streaming বিবেচনা করুন।
কোন ভুলগুলো ছোট সমস্যাকে বড় ঘটনায় পরিণত করে?
- Error Trigger ছাড়া হ্যান্ডলার বানানো।
- হ্যান্ডলার সেভ করলেও মূল ওয়ার্কফ্লোর সেটিংসে বসাতে ভুলে যাওয়া।
- সব পেলোডে
execution.urlথাকবে ধরে নেওয়া। - লেখার কাজ, যেমন অর্ডার বা পেমেন্ট, না দেখে আবার চালানো।
- Slack-এ কাস্টমারের পুরো তথ্য বা গোপন চাবি পাঠানো।
- প্রতিটি আইটেমের ব্যর্থতায় আলাদা অ্যালার্ট দিয়ে চ্যানেল ভাসিয়ে দেওয়া।
- হ্যান্ডলারের credential আর বিকল্প চ্যানেল কখনো পরীক্ষা না করা।
- API সফল উত্তর দিল কিন্তু ভেতরের তথ্য অচল, এটা ধরতে না পারা।
এর আগের ধাপ হিসেবে Google Form জমা পড়লেই Telegram এ অ্যালার্ট: Make.com, n8n আর ফ্রি Apps Script দিয়ে লেখাটি কাজে লাগবে। অটোমেশনের বাইরে AI-এর আরেকটি ব্যবহার দেখতে চাইলে নিজের Voice Clone করবেন কীভাবে? রেকর্ডিং, অনুমতি আর নিরাপদ ব্যবহার পড়তে পারেন।
তথ্যসূত্র: n8n Docs: Handle errors gracefully এবং Error Trigger node (দেখা হয়েছে: নভেম্বর ২০২৬)।
সচরাচর যা জিজ্ঞেস করা হয়
n8n Error Workflow কোথায় বসাব?
একটি হ্যান্ডলার কি অনেক ওয়ার্কফ্লো ব্যবহার করতে পারে?
প্রতিটি ভুলে কি এক্সিকিউশনের URL আসে?
হাতে চালিয়ে কি Error Workflow পরীক্ষা করা যায়?
Stop And Error নোড কেন ব্যবহার করব?
ব্যর্থ এক্সিকিউশন নিজে থেকে আবার চালানো কি নিরাপদ?
কোড ছাড়া অটোমেশন শিখতে চাইলে
AI অটোমেশন Masterclass এ মেসেঞ্জার আর হোয়াটসঅ্যাপের উত্তর, Google Form থেকে শিট, Make.com আর n8n দিয়ে অটোমেশন বাংলায় দেখানো আছে।
Execution history, debugging ও পুনরায় চালানোর ভিত্তি জানতে n8n শেখার গাইড দেখুন।

AI টুলস হেভেন
কোন কাজে কোন ধরনের টুল লাগে তার মানচিত্র, বাছাইয়ের চেকলিস্ট, আর খরচ ও নিরাপত্তা নিয়ন্ত্রণের নিয়ম।
সম্পর্কিত লেখা
বিষয়টা বুঝেছেন, এবার হাতে কলমে শিখে কাজ শুরু করুন।
৩০ সেকেন্ডের কুইজ বলে দেবে আপনার অবস্থায় কোন কোর্সটা লাগবে।