একটি এসএমএস API ইন্টিগ্রেট করা প্রথমবার শুনতে জটিল মনে হলেও, সঠিক ডকুমেন্টেশন ও কোড উদাহরণ থাকলে যেকোনো ডেভেলপার ৩০ মিনিটের মধ্যেই এটি সম্পন্ন করতে পারেন। এই গাইডে ধাপে ধাপে দেখানো হলো কীভাবে Bulk SMS BD-এর API আপনার অ্যাপ্লিকেশনে যুক্ত করবেন।
শুরুর আগে যা প্রয়োজন
ইন্টিগ্রেশন শুরু করার আগে নিশ্চিত করুন যে আপনার কাছে আছে: একটি সক্রিয় Bulk SMS BD অ্যাকাউন্ট, ড্যাশবোর্ড থেকে ইস্যু করা একটি API কী, এবং পাঠানোর জন্য পর্যাপ্ত ক্রেডিট।
API অথেনটিকেশন
প্রতিটি API রিকোয়েস্টে আপনার API কী একটি হেডারে পাঠাতে হবে। কখনোই এই কী ফ্রন্টএন্ড কোডে (যেমন জাভাস্ক্রিপ্টে ব্রাউজারে চলা কোড) রাখবেন না — সবসময় সার্ভার-সাইড থেকে কল করুন।
PHP উদাহরণ
নিচে একটি সাধারণ PHP উদাহরণ দেওয়া হলো, যা cURL ব্যবহার করে একটি এসএমএস পাঠায়:
PHP-তে cURL দিয়ে POST রিকোয়েস্ট পাঠানো — endpoint-এ api_key, recipient ও message পাঠাতে হয়, এবং response থেকে message_id ও status যাচাই করতে হয়।
রেসপন্সে একটি message_id ফিরে আসে, যা পরবর্তীতে ডেলিভারি স্ট্যাটাস ট্র্যাক করতে ব্যবহার করা যায়।
Node.js উদাহরণ
Node.js-এ fetch বা axios ব্যবহার করে একই কাজ করা যায় — একটি অ্যাসিঙ্ক্রোনাস ফাংশনের মধ্যে API এন্ডপয়েন্টে POST রিকোয়েস্ট পাঠিয়ে রেসপন্স হ্যান্ডেল করতে হয়। Laravel ব্যবহারকারীরা আমাদের অফিসিয়াল প্যাকেজ ব্যবহার করে আরও দ্রুত ইন্টিগ্রেট করতে পারেন, যা কনফিগারেশন ও এরর হ্যান্ডলিং স্বয়ংক্রিয়ভাবে সামলায়।
ডেলিভারি ওয়েবহুক
রিয়েল-টাইমে জানতে চাইলে মেসেজ ডেলিভার হয়েছে কিনা, আপনি একটি ওয়েবহুক URL কনফিগার করতে পারেন। প্রতিটি মেসেজের স্ট্যাটাস পরিবর্তন হলে (sent, delivered, failed) আমাদের সিস্টেম স্বয়ংক্রিয়ভাবে আপনার সার্ভারে একটি POST রিকোয়েস্ট পাঠাবে।
সাধারণ সমস্যা ও সমাধান
- Invalid API Key: নিশ্চিত করুন কী সঠিকভাবে কপি হয়েছে এবং কোনো অতিরিক্ত স্পেস নেই।
- Insufficient Balance: ড্যাশবোর্ড থেকে ক্রেডিট রিচার্জ করুন।
- Invalid Sender ID: মাস্কিং ব্যবহার করলে সেন্ডার আইডি অনুমোদিত কিনা যাচাই করুন।
- Rate Limit Exceeded: রিকোয়েস্ট ফ্রিকোয়েন্সি কমান বা এন্টারপ্রাইজ প্ল্যানে আপগ্রেড করুন।
আরও সহায়তার প্রয়োজন হলে আমাদের সাপোর্ট টিমের সাথে যোগাযোগ করুন — ডেভেলপার সাপোর্ট সবসময় প্রস্তুত।