WooCommerce, Laravel বা Next.js ওয়েবসাইট Alapi-র সাথে কানেক্ট করার সম্পূর্ণ গাইড (২০২৬)

অনেক ব্যবসায়ীর নিজস্ব ওয়েবসাইট আছে — কেউ WooCommerce-এ, কেউ কাস্টম Laravel বা Next.js-এ বানিয়েছেন। সাধারণ প্রশ্ন: “আমার তো WooCommerce না, তাহলে কি Alapi-র মেসেঞ্জার বট আমার ওয়েবসাইটের সাথে চলবে?” উত্তর — হ্যাঁ, চলবে। এই গাইডে তিনটি পথ দেখানো হলো, সাথে ডেভেলপারের জন্য পুরো টেকনিক্যাল কন্ট্রাক্ট।

মূল ধারণা: Alapi কীভাবে স্টোরের সাথে কথা বলে

Alapi আপনার স্টোরের সাথে যোগাযোগ করে WooCommerce REST API দিয়ে। অর্থাৎ Alapi আপনার সাইটের /wp-json/wc/v3/ ঠিকানায় কল করে — প্রোডাক্ট পড়ে (দাম, স্টক, ছবি) আর বট অর্ডার নিলে সেটি আপনার স্টোরে বসিয়ে দেয়। এই একটাই কন্ট্রাক্ট বুঝলে বাকিটা সহজ।

এর মানে:

• সাইট WooCommerce হলে — সরাসরি চলবে, কোনো কোডিং লাগবে না।
• সাইট কাস্টম (Laravel/Next.js) হলে — হয় ম্যানুয়াল মোড (কোড ছাড়া), নয়তো ডেভেলপার কয়েকটা এন্ডপয়েন্ট বানিয়ে দিলে Alapi সেটাকে WooCommerce-এর মতোই ব্যবহার করবে।

পথ ১ — WooCommerce সাইট (সরাসরি, কোড ছাড়া)

1. WordPress admin → WooCommerce → Settings → Advanced → REST API → Add key।
2. Permissions = Read/Write দিয়ে কী তৈরি করুন। Consumer key (ck_…) ও Consumer secret (cs_…) কপি করুন।
3. Alapi ড্যাশবোর্ডে স্টোর-কানেক্ট অংশে সাইট URL + consumer key + consumer secret বসিয়ে সেভ করুন।

ব্যস। Alapi আপনার প্রোডাক্ট টেনে নেবে, আর বট প্রতিটি অর্ডার সরাসরি WooCommerce-এ ক্যাশ-অন-ডেলিভারি অর্ডার হিসেবে বসাবে।

পথ ২ — যেকোনো সাইট, ম্যানুয়াল মোড (কোড ছাড়া)

সাইট কাস্টম হলে এবং এখনই ডেভেলপার না লাগাতে চাইলে, Alapi ড্যাশবোর্ডে প্রোডাক্ট নিজে যোগ করুন — নাম, দাম, স্টক, ছবি, ভ্যারিয়েন্ট। বট এগুলো দিয়েই দাম বলবে, ছবি ও ভিডিও পাঠাবে, অর্ডার নেবে এবং কুরিয়ারে পাঠানোর ব্যবস্থা করবে।

সীমাবদ্ধতা: এই মোডে বটের নেওয়া অর্ডার Alapi-তে থাকে, আপনার নিজের ওয়েবসাইটের ডাটাবেসে অটোমেটিক ঢোকে না। দুই জায়গা এক করতে চাইলে নিচের পথ ৩।

পথ ৩ — Laravel / Next.js কাস্টম সাইট (ডেভেলপারের কন্ট্রাক্ট)

আপনার ব্যাকএন্ডে কয়েকটা এন্ডপয়েন্ট এমনভাবে বানাতে হবে যেন সেগুলো WooCommerce-এর মতো আচরণ করে। তারপর Alapi-তে সাইটটিকে “WooCommerce” স্টোর হিসেবে কানেক্ট করলেই হবে।

Base URL ও Authentication

Alapi প্রতিটি কলে দুটো query-param পাঠাবে — এগুলো আপনি ঠিক করবেন এবং প্রতি রিকোয়েস্টে যাচাই করবেন (না মিললে 401 দিন):

https://yoursite.com/wp-json/wc/v3/{endpoint}?consumer_key=CK&consumer_secret=CS

যে ৪টি এন্ডপয়েন্ট লাগবে

১) GET /wp-json/wc/v3/products — প্রোডাক্ট তালিকা (query: per_page, status=publish, কখনো include= বা search=)। রেসপন্স:

[
  {
    "id": 101,
    "name": "Youbuy Whitening Cream",
    "price": "280",
    "regular_price": "350",
    "stock_status": "instock",
    "stock_quantity": 12,
    "short_description": "ত্বকের দাগ কমাতে সহায়ক",
    "images": [ { "src": "https://yoursite.com/img/101.jpg" } ],
    "variations": []
  }
]

২) GET /wp-json/wc/v3/products/{id} — একটি প্রোডাক্টের বিস্তারিত ও ছবি (বট ছবি পাঠানোর সময় ব্যবহার করে)। উপরের একই অবজেক্ট ফেরত দিন।

৩) GET /wp-json/wc/v3/orders — অর্ডার খোঁজা/ট্র্যাকিং (query: search=017XXXXXXXX, per_page=5, orderby=date, order=desc)। অর্ডার-অবজেক্টের অ্যারে ফেরত দিন।

৪) POST /wp-json/wc/v3/orders — বট অর্ডার নিলে Alapi ঠিক এই বডি পাঠাবে; আপনি এটি নিয়ে আপনার ডাটাবেসে আসল COD অর্ডার তৈরি করবেন:

{
  "payment_method": "cod",
  "payment_method_title": "Cash on Delivery",
  "set_paid": false,
  "status": "processing",
  "billing": {
    "first_name": "রহিম",
    "phone": "017XXXXXXXX",
    "address_1": "বাসা ১২, রোড ৩, ঢাকা",
    "city": "Dhaka",
    "country": "BD"
  },
  "line_items": [ { "product_id": 101, "quantity": 2 } ],
  "customer_note": "Order via Alapi (Messenger)"
}

অর্ডার সেভ করে অন্তত এটুকু রেসপন্স দিন (গুরুত্বপূর্ণ):

{ "id": 5501, "number": "5501", "status": "processing" }

Alapi আসলে যে ফিল্ডগুলো পড়ে

id, name, price (স্ট্রিং, “৳” ছাড়া সংখ্যা), stock_status (instock/outofstock), short_description, images[].src, এবং ভ্যারিয়েন্ট থাকলে variations। এর বাইরের ফিল্ড থাকলে সমস্যা নেই — তাই অ্যাডাপ্টার হালকা রাখা যায়।

Next.js হলে

App Router-এ Route Handler দিয়ে এন্ডপয়েন্ট বানান, আর next.config-এ rewrite দিন যেন পাথ /wp-json/wc/v3/... হয়। প্রতিটি হ্যান্ডলারে consumer_key যাচাই করে আপনার DB থেকে ডেটা WooCommerce-শেপে ম্যাপ করে দিন। POST /orders-এ অর্ডার সেভ করে {id, number, status} ফেরত দিন।

Laravel হলে

routes/api.php-তে Route::prefix('wp-json/wc/v3') দিয়ে চারটি রুট বসান (একটা middleware-এ key যাচাই)। products মেথডে আপনার products টেবিল থেকে ডেটা এনে JSON-শেপে দিন; createOrder-এ billing ও line_items নিয়ে Order তৈরি করে {id, number, status} রেসপন্স দিন।

শেষ ধাপ — Alapi-তে কানেক্ট ও টেস্ট

1. ডেভেলপার এন্ডপয়েন্ট রেডি করলে সাইটের base URL + consumer key + secret নিন।
2. Alapi ড্যাশবোর্ড → Bot Settings → স্টোর কানেক্ট-এ তিনটি বসিয়ে সেভ করুন।
3. প্রোডাক্ট তালিকায় আপনার পণ্য দেখা গেলেই কানেকশন ঠিক আছে।
4. বটে একটা টেস্ট অর্ডার করান → আপনার সাইটের ডাটাবেসে অর্ডারটি এলো কিনা দেখুন।

প্রায়-জিজ্ঞাসিত প্রশ্ন

আমার সাইট WooCommerce না, তবুও কি বট চলবে? হ্যাঁ — ম্যানুয়াল মোডে সাথে সাথেই, আর ডেভেলপার এন্ডপয়েন্ট বানালে পূর্ণ সিঙ্ক।

অর্ডার কি আমার নিজের ডাটাবেসে ঢুকবে? পথ ৩-এ হ্যাঁ (POST /orders আপনার DB-তে অর্ডার বানায়)। ম্যানুয়াল মোডে অর্ডার Alapi-তে থাকে।

নিরাপত্তা? HTTPS বাধ্যতামূলক, আর consumer key/secret প্রতি রিকোয়েস্টে যাচাই — না মিললে 401।

Alapi দিয়ে আপনার ফেসবুক পেজে ২৪/৭ বাংলা অটো-রিপ্লাই, চ্যাট থেকে অর্ডার আর যেকোনো ওয়েবসাইট কানেক্ট করুন — ৭ দিন ফ্রি শুরু করুন।