WooCommerce

আপনার সেল্ফ-হোস্টেড WooCommerce store যুক্ত করুন যাতে আপনার AI agent product-এর প্রশ্নের উত্তর দিতে, একজন ক্রেতার order খুঁজে দিতে, স্টকে থাকা জিনিস সুপারিশ করতে এবং order-status আপডেট পাঠাতে পারে — সবই আপনার sync করা catalog ও order ডেটা থেকে।

আপনি যা পান

• Catalog প্রশ্নোত্তর — উত্তর আসে আপনার আসল product, variant, দাম ও বর্তমান প্রাপ্যতা থেকে
• Order খোঁজা (WISMO) — ক্রেতারা তাদের order নম্বর এবং order-এ থাকা ইমেইল বা ফোন দিয়ে “আমার order কোথায়?” জানতে পারে
• সুপারিশ — প্রস্তাব শুধু সেই product-এই সীমাবদ্ধ যা আসলে স্টকে আছে
• Order-status আপডেট — একই chat-এ shipping আপডেট, যারা opt-in করে তাদের জন্য
• বর্তমান inventory — দাম ও stock আসে আপনার sync করা catalog থেকে, যা webhook দিয়ে হালনাগাদ রাখা হয়
• Checkout handoff — কিনতে প্রস্তুত ক্রেতাকে আপনার নিজের WooCommerce checkout-এ পাঠানো

পূর্বশর্ত

• একটি সেল্ফ-হোস্টেড WooCommerce store যা আপনি পরিচালনা করেন
• আপনার store URL (যেমন, https://your-store.com)
• আপনার Cuneiform Chat workspace-এ একটি Owner বা Admin অ্যাকাউন্ট — একটি store যুক্ত করা একটি admin কাজ
• অন্তত একটি agent, অথবা নতুন একটি তৈরি করার মতো জায়গা (দেখুন আপনার store agent)

আপনাকে কোনো plugin install করতে বা কোড লিখতে হবে না।

আপনার store URL, আপনি যেভাবেই লিখুন

URL-টি আপনার যেভাবে খুশি লিখুন — আমরা সেটি normalize করে নিই। Scheme, শুরুর www., শেষের slash এবং host-এর ছোট-বড় হাতের অক্ষর সবই উপেক্ষা করা হয়। একটি subdirectory install (example.com/shop) এবং একটি অস্বাভাবিক port — দুটিই অক্ষত রাখা হয় ও দুটিই সমর্থিত।

যুক্ত হওয়া

একই card-এ ভেতরে ঢোকার দুটি পথ আছে। কিছু আটকে না দিলে গাইডেড পথটিই ব্যবহার করুন।

পথ A — গাইডেড অনুমোদন (প্রস্তাবিত)

1. Commerce → WooCommerce-এ যান।
2. আপনার store URL দিন এবং Connect ক্লিক করুন।
3. আপনার browser আপনার নিজের store-এর WooCommerce অনুমোদনের পাতায় যায়। সেটি অনুমোদন করুন।
4. WooCommerce key ফেরত পাঠায় এবং আপনি Commerce-এ এসে পৌঁছান।

এটুকুই। গাইডেড পথ তিনটি কাজ করে যা manual পথ করে না: এটি আপনার হয়ে সঠিক permission চায়, এটি সেই webhook-গুলো নিবন্ধন করে যা আপনার ডেটা রিয়েল-টাইমে হালনাগাদ রাখে, এবং এটি প্রথম catalog import শুরু করে দেয়।

পথ B — নিজে হাতে API key পেস্ট করা

আপনার store যদি এমন একটি firewall-এর পেছনে থাকে যা redirect আটকে দেয়, তাহলে Enter API keys manually খুলুন এবং WooCommerce → Settings → Advanced → REST API-এ তৈরি করা একটি consumer key ও secret পেস্ট করুন।

সেগুলো Read/Write permission দিয়ে তৈরি করুন, এবং আমাদের form-এও Read/Write বেছে নিন। একটি read-only key আপনাকে স্থায়ীভাবে webhook ছাড়া রেখে দেয় — নিচে দেখুন।

সংরক্ষণের আগে আমরা store-টি health-check করি। কঠিন ব্যর্থতা সংযোগ আটকে দেয়; নরম সতর্কতা (ধীর বা আংশিকভাবে পৌঁছানো যায় এমন store) সত্ত্বেও সংযোগ হয়ে যায় যাতে আপনি পরে ঠিক করে নিতে পারেন।

Manual সংযোগের পরে

আপনার catalog — “Re-sync now” চাপুন

যুক্ত হওয়ার সময় কিছুই import হয় না। একটি ব্যাকগ্রাউন্ড কাজ প্রতিদিন catalog মিলিয়ে দেখে, কিন্তু সেই দৈনিক ধাপটি কেবল তার নিজের গত চালানোর পর থেকে বদলে যাওয়া product-ই আনে — আর যে store কখনো import-ই হয়নি তার আনার মতো কোনো জমা বাকি নেই, কেবল নতুন সম্পাদনাগুলোই আছে। পূর্ণ import আসে সাপ্তাহিক sweep-এর সাথে, যেটি সাত দিন পর্যন্ত দূরে হতে পারে।

সেটির জন্য অপেক্ষা করবেন না। Commerce → WooCommerce → Catalog & Data খুলুন এবং Re-sync now ক্লিক করুন। এটি ঠিক সেই import চালায় যা গাইডেড পথ যুক্ত হওয়ার সময় চালাত, আর তা কয়েক মিনিটেই শেষ হয়।

আপনার webhook — কেবল যদি আপনার key Read/Write হয়

Webhook-ও যুক্ত হওয়ার সময় নিবন্ধিত হয় না, কিন্তু এটি একটি শর্তে স্বয়ংক্রিয়ভাবে মেরামত হয়। প্রতি ঘণ্টার একটি কাজ প্রতিটি যুক্ত store-এর জন্য webhook নিবন্ধন আবার চেষ্টা করে, তাই:

• একটি Read/Write store নিজে থেকেই ঠিক হয়ে যায়, সাধারণত এক ঘণ্টার মধ্যে। আপনাকে কিছু করতে হয় না।
• একটি read-only store কখনোই ঠিক হয় না। WooCommerce একটি read-only key থেকে আসা প্রতিটি নিবন্ধন-চেষ্টা প্রত্যাখ্যান করে। কাজটি প্রতি ঘণ্টায় আবার চেষ্টা করে এবং প্রতি ঘণ্টায় প্রত্যাখ্যাত হয়, অনির্দিষ্টকাল ধরে।

এটি আপনাকে অনুমান করে নিতে হয় না, দেখাই যায়: Commerce → WooCommerce → Connection-এ একটি Webhook health প্যানেল আছে, যেখানে লেখা থাকবে “Subscriptions drifted” এবং “No events received yet.” অন্য লক্ষণটি আচরণগত — catalog, stock ও order-এর পরিবর্তন ঘটার সাথে সাথে না এসে কেবল পরবর্তী নির্ধারিত sync-এই দেখা দেয়।

Permission সেটিই যা আপনি আমাদের বলেছেন

Integration যা করে আর যা করে না

আপনার store-এর ডেটার প্রশ্নে integration-টি read-only। এটি কখনো কোনো product সম্পাদনা বা মুছে ফেলে না, কখনো stock বদলায় না, কখনো বিদ্যমান কোনো order পাল্টায় বা বাতিল করে না, এবং কখনো পেমেন্ট নেয় না। পেমেন্ট সবসময় আপনার নিজের WooCommerce checkout-এ হয়।

একটি Read/Write সংযোগ কেবল একটি জিনিসই লেখে — একটি pending order, আর সেটিও কেবল তখন যখন কোনো ক্রেতা একটি chat-এর ভেতর থেকে checkout করে: একবারে একটি করে product পাঠানোর বদলে পুরো cart-টি আপনার store-এ একটি pending order হয়ে যায় এবং ক্রেতাকে তার জন্য টাকা দিতে পাঠানো হয়। কিছুই চার্জ করা হয় না, কিছুই fulfil করা হয় না, আর order-টি যে কথোপকথন থেকে এসেছে তার সাথে যুক্ত করে রাখা হয় যাতে বিক্রিটি কোথায় শুরু হয়েছিল তা আপনি দেখতে পান। দেখুন Checkout।

একটি read-only সংযোগ সেই pending order তৈরি করতে পারে না, তাই সেটি বদলে একবারে একটি করে line পাঠায়। দুটি permission-এর মধ্যে বাস্তব পার্থক্য এটিই, আর এ কারণেই গাইডেড পথ সবসময় Read/Write চায়।

বৈশিষ্ট্য

এক store, এক store agent

আপনি প্রতি workspace-এ একটি WooCommerce store যুক্ত করেন — এবং একই সাথে একটি Shopify store যুক্ত থাকতে পারে (দেখুন Commerce)।

যুক্ত হওয়ার সময় একটি agent আপনার store agent হয়ে যায় — আপনার হয়ে বেছে নেওয়া, আপনি নিজে বেছে নেন না। আপনি যদি এই একই store আগে যুক্ত করে থাকেন, তাহলে তার পুরোনো store agent-টিই তার tuning ও version ইতিহাস অক্ষত রেখে ফিরিয়ে নেওয়া হয়; নয়তো নতুন একটি তৈরি করা হয়। সেই agent WooCommerce টুল বহন করে; আপনার অন্য agent-রা অপ্রভাবিত থাকে। খুঁজে বের করার মতো কোনো প্রতি-agent সুইচ নেই — সেই agent-এর নিজের পাতায় একটি read-only প্যানেল দেখায় যে এটি আপনার store দ্বারা পরিচালিত।

যাচাইকৃত order খোঁজা

ক্রেতারা order-এর বিবরণ দেখে কেবল হুবহু order নম্বর এবং order-এ থাকা ইমেইল বা ফোন দেওয়ার পরই। ভুল যোগাযোগ ও অস্তিত্বহীন order — দুটিই একই “খুঁজে পাওয়া গেল না” উত্তর দেয়, কোনো বিবরণ ছাড়াই — এটি অ্যান্টি-এনিউমারেশন সুরক্ষা যা আপনার গ্রাহকদের রক্ষা করে। দেখুন Order।

বর্তমান catalog ও inventory

দাম ও stock আসে আপনার sync করা catalog থেকে, তাই সুপারিশ কেবল আসলে যা পাওয়া যায় তাতেই সীমাবদ্ধ থাকে। WooCommerce stock-এর পরিবর্তন আলাদা inventory ইভেন্ট হিসেবে না পাঠিয়ে product আপডেটের সাথে পাঠায়, তাই কেবল stock বদলালে সেটি পরবর্তী product আপডেট বা পরবর্তী sync-এর সাথে আসে। দেখুন Catalog ও Knowledge।

Opt-in order-status আপডেট

একজন ক্রেতা chat-এ তার order যাচাই করার পর একটি সমর্থিত channel-এ shipping আপডেট পেতে opt-in করতে পারে। ক্রেতার opt-in-ই একমাত্র শর্ত — আপডেটের ধরনগুলো WooCommerce সংযোগে ডিফল্টভাবে চালু থাকে, তাই আগে কিছু চালু করার নেই। দেখুন Order।

Reconnect

Shopify-এর বিপরীতে WooCommerce-এ একটি Reconnect বোতাম আছে। আপনার store-এর API key বদলালে বা বাতিল করলে, অথবা ভুল permission নিয়ে manual-ভাবে যুক্ত হয়ে থাকলে ও গাইডেড পথে যেতে চাইলে এটি ব্যবহার করুন। এটি আপনার store-এ অনুমোদনটি আবার চালায় এবং সংরক্ষিত key-গুলো জায়গামতো বদলে দেয়।

আপনার store থেকে যা sync হয়

WooCommerce-এ চার ধরনের নিজস্ব product type আছে। চারটিই sync হয়, কিন্তু কথোপকথনের ভেতরে সবগুলো একইভাবে কাজ করে না।

বাকি সবকিছু simple হিসেবে ধরা হয়

দাম আর আপনার store-এর মুদ্রা

আপনার store-এ যে অঙ্কগুলো আছে সেগুলোই sync হয়, আপনার নিজের store-এর মুদ্রায়। সেই মুদ্রা আমরা আপনার WooCommerce সেটিংস থেকে পড়ি — ক্রেতার কাছ থেকে কখনোই নয় — আর ক্রেতারা সেটি দেখেন অঙ্কের পাশে তিন অক্ষরের code হিসেবে: USD 19.99, EUR 19.99, BDT 1900।

symbol নয়, code — এটি ইচ্ছাকৃত। শুধু $ চিহ্নটিই চারটি ভিন্ন দেশের ডলার বোঝায়, আর দামের পাশে আত্মবিশ্বাসের সাথে বসানো ভুল symbol একটি নির্ভুল code-এর চেয়ে খারাপ।

প্রতি রাতের catalog reconcile-এ মুদ্রাটি আবার পড়া হয়, তাই WooCommerce-এ আপনি সেটি বদলালে উদ্ধৃত code একদিনের মধ্যেই সেটি অনুসরণ করে। আমরা এই সেটিং পড়া শুরু করার আগে যুক্ত হওয়া কোনো store সেই প্রথম রাতের পাস পর্যন্ত code ছাড়াই অঙ্ক বলে — দাম তখনও ঠিকই আছে, শুধু লেবেলটা এখনো বসেনি।

Shipment-tracking plugin

Carrier আর tracking number একটিমাত্র জায়গা থেকে পড়া হয়: official WooCommerce Shipment Tracking plugin যে রেকর্ডটি লেখে সেটি, যেখানে Advanced Shipment Tracking (AST)-ও লেখে। এই দুটি আসে। অন্য যেকোনো tracking plugin তার তথ্য অন্য কোথাও রাখে এবং সেটি একেবারেই পড়া হয় না, তাই আপনার store-এ tracking number দেখালেও order-টিকে tracking ছাড়া মনে হবে। দেখুন Order।

অনূদিত store

sync-এর কোনো অংশই ভাষা বোঝে না। আপনি WPML বা Polylang ব্যবহার করলে একটি product-এর প্রতিটি অনূদিত সংস্করণ কোনো একটির অনুবাদ হিসেবে নয়, বরং সাধারণ আলাদা product হিসেবেই sync হয়, এবং agent সেগুলোর যেকোনোটি দেখাতে পারে।

নিরাপত্তা

• আপনার catalog, stock বা বিদ্যমান order-এ কোনো লেখালেখি নয় — integration product, inventory ও order পড়ে, কখনো সেগুলো বদলায় না
• Key এনক্রিপ্ট করে রাখা হয় — আপনার consumer key ও secret কখনো প্লেইন টেক্সটে সংরক্ষিত হয় না
• Tenant বিচ্ছিন্নতা — আপনার catalog ও order আপনার workspace-এ সীমাবদ্ধ, অন্য কারো কাছে কখনো দৃশ্যমান নয়
• যাচাইকৃত order খোঁজা — order-এর বিবরণের জন্য হুবহু order নম্বরসহ মিলে যাওয়া ইমেইল বা ফোন লাগে
• Opt-in নোটিফিকেশন — shipping আপডেটের জন্য chat-এ প্রতি ক্রেতার স্পষ্ট opt-in লাগে
• নিরাপদ checkout — পেমেন্ট আপনার নিজের WooCommerce checkout-এ সম্পন্ন হয়; কোনো কার্ড ডেটা agent-এর মধ্য দিয়ে যায় না

সমস্যা সমাধান

যুক্ত হওয়া আটকে যায় বা ব্যর্থ হয়

গাইডেড পথের জন্য আপনার browser-কে আপনার store-এর অনুমোদন-পাতায় পৌঁছাতে হয় এবং আপনার store-কে key নিয়ে আমাদের কাছে পৌঁছাতে হয়। আটকে গেলে সেটি সাধারণত নেটওয়ার্ক বা firewall-এর সমস্যা, আপনার শংসাপত্রের নয়। store firewall-এর পেছনে? manual key পথ ব্যবহার করুন — আর তারপর Manual সংযোগের পরে পড়ুন, কারণ সেটি দুটি জিনিস অসম্পূর্ণ রেখে দেয়।

যুক্ত হওয়ার ঠিক পরেই catalog খালি

আপনি manual-ভাবে যুক্ত হয়ে থাকলে এটিই প্রত্যাশিত — কিছুই import হয়নি। Catalog & Data ট্যাবে Re-sync now ক্লিক করুন।

গাইডেড পথ ব্যবহার করে থাকলে প্রথম import পুরো catalog ভরে দেয় এবং বড় store-এ কয়েক মিনিট লাগতে পারে।

Product বা stock-এর পরিবর্তন দেখাতে ঘণ্টার পর ঘণ্টা লাগে

আপনার webhook নিবন্ধিত নেই। প্রায় সবসময়ই এর মানে store-টি একটি read-only key দিয়ে manual-ভাবে যুক্ত হয়েছিল। সংযোগে লেখা permission-টি দেখুন, তারপর গাইডেড পথ দিয়ে Reconnect করুন।

“This store is already connected to another account”

একই store অন্য একটি workspace-এর সাথে যুক্ত। আগে সেখান থেকে disconnect করুন, তারপর এখানে যুক্ত করুন। আমরা নীরবে store সরিয়ে না এনে দখলটি প্রত্যাখ্যান করি।

agent product-এর প্রশ্নের উত্তর দেয় না

দেখে নিন আপনি store agent-এর সাথেই কথা বলছেন কি না — যেটি যুক্ত হওয়ার সময় বেছে নেওয়া হয়েছিল। তার agent পাতায় একটি read-only “আপনার store দ্বারা পরিচালিত” প্যানেল দেখায়। অন্য agent-রা commerce টুল বহন করে না।

Order খোঁজা কোনো order পায় না

খোঁজাটি ইচ্ছাকৃতভাবে কঠোর: এটি কেবল তখনই বিবরণ ফেরত দেয় যখন ক্রেতা হুবহু order নম্বর এবং order-এর সাথে মিলে যাওয়া একটি ইমেইল বা ফোন দেয়।

কোনো order-status আপডেট পাঠানো হয় না

ক্রেতাকে একটি সমর্থিত channel-এ, chat-এ, opt-in করতে হবে। তিনি করে থাকলে WooCommerce সংযোগের নোটিফিকেশন toggle-গুলো দেখুন — সেগুলো ডিফল্টভাবে চালু থাকে, কিন্তু সংশ্লিষ্ট আপডেটের ধরনটি কোনো এক সময়ে বন্ধ করে দেওয়া হয়ে থাকলে কেবল ক্রেতার opt-in দিয়ে কোনো বার্তা তৈরি হবে না।

Disconnect করা

Commerce → WooCommerce → Disconnect থেকে disconnect করুন। Disconnect করলে:

• সংরক্ষিত সংযোগ ও শংসাপত্র, এবং sync করা catalog মুছে যায়
• সেই catalog থেকে তৈরি product knowledge মুছে যায়
• এটি আপনার store-এ যে webhook-গুলো নিবন্ধন করেছিল সেগুলো সরে যায়
• store agent-এর commerce বরাদ্দ রিসেট হয়, আপনি কখনো সম্পাদনা না করে থাকলে তার commerce persona ফিরিয়ে দেওয়া হয়, আর agent-টি নিজেই আর্কাইভ হয়ে যায় — একই store আবার যুক্ত করলে সেটিকে তার tuning ও version ইতিহাস অক্ষত রেখেই ফিরিয়ে নেওয়া হয়
• সেই store-এর সাথে বাঁধা যেকোনো Storefront স্থায়ীভাবে মুছে যায়, তার analytics ইতিহাসসহ। আপনার হাতে তৈরি Storefront-গুলো অক্ষত থাকে
• store-এর সাথে আসা commerce Agent Forms আর্কাইভ হয়
• AI quiz suggestion একেবারে মুছে ফেলা হয়, তাই ভবিষ্যতে আবার যুক্ত হলে সেটি একেবারে পরিষ্কার অবস্থা থেকে শুরু করে

সাধারণ প্রশ্ন

WooCommerce যুক্ত করতে কি নির্দিষ্ট কোনো সাবস্ক্রিপশন লাগে?

না। WooCommerce সবার জন্যই কাজ করে, ফ্রি ট্রায়াল সহ — catalog প্রশ্নোত্তর, order খোঁজা, সুপারিশ ও order-status আপডেট সবই অন্তর্ভুক্ত।

আমাকে কি একটি plugin install করতে হবে?

কোনো plugin নয়। গাইডেড পথ হলো আপনার নিজের store-এ এককালীন একটি অনুমোদন। আপনার firewall redirect আটকে দিলে তবেই আপনি API key পেস্ট করেন।

অনুমোদনের পাতা কেন write অ্যাক্সেস চায়?

কারণ WooCommerce একটি read-only key-এর জন্য webhook নিবন্ধন করতে অস্বীকার করে, আর webhook ছাড়া কিছুই রিয়েল-টাইমে হালনাগাদ হয় না। তবুও integration কখনো আপনার catalog, আপনার stock বা আপনার বিদ্যমান order বদলায় না। এটি যা লেখে তা webhook-গুলো নিজেই, আর একটি chat থেকে checkout করা ক্রেতার জন্য একটি pending order — এর বেশি কিছু নয়; দেখুন Checkout।

আমি কি তবু একটি read-only key দিয়ে যুক্ত হতে পারি?

পারেন, এবং catalog প্রশ্নোত্তর, order খোঁজা, সুপারিশ ও নোটিফিকেশন সবই কাজ করে। আপনি যা হারান তা হলো রিয়েল-টাইম আপডেট (webhook কখনোই নিবন্ধিত হতে পারে না) এবং multi-line in-chat checkout। পরে সেগুলো চাইলে গাইডেড পথ দিয়ে Reconnect করুন।

আমার সব agent কি WooCommerce ব্যবহার করতে পারে, নাকি শুধু একটি?

একটি — যুক্ত হওয়ার সময় বেছে নেওয়া store agent। সেই agent WooCommerce টুল পায়; বাকিরা অপ্রভাবিত থাকে।

agent কি কখনো আমার store বদলায়?

এটি কখনো product সম্পাদনা করে না, কখনো inventory বদলায় না, কখনো বিদ্যমান order পাল্টায় বা বাতিল করে না, এবং কখনো পেমেন্ট নেয় না। একটি Read/Write সংযোগে এটি একটি জিনিসই তৈরি করতে পারে: একটি chat থেকে checkout করা ক্রেতার জন্য একটি pending order, যার জন্য সে পরে আপনার নিজের checkout-এ টাকা দেয়।

সম্পর্কিত

• Commerce সংক্ষিপ্ত বিবরণ — একটি store যুক্ত করলে আপনি যা পান
• Shopify — সমর্থিত অন্য platform
• Catalog ও Knowledge — catalog কীভাবে sync হয় ও হালনাগাদ থাকে
• Order — order খোঁজা ও status আপডেট
• Checkout — permission-নির্ভর পার্থক্যটি সহ