ডেভেলপার ওভারভিউ: EcomUp-এর সাথে কী কী কানেক্ট করা যায়
নিজের ওয়েবসাইট বা টুল EcomUp-এর সাথে যুক্ত করার সব উপায়: Custom Store API ও webhook, চ্যাট উইজেট, পিক্সেল ও কাস্টম কোড।
এই পেজটি আপনার জন্য, অথবা যিনি আপনার ওয়েবসাইট বানান সেই ডেভেলপারের জন্য। আজকের দিনে আপনার নিজের সিস্টেম EcomUp-এর সাথে যত উপায়ে যুক্ত করা যায়, আর প্রতিটি কী কাজে লাগে, তা এখানে দেওয়া আছে। বেশিরভাগ স্টোর মালিকের এসবের দরকার হবে না: অনলাইন স্টোর আর WooCommerce কানেকশন কোনো কোড ছাড়াই কাজ করে।
EcomUp-এর কি পাবলিক API আছে?
সব কিছুর জন্য একটি সাধারণ API নেই। EcomUp এমন কোনো পূর্ণ পাবলিক REST API দেয় না যা দিয়ে আপনার অ্যাকাউন্টের সবকিছু বাইরে থেকে ব্যবহার করা যায় (যেমন সব অর্ডার পড়া বা বাইরে থেকে অর্ডারের স্ট্যাটাস বদলানো)। তবে নির্দিষ্ট কাজের জন্য কিছু ইন্টিগ্রেশন পয়েন্ট আছে, নিচে দেওয়া হলো। এখানে নেই এমন কিছু দরকার হলে Help & Support থেকে আমাদের জানান।
আপনি কী কী কানেক্ট করতে পারবেন
| আপনি চান… | ব্যবহার করুন | কোথায় সেট আপ করবেন |
|---|---|---|
| নিজের ওয়েবসাইট থেকে প্রোডাক্ট, ক্যাটাগরি, কাস্টমার ও অর্ডার EcomUp-এ পাঠাতে, আর অর্ডার তৈরি হলে বা স্ট্যাটাস বদলালে নোটিফিকেশন পেতে | Custom Store (API key + সাইন করা webhook) | Connections → Custom Store। পুরো গাইড: Webhooks ও ইন্টিগ্রেশন API |
| WooCommerce স্টোর সিঙ্ক করতে | বিল্ট-ইন কানেকশন, কোড লাগে না | WooCommerce কানেক্ট করুন |
| অন্য কোনো ওয়েবসাইটে EcomUp-এর AI চ্যাট বসাতে | চ্যাটবট উইজেটের embed স্নিপেট | চ্যাটবট উইজেট |
| EcomUp স্টোরে বিজ্ঞাপন ও কনভার্সন ট্র্যাক করতে | Facebook, TikTok, GA4, Google Ads ও GTM পিক্সেল | ট্র্যাকিং পিক্সেল |
| EcomUp স্টোরে নিজের স্ক্রিপ্ট বা ভেরিফিকেশন ট্যাগ যোগ করতে | হেডার ও ফুটার কাস্টম কোড | কাস্টম কোড |
এক নজরে Custom Store
- Inbound API: প্রোডাক্ট, ক্যাটাগরি, কাস্টমার, ঠিকানা ও অর্ডারের জন্য
/webhook/custom-store/-এর নিচে পাঁচটিPOSTএন্ডপয়েন্ট। - Authentication: প্রতিটি EcomUp অ্যাকাউন্টের জন্য একটি API key, যা
x-api-keyহেডারে পাঠাতে হয়। কানেক্ট বা রিজেনারেট করার সময় key শুধু একবারই দেখানো হয়। - Outbound webhook:
order.created,order.updated,product.created,customer.createdওcategory.createdহলে EcomUp আপনার URL-এ একটিPOSTপাঠায়। - নিরাপত্তা: প্রতিটি webhook ডেলিভারি
X-EcomUp-Signatureহেডারে HMAC-SHA256 দিয়ে সাইন করা থাকে। এর জন্য একটি signing secret ব্যবহার হয়, যা ড্যাশবোর্ডে দেখা যায়।
শুরু করার ধাপ
- বাম পাশের মেনু থেকে Connections খুলুন।
- Custom Store কার্ডটি খুঁজে Connect-এ ক্লিক করুন।
Custom Store কার্ডটি (1) খুঁজে Connect (2) চাপুন। - Custom Store পেজে Connect Custom Store-এ ক্লিক করুন।
- সাথে সাথে আপনার API key কপি করে নিরাপদ জায়গায় রাখুন। এটা আর দেখানো হবে না।
- ডেটা পাঠাতে ও webhook পেতে Webhooks ও ইন্টিগ্রেশন API গাইডটি অনুসরণ করুন।
টিপস
- Custom Store পেজে বিল্ট-ইন ডকুমেন্টেশন আছে, cURL, Node.js, PHP ও Laravel-এ কপি করার মতো উদাহরণসহ। কোনো এন্ডপয়েন্টে ক্লিক করলে সরাসরি তার ডকে চলে যাবে।
- API key আর signing secret পাসওয়ার্ডের মতো গোপন রাখুন। ওয়েবসাইটের front-end কোডে কখনো বসাবেন না বা চ্যাটে শেয়ার করবেন না।
- Custom Store ম্যানেজ করতে connections-এর অনুমতি লাগে। Owner ও admin-দের ডিফল্টভাবে থাকে।
সমস্যা সমাধান
Connect Custom Store বাটন ধূসর হয়ে আছে
আপনার রোল কানেকশন ম্যানেজ করতে পারে না। অ্যাকাউন্ট owner-কে কানেক্ট করতে বলুন, অথবা আপনার রোলে অনুমতি দিতে বলুন। দেখুন টিম মেম্বার ও রোল।
আমার API key হারিয়ে ফেলেছি
Key নিরাপদ, hashed অবস্থায় রাখা হয়, তাই EcomUp এটা আবার দেখাতে পারে না। Custom Store পেজে Regenerate-এ ক্লিক করে নতুন key দিয়ে আপনার ওয়েবসাইট আপডেট করুন।