মূল বিষয়ে যান
BitSMS
মেনু

ব্যবহার · অর্ডার নোটিফিকেশন

অর্ডার নিশ্চিতকরণ ও ডেলিভারি আপডেট এসএমএস, স্বয়ংক্রিয়ভাবে

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

সমস্যাটা কোথায়

অর্ডারের খবর না পেলে গ্রাহক ফোন করেন। প্রতিটি "আমার পার্সেল কোথায়?" কলে টিমের সময় যায়, আর যে গ্রাহক কুরিয়ারের অপেক্ষায় নেই, তিনি ডেলিভারি মিস করেন বা ক্যাশ অন ডেলিভারি পার্সেল ফিরিয়ে দেন বেশি।

নিজের কোড থেকে অর্ডার এসএমএস পাঠাতে গেলেও ঝামেলা আছে। টাইমআউট হলে সার্ভার আবার চেষ্টা করে, আর গ্রাহক একই মেসেজ দুবার পান। কোনো মেসেজ নীরবে ব্যর্থ হয়, কেউ জানতেও পারে না। আর একই সময়ে বড় প্রমোশন গেলে অর্ডার আপডেট লাইনের পেছনে পড়ে যায়।

BitSMS যেভাবে সমাধান করে

প্রতিটি অর্ডার ইভেন্টে একটি কল

আপনার সিস্টেমে যেখানে স্ট্যাটাস বদলায়, সেখান থেকেই "নিশ্চিত", "পাঠানো হয়েছে" ও "ডেলিভারিতে আছে" পাঠান। প্রতিটি মেসেজ বাংলা বা ইংরেজিতে লিখুন; বাংলা স্বয়ংক্রিয়ভাবে ইউনিকোডে যায়।

আবার চেষ্টাতেও ডাবল এসএমএস নয়

order-5521-shipped-এর মতো একটি Idempotency-Key দিন। সার্ভার একই রিকোয়েস্ট আবার পাঠালে BitSMS নতুন করে পাঠায় না, চার্জও কাটে না — আগের মেসেজটাই ফেরত দেয়।

ডেলিভারি রিপোর্ট ও সাইনড ওয়েবহুক

প্রতিটি এসএমএস ডেলিভার হলো কি না ড্যাশবোর্ডে দেখুন, অথবা প্রতিটি স্ট্যাটাস পরিবর্তন ওয়েবহুকে নিন। ওয়েবহুক HMAC-SHA256 দিয়ে সাইন করা, তাই নিশ্চিত হতে পারেন যে এটি BitSMS থেকেই এসেছে।

কিউতে প্রমোশনের আগে

অর্ডার আপডেট যায় ট্রানজ্যাকশনাল মেসেজ হিসেবে, যা বাল্ক ক্যাম্পেইনের আগে পাঠানো হয়। কোনো রুট ধীর হলে নন-মাস্কিং মেসেজ অন্য রুটে চলে যায়।

আপনার কোডে

শিপিং আপডেট পাঠান

প্রতি মেসেজে একটি HTTPS রিকোয়েস্ট। এসএমএস নিরাপদে কিউতে উঠলেই এপিআই উত্তর দেয় এবং ট্র্যাক করার জন্য একটি মেসেজ আইডি দেয়।

  • Idempotency-Key-এ অর্ডার নম্বর ও ইভেন্ট রাখুন, যেমন order-5521-shipped।
  • একবার ওয়েবহুক রেজিস্টার করলেই প্রতিটি মেসেজের ডেলিভার্ড ও ফেইলড আপডেট পাবেন।
  • যেকোনো বাংলাদেশি মোবাইল নম্বরে পাঠান, ০১৭… বা +৮৮০১৭… যেকোনো ফরম্যাটে।
curl https://sms-api.bitcommerz.com/v1/messages \
  -H "Authorization: Bearer $BITSMS_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-5521-shipped" \
  -d '{"to": "01712345678", "text": "Your order #5521 has shipped."}'

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

অর্ডার কনফার্মেশন এসএমএস কি বাংলায় পাঠানো যায়?

হ্যাঁ। বাংলায় লিখুন, BitSMS ইউনিকোডে পাঠাবে। একটি বাংলা এসএমএসে ৭০ অক্ষর ধরে, লম্বা হলে প্রতি পার্টে ৬৭। পাঠানোর আগে ফিচার পাতার ক্যালকুলেটরে গুনে নিন।

ডেলিভারি আপডেট এসএমএস গ্রাহকের কাছে পৌঁছাল কি না কীভাবে জানব?

প্রতিটি মেসেজের জন্য অপারেটর থেকে ডেলিভারি রিপোর্ট আসে। ড্যাশবোর্ডে দেখতে পারেন, মেসেজ আইডি দিয়ে খুঁজতে পারেন, অথবা সাইনড ওয়েবহুকে পেতে পারেন।

আমার সার্ভার একই অর্ডার এসএমএস দুবার পাঠালে কী হবে?

প্রতিটি রিকোয়েস্টে একটি Idempotency-Key দিন। একই কি আবার এলে BitSMS ডুপ্লিকেট না পাঠিয়ে প্রথম মেসেজটাই ফেরত দেয়, আর চার্জ হয় একবারই।

কয়েক মিনিটেই প্রথম এসএমএস পাঠান

সাইন আপ করুন, মোবাইল নম্বর যাচাই করুন এবং পরীক্ষার জন্য ৳২৫ ফ্রি ক্রেডিট নিন। কোনো কার্ড লাগবে না।