কীভাবে আপনার WooCommerce স্টোর কানেক্ট করবেন
WooCommerce-এ API key তৈরি করে স্টোর কানেক্ট করুন, যাতে প্রোডাক্ট, অর্ডার ও কাস্টমার EcomUp-এ সিঙ্ক হয়।
আপনার WooCommerce (WordPress) স্টোর EcomUp-এ কানেক্ট করলে আপনার প্রোডাক্টগুলো EcomUp-এ চলে আসবে। তখন AI কাস্টমারদের সেই প্রোডাক্ট সাজেস্ট করতে পারবে, আর নতুন অর্ডার ও প্রোডাক্টের পরিবর্তন নিজে থেকেই সিঙ্ক হবে।
শুরু করার আগে
- আপনার WordPress সাইটের admin অ্যাক্সেস লাগবে, আর WooCommerce প্লাগইন ইনস্টল ও চালু থাকতে হবে।
- আপনার স্টোর অবশ্যই একটি পাবলিক ওয়েব ঠিকানায় অনলাইনে থাকতে হবে, যেটা https:// দিয়ে শুরু।
- EcomUp-এ আপনার রোলে কানেকশন ম্যানেজ করার অনুমতি থাকতে হবে। Owner ও admin-রা ডিফল্টভাবে এটা পারেন।
- আলাদা কোনো প্লাগইন লাগবে না। শুধু WooCommerce-এ একটি API key তৈরি করবেন। API key হলো একজোড়া কোড, যা দিয়ে EcomUp নিরাপদে আপনার স্টোরের সাথে যোগাযোগ করে।
ধাপ ১: WooCommerce-এ API key তৈরি করুন
- আপনার স্টোরের admin-এ লগইন করুন, যেমন https://your-store.com/wp-admin।
- WooCommerce → Settings-এ যান।
- Advanced ট্যাব খুলে REST API-এ ক্লিক করুন।
- Add key (বা Create an API key)-এ ক্লিক করুন।
- Description-এ কিছু লিখুন, যেমন “EcomUp”, আর User-এ আপনার admin ইউজার বেছে নিন।
- Permissions সেট করুন Read/Write।
- Generate API key-এ ক্লিক করুন।
- Consumer key (ck_ দিয়ে শুরু) আর Consumer secret (cs_ দিয়ে শুরু) কপি করুন। Secret শুধু একবারই দেখায়, তাই এখনই কপি করে রাখুন।
ধাপ ২: EcomUp-এ স্টোর কানেক্ট করুন
- EcomUp-এ Engage → Connections-এ যান।
- Available Platforms ট্যাবে WooCommerce কার্ড খুঁজে Connect-এ ক্লিক করুন।
WooCommerce কার্ডে Connect (1) চাপুন। ছোট ? আইকনটি (2) ধাপে ধাপে গাইড খোলে। - Store URL-এ আপনার স্টোরের ঠিকানা দিন, যেমন https://yourstore.com।
- Consumer key আর Consumer secret ঘরে আপনার key দুটো পেস্ট করুন।
- Connect WooCommerce-এ ক্লিক করুন। সেভ করার আগে EcomUp key দুটো যাচাই করে নেয়।
Store URL (1) লিখুন, Consumer key আর Consumer secret (2) পেস্ট করুন, তারপর Connect WooCommerce (3) চাপুন। - “WooCommerce connected — real-time sync enabled!” দেখলে কাজ শেষ।
- WooCommerce কার্ডে Manage চাপুন, তারপর আপনার ক্যাটালগ আনতে Sync Products-এ ক্লিক করুন।
টিপস
- Sync Products যেকোনো সময় চালাতে পারেন। আগের প্রোডাক্ট আপডেট হয়, কখনো ডুপ্লিকেট হয় না। Last sync result-এ দেখাবে কয়টি imported, updated, skipped বা failed হয়েছে।
- Real-time updates চালু থাকলে WooCommerce-এ প্রোডাক্ট, অর্ডার ও কাস্টমারের পরিবর্তন সাথে সাথে EcomUp-এ চলে আসে। যদি Manual sync only দেখায়, Enable real-time-এ ক্লিক করুন।
- Real-time চালু না থাকলেও EcomUp প্রতি ৬ ঘণ্টায় ব্যাকগ্রাউন্ডে আপনার স্টোর সিঙ্ক করে।
- WooCommerce-এ নতুন key তৈরি করলে WooCommerce manage পেজে গিয়ে Update Credentials চাপুন।
- ডিসকানেক্ট করলে প্রোডাক্ট সিঙ্ক বন্ধ হয়ে যায়। আগে সিঙ্ক হওয়া প্রোডাক্টগুলো আপনার EcomUp ক্যাটালগে থেকে যায়।
- WooCommerce কার্ডের ছোট ? আইকনে ক্লিক করলে ধাপে ধাপে গাইড খুলবে।
সমস্যা ও সমাধান
“Invalid credentials. Please check your Consumer Key and Consumer Secret.”
একটি key ভুল বা মুছে ফেলা হয়েছে। দুটো key আবার কপি করুন, অথবা WooCommerce-এ নতুন key তৈরি করে পেস্ট করুন।
“WooCommerce REST API not found. Please ensure WooCommerce is installed and REST API is enabled.”
WooCommerce চালু আছে কিনা এবং Store URL আপনার মূল সাইটের ঠিকানা কিনা (শেষে /shop-এর মতো কিছু ছাড়া) দেখে নিন। WordPress-এ Settings → Permalinks “Plain” ছাড়া অন্য যেকোনো অপশনে সেট করে আবার চেষ্টা করুন।
“Unable to connect to the provided store URL. Please check the URL and try again.”
ঠিকানা ভুল অথবা সাইট অফলাইন। ব্রাউজারে URL-টি খুলে দেখুন কাজ করছে কিনা, আর https:// লিখতে ভুলবেন না।
“Consumer key should start with ck_” বা “Consumer secret should start with cs_”
Key দুটো ভুল ঘরে পেস্ট করেছেন, অথবা অতিরিক্ত লেখা কপি হয়ে গেছে। Key শুরু হয় ck_ দিয়ে আর secret শুরু হয় cs_ দিয়ে।
“Connected — but real-time sync isn't on: …”
স্টোর কানেক্ট হয়েছে, কিন্তু EcomUp আপনার স্টোরে webhook যোগ করতে পারেনি। API key-তে Read/Write পারমিশন আছে কিনা নিশ্চিত করুন, তারপর WooCommerce manage পেজে Enable real-time চাপুন। ততক্ষণ পর্যন্ত পরিবর্তনগুলো সিঙ্ক হবে Sync Products চাপলে এবং প্রতি ৬ ঘণ্টায়।
ডেভেলপারদের জন্য
আপনার দেওয়া Consumer key ও secret দিয়ে EcomUp WooCommerce REST API (wc/v3) ব্যবহার করে। স্টোরে কিছু ইনস্টল করতে হয় না।
EcomUp আপনার স্টোরে যেসব webhook যোগ করে
Real-time sync চালু হলে EcomUp WooCommerce → Settings → Advanced → Webhooks-এ এই webhook-গুলো তৈরি করে। প্রতিটির নাম EcomUpAi <topic>, একটি secret দিয়ে সাইন করা, এবং EcomUp-এ পাঠানো হয়।
| Topic | কী সিঙ্ক হয় |
|---|---|
product.created, product.updated, product.deleted | প্রোডাক্ট |
order.created, order.updated, order.deleted | অর্ডার |
customer.created, customer.updated | কাস্টমার |
এই webhook-গুলো এডিট বা ডিলিট করবেন না। ভুল করে মুছে ফেললে WooCommerce manage পেজে Re-register webhooks চাপুন।