WooCommerce, Laravel বা Next.js ওয়েবসাইট Alapi-র সাথে কানেক্ট করব কীভাবে? (২০২৬) — লাইভ নমুনা স্টোর ও রেডি কোডসহ

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

Store URL:        https://alapi.chat/alapi-sample-store
Consumer key:     ck_alapi_demo
Consumer secret:  cs_alapi_demo

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

Alapi আপনার স্টোরের সাথে যোগাযোগ করে WooCommerce REST API (v3) দিয়ে — আপনার সাইটের /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 দিয়ে key তৈরি করুন। Consumer key (ck_…) ও Consumer secret (cs_…) কপি করুন (secret একবারই দেখায়)।
3. Alapi ড্যাশবোর্ড → Bot Settings → “🛒 আমার অনলাইন স্টোর আছে” → সাইট URL + ck + cs বসিয়ে “যুক্ত করুন ও টেস্ট”।

সবুজ ✅ এলে Alapi আপনার প্রোডাক্ট টেনে নিয়েছে (“N টি পণ্য bot জানে” দেখাবে)। বট প্রতিটি অর্ডার সরাসরি WooCommerce-এ ক্যাশ-অন-ডেলিভারি অর্ডার হিসেবে বসাবে — ডেলিভারি চার্জ shipping line হিসেবে, বটের দামাদামি-ছাড় থাকলে fee line হিসেবে।

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

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

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

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

আপনার ব্যাকএন্ডে ৪টি রুট এমনভাবে বানাতে হবে যেন সেগুলো WooCommerce-এর মতো আচরণ করে। তারপর Alapi-তে সাইটটিকে স্টোর হিসেবে কানেক্ট করলেই হবে। নিচের সবকিছু Alapi-র আসল কোড থেকে নেওয়া — অনুমান নয়; নমুনা স্টোরটা হুবহু এটাই করে।

৩.১ Authentication

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

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

401 →  { "code": "woocommerce_rest_cannot_view", "message": "Invalid consumer_key / consumer_secret", "data": { "status": 401 } }

HTTPS বাধ্যতামূলক। ফায়ারওয়াল/WAF থাকলে Alapi-র সার্ভার (23.94.4.88) allow করুন। Alapi প্রোডাক্ট-তালিকা ৩০ মিনিট ক্যাশ করে — দাম বদলালে সর্বোচ্চ ৩০ মিনিট পরে বট নতুন দাম বলবে।

৩.২ যে ৪টি রুট লাগবে

প্রোডাক্ট-অবজেক্ট — Alapi আসলে যে ফিল্ডগুলো পড়ে:

{
  "id": 101,
  "name": "নমুনা টি-শার্ট",
  "price": "450",                      ← স্ট্রিং, শুধু সংখ্যা (৳ বা কমা নয়)
  "regular_price": "550",
  "stock_status": "instock",           ← instock | outofstock
  "stock_quantity": 25,
  "short_description": "১০০% কটন…",     ← HTML থাকলে Alapi ট্যাগ ছেঁটে নেয়
  "images": [ { "src": "https://yoursite.com/img/101.jpg" } ],   ← প্রথমটা বট পাঠায়
  "categories": [], "attributes": [], "variations": []
}

বাড়তি ফিল্ড থাকলে সমস্যা নেই (regular_price, stock_quantity, categories Alapi পড়ে না — শুধু উপরের ৬টি)। ভ্যারিয়েন্ট (রঙ/সাইজ) আলাদা দামে বেচলে সবচেয়ে নিরাপদ: প্রতিটিকে আলাদা প্রোডাক্ট হিসেবে দিন (যেমন “শাড়ি — লাল”, “শাড়ি — নীল”) — কানেক্টেড স্টোরে variations পড়া হয় না। বট প্রথম ৫০টি পণ্য জানে (per_page=50); বেশি থাকলে গুরুত্বপূর্ণগুলো আগে দিন।

POST /orders — বট অর্ডার নিলে Alapi ঠিক এই বডি পাঠায়:

{
  "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)",
  "shipping_lines": [ { "method_id": "flat_rate", "method_title": "ডেলিভারি চার্জ", "total": "80" } ],   ← ডেলিভারি চার্জ (০ হলে থাকে না)
  "fee_lines": [ { "name": "🤝 বট দামাদামি ছাড়", "total": "-50", "tax_status": "none" } ]              ← দামাদামি-ছাড়, ঋণাত্মক (না থাকলে নেই)
}

একাধিক পণ্যের অর্ডারে line_items-এর ঘরে বাড়তি "variant":"লাল" কী-ও আসতে পারে — না চিনলে উপেক্ষা করুন। আপনি এটা নিয়ে নিজের ডাটাবেসে COD অর্ডার বানাবেন (মোট = পণ্যের দাম × পরিমাণ + shipping − fee), তারপর ফেরত দেবেন:

201 →  { "id": 5501, "number": "5501", "status": "processing", "total": "980", "date_created": "2026-10-02T18:40:00",
         "billing": { … }, "line_items": [ { "product_id": 101, "name": "নমুনা টি-শার্ট", "quantity": 2, "price": 450 } ] }

number-টাই বট কাস্টমারকে বলে — শুধু অঙ্কে রাখুন (কাস্টমার নম্বর লিখলে Alapi অঙ্ক ছাড়া সব বাদ দিয়ে খোঁজে, তাই «INV-5501» মিলবে না); total আর line_items Alapi-র ড্যাশবোর্ড/রিপোর্টে কপি হয়। অর্ডারের status পরে আপনার সাইটে বদলালে (shipped/delivered) Alapi নিজে টানে না — কাস্টমার ট্র্যাকিং জিজ্ঞেস করলে রুট ৩ দিয়ে তখনই লাইভ পড়ে।

৩.৩ রেডি কোড — কপি করে বসান

📦 alapi-store-adapters.zip (১৯ KB) — ভেতরে:

• php/index.php — নমুনা স্টোরের পুরো সোর্স, এক ফাইল, কোনো ফ্রেমওয়ার্ক ছাড়া (অনলাইনেও পড়ুন)। আগে এটা পড়লে বাকিটা পানির মতো সহজ।
• laravel/ — routes-api.php (৪ রুট), app/Http/Middleware/AlapiKeyAuth.php (key যাচাই), app/Http/Controllers/AlapiStoreController.php (আপনার Product/Order মডেল ম্যাপ করার ৪টা TODO ব্লক)। .env-এ ALAPI_CK/ALAPI_CS, আর config/services.php-এ 'alapi' => ['ck' => env('ALAPI_CK'), 'cs' => env('ALAPI_CS')] (middleware config() পড়ে, তাই config:cache-এর পরেও কাজ করে)। Laravel-এর api রুট /api প্রিফিক্সে থাকে, তাই Alapi-তে Store URL দিন https://yoursite.com/api।
• nextjs/ — App Router (Next 14 ও 15+ দুটোতেই চলে): lib/alapi-store.ts (key যাচাই + WooCommerce-শেপ হেল্পার + ৪টা db.* TODO) আর app/wp-json/wc/v3/products/route.ts, …/products/[id]/route.ts, …/orders/route.ts। ফোল্ডারের নামই পাথ, তাই rewrite লাগে না; Store URL = https://yoursite.com।
• alapi-store-check.sh — সেলফ-চেক (নিচে)।

৩.৪ সেলফ-চেক: Alapi কানেক্ট হবে কি না, ১০ সেকেন্ডে

bash alapi-store-check.sh https://yoursite.com ck_xxx cs_xxx

৯টি চেক: HTTPS · key ছাড়া 401 · ভুল key-তে 401 · প্রোডাক্ট-তালিকার শেপ (id, name, price-স্ট্রিং, stock_status, images[0].src) · প্রোডাক্ট by id · include= · POST orders (আপনার সাইটে একটা টেস্ট-অর্ডার বানায় — পরে মুছে দিন) · ফোন দিয়ে সার্চ · নম্বর দিয়ে সার্চ। ৯/৯ ✅ মানে Alapi কানেক্ট হবে — নমুনা স্টোরে চালালে ঠিক তাই দেখায়।

৩.৫ Alapi-তে কানেক্ট ও টেস্ট

1. Alapi ড্যাশবোর্ড → Bot Settings → “🛒 আমার অনলাইন স্টোর আছে” → Store URL + consumer key + secret → “যুক্ত করুন ও টেস্ট”।
2. Alapi সাথে সাথে GET products?per_page=1&status=publish ডাকে। সবুজ ✅ = কানেক্ট; লাল হলে কারণটা নোটিশেই দেখাবে (401 = key ভুল, 404 = /wp-json/wc/v3/ পাথ নেই, “HTTP 500” = আপনার কোডে ত্রুটি, খালি তালিকা = status=publish-এ কোনো পণ্য নেই)।
3. “N টি পণ্য bot জানে” দেখা গেলে বটে একটা টেস্ট-অর্ডার করান → আপনার ডাটাবেসে অর্ডারটি এলো কি না দেখুন; Alapi-র Orders ট্যাবেও একই অর্ডার দেখাবে।

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

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

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

Laravel-এ /api প্রিফিক্স সরাতে চাই। রুটগুলো routes/web.php-এ নিন আর wp-json/*-কে CSRF থেকে বাদ দিন; তখন Store URL = https://yoursite.com।

কোনটা আগে — কোড না Alapi? আগে নমুনা স্টোর কানেক্ট করে দেখুন কেমন চলে, তারপর ডেভেলপারকে এই পাতা + ZIP দিন, সেলফ-চেক ৯/৯ হলে আপনার সাইট কানেক্ট করুন।

Shopify? Shopify-র নিজস্ব API আলাদা — এখনো সরাসরি নেই; ম্যানুয়াল মোডে চালান।

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

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