নতুন অর্ডার আমার নিজের সিস্টেমে বা ইমেইলে পাঠাতে কীভাবে ওয়েবহুক সেট আপ করব?

ওয়েবহুক কী করে

ওয়েবহুক আপনার স্টোরে কোনো ইভেন্ট ঘটার সঙ্গে সঙ্গে তার বিস্তারিত অন্য একটি জায়গায় পাঠায়। ইভেন্ট ও কোথায় যাবে তা আপনি বেছে নেন:

• API: Storeep ইভেন্টের ডেটা পাঠায় আপনার সার্ভার, CRM, Zapier বা Make সিনারিও, অথবা অ্যাড ট্র্যাকিং টুলের একটি ওয়েব ঠিকানায় (URL)।
• ইমেইল: Storeep ইভেন্টের ডেটা একটি ইমেইল ঠিকানায় পাঠায়, যেমন প্রতিটি নতুন অর্ডারের জন্য একটি ইমেইল পেতে।

সেটিংস > ওয়েবহুক খুলুন। আপনার সেটিংস পারমিশন লাগবে।

অনেক টুলের জন্য আগে থেকেই রেডিমেড অ্যাপ আছে, যা আরও সহজ: Google Sheets, কুরিয়ার নেটওয়ার্ক ও অ্যাড পিক্সেল। আগে অ্যাপ মার্কেট দেখে নিন।

একটি ওয়েবহুক তৈরি করা

নতুন ওয়েবহুক যোগ করুন-এ ক্লিক করুন, ফর্মটি পূরণ করুন এবং যোগ করুন-এ ক্লিক করুন।

• চালু করুন: ডিফল্টভাবে টিক দেওয়া থাকে। টিক থাকলে ইভেন্টগুলো সঙ্গে সঙ্গে পাঠানো হয়। ওয়েবহুকটি রেখে সাময়িক বন্ধ রাখতে টিক তুলে দিন।
• নাম: আপনার তালিকার জন্য একটি লেবেল, যেমন "CRM new orders"।
• ধরন: API বা ইমেইল।
• ইভেন্ট:
  • অর্ডার তৈরি হয়েছে: কোনো কাস্টমার নতুন অর্ডার দেন।
  • অর্ডার আপডেট হয়েছে: কোনো অর্ডারের স্ট্যাটাস বা বিস্তারিত বদলায়।
  • সেশন তৈরি হয়েছে: একজন নতুন ভিজিটর আপনার স্টোরে আসেন। শুধু API ধরনের জন্য।
• ফরম্যাট: Json।
• URL (API ধরন): যে ঠিকানায় পাঠানো হবে। https:// অংশটি আপনার হয়ে যোগ করা হয়, তাই বাকিটা লিখুন, যেমন api.example.com/orders।
• ইমেইল ঠিকানা (ইমেইল ধরন): ইমেইল যেখানে যাবে।

একটি ইমেইল ওয়েবহুক শুধু অর্ডারের ইভেন্ট পাঠায়। সেশন তৈরি হয়েছে-এর সঙ্গে ইমেইল বাছলে কিছুই পাঠানো হয় না।

URL-এ অর্ডারের ডেটা বসানো

ইভেন্ট ডেটার যেকোনো ঘর ডাবল ব্রেসেস দিয়ে URL-এর ভেতরে বসাতে পারেন, {{field_name}}। যেমন:

example.com/postback?cid={{fbclid}}&payout={{order_total}}

এটি Facebook ক্লিক ID ও অর্ডারের মোট টাকা কোনো অ্যাড ট্র্যাকিং বা অ্যাফিলিয়েট প্ল্যাটফর্মে পাঠায়, কোনো বাড়তি সার্ভার ছাড়াই। যে ঘর নেই সেটি খালি হয়ে যায়। ঘরগুলোর নাম দেখতে একই ইভেন্টের জন্য একটি ইমেইল ওয়েবহুক তৈরি করে যে ডেটা পান তা দেখুন।

ওয়েবহুকের তালিকা

প্রতিটি সারিতে দেখায় নাম, URL / ইমেইল, ধরন, ইভেন্ট, ফরম্যাট ও স্ট্যাটাস (চালু বা বন্ধ)। এডিট করতে একটি সারিতে ক্লিক করুন। স্থায়ীভাবে সরাতে সারিগুলোতে টিক দিয়ে ওয়েবহুক ডিলিট করুন বেছে নিন। প্রতিটি স্টোরে ওয়েবহুকের একটি সর্বোচ্চ সংখ্যা আছে, এবং সেখানে পৌঁছালে একটি মেসেজ দেখবেন।

একই ইভেন্টের জন্য কয়েকটি ওয়েবহুক তৈরি করতে পারেন, যেমন একটি আপনার CRM-এ এবং একটি আপনার অ্যাড ট্র্যাকারে।

ডেলিভারি ব্যর্থ হলে

• আপনার সার্ভারের উচিত একটি সফলতার কোড (2xx) দিয়ে দ্রুত উত্তর দেওয়া। ধীর উত্তরকে ব্যর্থতা হিসেবে ধরা হয়।
• আপনার সার্ভার বন্ধ বা ব্যস্ত থাকলে (5xx বা 429 উত্তর, অথবা কোনো উত্তর নেই), Storeep পরের কয়েক মিনিটে কয়েকবার আবার চেষ্টা করে। শুধু ব্যর্থ ওয়েবহুকগুলো আবার চেষ্টা করা হয়, তাই অন্যগুলো ডুপ্লিকেট পায় না।
• আপনার সার্ভার রিকোয়েস্ট প্রত্যাখ্যান করলে (404 বা 403-এর মতো 4xx উত্তর), Storeep আবার চেষ্টা করে না, কারণ ঠিকানা বা তার নিরাপত্তা ভুল।
• একটি ওয়েবহুক পরপর কয়েকবার ব্যর্থ হলে স্টোরের মালিক একটি ইমেইল পান: "Action needed: your Storeep webhook is failing", ওয়েবহুকের নাম, ঠিকানা, ইভেন্ট ও শেষ ত্রুটির কোডসহ। ওয়েবহুক আবার কাজ করার পরে ভবিষ্যতের কোনো সমস্যায় নতুন সতর্কতা আসতে পারে। এই ইমেইল বন্ধ করতে পারেন নোটিফিকেশন-এ।
• ইমেইল ওয়েবহুক একবারই পাঠানো হয়, কোনো রিট্রাই ছাড়া।

অপরিশোধিত বকেয়ার কারণে থেমে থাকা ওয়েবহুক

আপনার স্টোরে অপরিশোধিত বকেয়া থাকলে এবং আপনার ওয়ালেট তা মেটাতে না পারলে ওয়েবহুকগুলো অপেক্ষা করে। আপনি টাকা যোগ করে বকেয়া পরিশোধ হলে সেগুলো পাঠানো হয়। দেখুন ওয়ালেট ও বিলিং।

টিপস

• আপনার সার্ভারে পাসওয়ার্ড বা কী লাগলে সেটি URL কোয়েরিতে রাখুন, যেমন ?key=yoursecret।
• সেশন তৈরি হয়েছে প্রত্যেক ভিজিটরের জন্য চলে, যা ব্যস্ত স্টোরে অনেক হতে পারে। আপনার সার্ভার সামলাতে পারলেই শুধু এটি ব্যবহার করুন।
• কোনো টুলকে যখন খুশি আপনার অর্ডার ও প্রোডাক্ট পড়তে দিতে চাইলে এর বদলে একটি অ্যাক্সেস টোকেন ব্যবহার করুন।