আউটবাউন্ড ওয়েবহুক

ওয়েবহুক FreeMaint-কে আপনার নিয়ন্ত্রণাধীন একটি URL-এ POST পাঠাতে দেয়, ঘটনা ঘটার সঙ্গে সঙ্গেই — ফলে অন্য একটি সিস্টেম (ERP, বিলিং, ইনভেন্টরি, হিসাবরক্ষণ, চ্যাট চ্যানেল) কারও পুনরায় টাইপ করা ছাড়াই মিলে থাকে। /company-settings/webhooks থেকে কনফিগার করুন। Starter-এ দিনে ১০০ ডেলিভারির সীমা; Business ও তার উপরে সীমাহীন। পূর্ণ পেলোড রেফারেন্সের জন্য দেখুন API ও GraphQL > ওয়েবহুক।

উপলব্ধ ইভেন্ট

• work_order.created — একটি কাজের নির্দেশনা তৈরি হয়েছে
• work_order.completed — একটি কাজের নির্দেশনা «সম্পন্ন» অবস্থায় গেছে
• work_order.status_changed — একটি কাজের নির্দেশনা যেকোনো অবস্থায় গেছে; work_order.completed-ও যথারীতি পাঠানো হয়
• request.created — একটি রক্ষণাবেক্ষণ অনুরোধ জমা পড়েছে
• request.status_changed — একটি অনুরোধ অনুমোদিত, প্রত্যাখ্যাত বা বাতিল হয়েছে
• part.low_stock — একটি যন্ত্রাংশ তার রিঅর্ডার পয়েন্টে বা তার নিচে নেমেছে
• part.out_of_stock — একটি যন্ত্রাংশের স্টক শূন্যে নেমেছে
• part.low_stock_summary — দিনে একবার, রিঅর্ডার পয়েন্টে বা তার নিচে থাকা যন্ত্রাংশগুলো, কখনো নড়াচড়া হয়নি এমনগুলোসহ
• part.out_of_stock_summary — দিনে একবার, যেসব যন্ত্রাংশের স্টক শূন্যে রয়েছে
• part.consumed — কোনো কাজের নির্দেশনায় ব্যবহৃত বা সেখান থেকে ফেরত
• compliance.chain_divergence — অডিটের হ্যাশ-চেইন ভেঙে গেছে (Enterprise)
• asset.downtime_started — একটি যন্ত্র বন্ধের রেকর্ড খোলা হয়েছে
• asset.downtime_ended — একটি যন্ত্র বন্ধের রেকর্ড বন্ধ করা হয়েছে
• report.daily_summary — দিনের সম্পন্ন কাজ, আপনার বেছে নেওয়া সময়ে দিনে একবার
• purchase_order.created — একটি ক্রয় আদেশ তৈরি হয়েছে
• purchase_order.status_changed — একটি ক্রয় আদেশ অন্য অবস্থায় গেছে (অনুমোদিত, অর্ডার করা, বাতিল…)
• purchase_order.received — একটি ক্রয় আদেশের বিপরীতে ডেলিভারি গ্রহণ করা হয়েছে, আংশিক ডেলিভারিসহ

ডেলিভারির নিয়ম

• JSON বডিসহ POST: { event, timestamp, data }
• X-FreeMaint-Signature হেডার — t=<unix সেকেন্ড>,v1=<hex>, যেখানে v1 হলো আপনার ওয়েবহুক সিক্রেট কী দিয়ে «<t>.<কাঁচা বডি>»-এর HMAC-SHA256। প্রতিটি অনুরোধে, কাঁচা বডির বিপরীতে যাচাই করুন
• সঙ্গে X-FreeMaint-Event ও X-FreeMaint-Delivery-Id-ও পাঠানো হয়
• নেটওয়ার্ক ত্রুটি ও 5xx সর্বোচ্চ ৩ বার এক্সপোনেনশিয়াল ব্যাকঅফসহ পুনরায় চেষ্টা করা হয় (প্রায় ২ সে., ৪ সে., ৮ সে.); 4xx স্থায়ী প্রত্যাখ্যান, পুনরায় চেষ্টা হয় না
• প্রতিটি চেষ্টা ওয়েবহুকের নিচে স্ট্যাটাস, রেসপন্স কোড ও চেষ্টার সংখ্যাসহ লিপিবদ্ধ থাকে — এবং শেষ হওয়া যেকোনো ডেলিভারি সেখান থেকে পুনরায় পাঠানো যায়
• ঐচ্ছিক ছবি: "ছবি অন্তর্ভুক্ত করুন" চালু থাকলে "work_order" ও "request" ইভেন্টের "photos" ফিল্ডে সর্বোচ্চ 4টি ছবির লিংক থাকে, যা থাকা যে কেউ 7 দিন খুলতে পারবেন — শুধু আপনার নিয়ন্ত্রণে থাকা একটি এন্ডপয়েন্টের জন্য চালু করুন

কনফিগারেশন

1. /company-settings/webhooks খুলুন — কোম্পানি সেটিংসের অনুমতি বা "ইন্টিগ্রেশন পরিচালনা" অনুমতি প্রয়োজন।
2. «ওয়েবহুক যোগ করুন» ক্লিক করুন — একটি নাম, একটি https:// URL দিন এবং কাঙ্ক্ষিত ইভেন্টগুলো টিক করুন।
3. স্বাক্ষর সিক্রেট কপি করুন — তৈরির সময় এটি একবারই দেখানো হয়। পরে «সিক্রেট ঘোরান» দিয়ে নতুন তৈরি করা যায়, তাতে পুরোনোটি অকার্যকর হয়।
4. ডেলিভারি পর্যবেক্ষণ করুন — ইভেন্ট পৌঁছাচ্ছে কিনা নিশ্চিত করতে এবং ব্যর্থগুলো পুনরায় পাঠাতে ওয়েবহুকের ডেলিভারি ইতিহাস খুলুন।

প্ল্যান অনুযায়ী সীমা

• Starter — প্রতি কোম্পানিতে দিনে ১০০ ডেলিভারি (কাউন্টার 00:00 UTC-তে রিসেট)
• Business — সীমাহীন
• Enterprise — সীমাহীন
• গণনা হয় চেষ্টা ধরে: একই ইভেন্টে তিনটি ওয়েবহুক তিন একক খরচ করে