বাড়তে থাকা ব্যবসা কখনো এক টুলে থাকে না। আপনার অর্ডার সিস্টেম, ERP, ওয়েবসাইটের ফর্ম বা নিজের অ্যাপকে কন্টাক্ট বানাতে, WhatsApp আপডেট পাঠাতে বা কাস্টমার মেসেজ দিলে জানতে হয়। API না থাকলে কাউকে এক স্ক্রিন থেকে আরেক স্ক্রিনে কপি করতে হয়।
SaleMag-এর ডেভেলপার API আপনার সিস্টেমকে টিমের ব্যবহার করা একই ইনবক্স, CRM, ক্যাম্পেইন আর এআই-এর সাথে যুক্ত করে।
SaleMag API দিয়ে কী করা যায়?
সব এন্ডপয়েন্ট /api/v1-এর নিচে, JSON দেয়।
| বিষয় | এন্ডপয়েন্ট |
|---|---|
| অ্যাকাউন্ট | GET /me, টোকেন লিস্ট, তৈরি, ডিলিট |
| কন্টাক্ট | লিস্ট, তৈরি, পড়া, আপডেট, ডিলিট |
| সেগমেন্ট | লিস্ট, তৈরি, সেগমেন্টের কন্টাক্ট |
| ক্যাম্পেইন | লিস্ট, তৈরি, পড়া, launch, pause, রিসিপিয়েন্ট |
| মেসেজ | POST /messages/send: WhatsApp (টেমপ্লেট বা টেক্সট) আর SMS |
| কথোপকথন | কথোপকথনের লিস্ট আর মেসেজ |
| ওয়েবহুক | এন্ডপয়েন্ট লিস্ট, তৈরি, ডিলিট |
| এআই | চ্যাটবট লিস্ট, বটের সাথে চ্যাট, নলেজ বেস আর ডকুমেন্ট |
| অটোমেশন | লিস্ট, কোনো কন্টাক্টের জন্য চালু |
| সোশ্যাল | অ্যাকাউন্ট লিস্ট, পোস্ট পাবলিশ বা শিডিউল |
পূর্ণ তালিকা প্যারামিটার আর উদাহরণসহ আছে /api/v1/openapi.json-এ আর অ্যাপের API reference পেজে।
অথেনটিকেশন কীভাবে কাজ করে?
API Tokens পেজে টোকেন বানিয়ে হেডারে পাঠান:
Authorization: Bearer {token}
- টোকেন হ্যাশ করে রাখা হয়, একবারই দেখায়।
- মেয়াদের তারিখ দেওয়া যায়।
- ১২টা স্কোপ:
contacts:read,contacts:write,campaigns:read,campaigns:write,messages:write,conversations:read,webhooks:write,ai:read,ai:write,automations:write,social:write,analytics:read, আর পুরো অ্যাক্সেসের জন্য*। - সদস্যের ওয়ার্কস্পেস রোলও খাটে, তাই টোকেন তার মালিকের চেয়ে বেশি কিছু করতে পারে না।
নিজের সিস্টেম থেকে WhatsApp মেসেজ পাঠাব কীভাবে?
messages:write স্কোপসহ POST /api/v1/messages/send কল করুন। WhatsApp Cloud API-র নিয়ম খাটে: ২৪ ঘণ্টার উইন্ডোর বাইরে অনুমোদিত টেমপ্লেট লাগে। কাস্টমারের উত্তর আসে শেয়ার্ড ইনবক্সে। API দিয়ে ইমেইল পাঠানো এখনো নেই।
ওয়েবহুক কীভাবে কাজ করে?
Webhooks পেজে HTTPS এন্ডপয়েন্ট যোগ করে ইভেন্ট বেছে নিন: contact.created, message.received, campaign.completed আর টেস্টের জন্য test.ping।
প্রতিটি ডেলিভারি JSON POST, সাথে X-Webhook-Event আর X-Webhook-Signature হেডার: t={timestamp},v1={HMAC-SHA256}, আপনার whsec_ সিক্রেট দিয়ে সাইন করা। ১০ সেকেন্ডে টাইমআউট, পাঁচবার পর্যন্ত রিট্রাই (১ মিনিট, ৫ মিনিট, ১ ঘণ্টা, ১ দিন, ১ দিন পর)। সিক্রেট বদলানো, ডেলিভারি লগ দেখা আর এন্ডপয়েন্ট চালু-বন্ধ করা যায়।
অর্ডার বা কার্টের ইভেন্ট নিতে অটোমেশন ফ্লো বিল্ডারের HTTP রিকোয়েস্ট ধাপ ব্যবহার করুন।
সীমা কত?
- প্রতি ইউজারে পুরো
/api/v1-এ মিনিটে ৬০টা রিকোয়েস্ট। /messages/send-এ আলাদা মিনিটে ৬০টা।- 429 রেসপন্সে
Retry-After,X-RateLimit-LimitআরX-RateLimit-Remaining।
ইন্টিগ্রেশন প্ল্যান করতে সাহায্য লাগলে যোগাযোগ করুন, অথবা দেখুন ইন্টিগ্রেশন আর দাম।
সাধারণ জিজ্ঞাসা
SaleMag API-তে অথেনটিকেশন কীভাবে?
API Tokens পেজে পার্সোনাল অ্যাক্সেস টোকেন বানিয়ে Authorization: Bearer {token} হেডারে পাঠান। টোকেন হ্যাশ করে রাখা হয়, একবারই দেখায়, মেয়াদ আর স্কোপ ঠিক করা যায়। ওয়ার্কস্পেস রোলও প্রযোজ্য।
OpenAPI বা Swagger স্পেক আছে?
হ্যাঁ। OpenAPI 3.1 ডকুমেন্ট পাবলিক /api/v1/openapi.json-এ, আর অ্যাপের API reference পেজে প্রতিটি এন্ডপয়েন্টের curl উদাহরণ আছে।
API দিয়ে WhatsApp মেসেজ পাঠানো যায়?
হ্যাঁ। messages:write স্কোপসহ POST /api/v1/messages/send দিয়ে WhatsApp টেমপ্লেট বা টেক্সট, অথবা SMS পাঠান। WhatsApp-এর নিয়ম মেনে ২৪ ঘণ্টার বাইরে টেমপ্লেট লাগে।
কোন কোন ওয়েবহুক ইভেন্ট আছে?
contact.created, message.received আর campaign.completed, সাথে ড্যাশবোর্ড থেকে test.ping। প্রতিটি ডেলিভারি X-Webhook-Signature হেডারে সাইন করা।
রেট লিমিট কত?
প্রতি ইউজারে পুরো API-তে মিনিটে ৬০টা রিকোয়েস্ট, মেসেজ পাঠানোয় আলাদা মিনিটে ৬০টা। 429 রেসপন্সে Retry-After আর X-RateLimit হেডার থাকে।
SDK আছে?
অফিশিয়াল SDK নেই। API হলো HTTPS-এ সাধারণ JSON, OpenAPI ডকুমেন্ট থেকে ক্লায়েন্ট জেনারেট করে নিতে পারেন।
লেখক পরিচিতি
হোয়াটসঅ্যাপ ও এফ-কমার্স অটোমেশন, ঢাকা
ঢাকার যে টিম সেলম্যাগ বানায়: বাংলাদেশের অনলাইন বিক্রেতাদের জন্য হোয়াটসঅ্যাপ, মেসেঞ্জার আর ইনস্টাগ্রামের এআই সেলস ইনবক্স।