REST API ডকুমেন্টেশন

SMS & MMS REST API গুলি

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

অ্যাকাউন্ট-নির্দিষ্ট রেফারেন্স খুলুন ডেভেলপার ও অটোমেশন

API এবং ক্রেডেনশিয়াল একসঙ্গে বেছে নিন

অনুমোদিত ডেভেলপার ও অটোমেশন, ব্যবসা এবং কমিউনিকেশন প্রোভাইডার অ্যাকাউন্টগুলো সক্রিয় সার্ভিসের সঙ্গে ইন্টিগ্রেট করতে পারে। একজন স্বতন্ত্র ডেভেলপারকে কোম্পানি সাজার প্রয়োজন নেই। অ্যাপ্লিকেশন SMS/MMS-এর জন্য প্রযোজ্য প্রেরণ অনুমোদন ও নিবন্ধন আবশ্যক। ব্যক্তি ও পরিবার সার্ভিসে গ্রাহকদের বার্তা পাঠানো শুরু করার জন্য কোনো API নেই।

API পরিবার	বেস URL	অথেনটিকেশন ও ফলাফল
Communications v3	`https://api.multitel.net/v3`	অনুমোদিত Basic ক্রেডেনশিয়াল; প্রভিশন করা উপযুক্ত টোকেন কেবল সেসব অপারেশনে যেগুলো তা সমর্থন করে। JSON `status` এবং `response`।
জরুরি কলিংয়ের জন্য নিবন্ধন	`https://api.multi.tel/emergency`	অনুমোদিত Basic ক্রেডেনশিয়াল বা বিশেষভাবে প্রভিশন করা bearer অ্যাক্সেস। JSON `code`, `message` এবং `data`।
পোর্টাল REST ইন্টিগ্রেশন	আপনার অ্যাকাউন্টের ডেভেলপার রেফারেন্সে দেখানো হোস্ট ও অপারেশন	সংশ্লিষ্ট অপারেশনের ডকুমেন্টেড ক্রেডেনশিয়াল, স্কোপ ও স্কিমা ব্যবহার করুন। ব্রাউজার সেশন অনুরোধের ইন্টারফেস আলাদা।

উদাহরণগুলো ব্যবহারের আগে আপনার সার্ভারের সিক্রেট কনফিগারেশনের মাধ্যমে MULTITEL_API_USERNAME এবং MULTITEL_API_PASSWORD সেট করুন। এগুলো কখনো পাবলিক ব্রাউজার JavaScript, URL বা সোর্স কন্ট্রোলে রাখবেন না। নির্দিষ্ট ক্রেডেনশিয়ালগুলো API ইন্টিগ্রেশন সেটিংসে পরিচালনা করা হয়।

অ্যাপ্লিকেশন মেসেজিং A2P সেবা ব্যবহার করে

মেসেজিং APIs শুধু অনুমোদিত ডেভেলপার ও অটোমেশন, ব্যবসা এবং কমিউনিকেশন্স প্রোভাইডার অ্যাকাউন্টের জন্য, তাদের সক্রিয় সেবার ক্ষেত্রে উপলব্ধ। API থেকে পাঠানো SMS/MMS A2P ট্রাফিক হিসেবে গণ্য হয় এবং ব্যক্তিগত/কনজিউমার মেসেজিংয়ের বাইরে রাউট করা হয়। চালু করার আগে প্রযোজ্য প্রেরক, ব্র্যান্ড, ক্যাম্পেইন বা টোল-ফ্রি যাচাই সম্পূর্ণ হতে হবে।

ব্যক্তিগত ও পরিবার মেসেজিং একটি প্রমাণীকৃত গ্রাহক ডিভাইস থেকে শুরু হয়। গ্রাহকের ব্যবহারযোগ্য কোনো API, নথিভুক্ত বা অনথিভুক্ত, ওই Consumer/P2P সেবার মাধ্যমে বার্তা পাঠাতে পারে না। অ্যাকাউন্ট, টেলিফোন নম্বর বা এই ডকুমেন্টেশনের কপি থাকলেই API অ্যাক্সেস মেলে না।

ব্যবসা/A2P মেসেজিং সংক্রান্ত পরিশিষ্ট পড়ুন

একটি SMS অনুরোধ প্রস্তুত করুন

অ্যাকাউন্টের মালিকানাধীন একটি অনুমোদিত, SMS-সক্ষম প্রেরক নম্বর ও বার্তা পেতে সম্মত প্রাপক ব্যবহার করুন এবং প্রয়োজনীয় Brand/Campaign নিবন্ধন বা টোল-ফ্রি নম্বর যাচাইকরণ সম্পন্ন করুন। কার্যকর ক্রেডেনশিয়াল ও নম্বর দিয়ে পূরণ করলে নিচের উদাহরণটি একটি আসল বার্তা পাঠাবে; এটি কোনো স্যান্ডবক্স নয়।

curl --fail-with-body \
  --user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
  --header "Accept: application/json" \
  --request POST \
  --header "Content-Type: application/json" \
  --data '{"from":"YOUR_APPROVED_NUMBER","to":"YOUR_CONSENTED_RECIPIENT","text":"Your requested update is ready."}' \
  "https://api.multitel.net/v3/sendsms"

প্রেরক ও প্রাপকের প্লেসহোল্ডারগুলো দেশের কোডসহ আন্তর্জাতিক বিন্যাসের ফোন নম্বর দিয়ে বদলান এবং শুধু অঙ্ক ব্যবহার করুন। MMS-এর ক্ষেত্রে media-তে সমর্থিত ও সর্বসাধারণের জন্য অ্যাক্সেসযোগ্য মিডিয়া URL দিন এবং আগে MMS-এর যোগ্যতা ও মূল্য যাচাই করুন।

গৃহীত হওয়া মানে ডেলিভারি নয়

বাইরের অ্যাপ্লিকেশন স্ট্যাটাস এবং ফেরত আসা মেসেজিং ফলাফল, দুটোই পরীক্ষা করুন। সার্ভিস যে বার্তা শনাক্তকারী দেয় তা সংরক্ষণ করুন এবং ডেলিভারি স্ট্যাটাস ও webhook ইভেন্ট অনুসরণ করুন। সফল জমা প্রমাণ করে না যে প্রাপকের হ্যান্ডসেট বার্তাটি পেয়েছে।

SMS বিলিং প্রতি সেগমেন্টের ভিত্তিতে। এনকোডিং এবং বার্তার দৈর্ঘ্যের কারণে একাধিক সেগমেন্ট হতে পারে; মিডিয়া ও ক্যারিয়ার-সংক্রান্ত চার্জ SMS থেকে আলাদা হতে পারে। পাঠানোর আগে অ্যাকাউন্টের বর্তমান বিক্রয়মূল্য দেখে নিন। টাইমআউট হওয়া প্রেরণ কখনো অন্ধভাবে পুনরায় চেষ্টা করবেন না: আগে এর রেকর্ড করা ফলাফল পরীক্ষা করুন।

মেসেজিং নীতি Communications অনুরোধ স্কিমা

ত্রুটি ও পুনঃচেষ্টা সামলানো

অথেনটিকেশন বা অনুমতি সংক্রান্ত ব্যর্থতা: API ক্রেডেনশিয়ালটি সক্রিয় আছে কি না, অনুমোদিত সার্ভিস কোনটি এবং সোর্স-আইপি সীমাবদ্ধতা কী, তা পরীক্ষা করুন। পোর্টাল সেশন কুকি কোনো ইন্টিগ্রেশন ক্রেডেনশিয়াল নয়।
অপর্যাপ্ত ক্রেডিট বা অপূর্ণ অনুমোদন: অপারেশনটি পুনরায় চালানোর আগে অ্যাকাউন্ট ব্যালেন্স, প্রেরণ অনুমোদন বা ডকুমেন্ট সংক্রান্ত শর্ত পূরণ করুন।
কোনো ফলাফল নেই: খালি ইনভেন্টরি বা অনুপস্থিত কলারের নামকে একটি স্বাভাবিক ফলাফল হিসেবে সামলান। ধরে নেবেন না যে বাক্যগঠনগতভাবে বৈধ কোনো নম্বরে সব সার্ভিস রয়েছে।
নেটওয়ার্ক টাইমআউট বা সার্ভিস ব্যর্থতা: রিড অপারেশনের জন্য ব্যাকঅফসহ সীমিত সংখ্যক পুনঃচেষ্টা করুন। ক্রয়, প্রেরণ বা নিবন্ধনের ক্ষেত্রে আগে অপারেশনের অবস্থা পরীক্ষা করুন; গৃহীত অনুরোধ পুনরায় পাঠালে একই বিলযোগ্য কাজ দুইবার হয়ে যেতে পারে।

Idempotency সমর্থন প্রতিটি API পরিবারের নিজস্ব বিষয়। Emergency API রিট্রাই কী সমর্থন করে; এর অর্থ এই নয় যে যেকোনো v3 অনুরোধ idempotent। সাপোর্টের জন্য টাইমস্ট্যাম্প, ফেরত পাওয়া ID এবং গোপনীয় তথ্য মুছে ফেলা রেসপন্স সংরক্ষণ করুন।

আপনার অ্যাকাউন্টের রেফারেন্স চালিয়ে যান

সাইন‑ইন করা রেফারেন্স আপনার অনুমতি এবং সক্রিয় সার্ভিস অনুযায়ী অপারেশন ফিল্টার করে। এর সঠিক হোস্ট, ক্রেডেনশিয়াল টাইপ, রিকোয়েস্ট ফিল্ড এবং রেসপন্স স্কিমা ব্যবহার করুন। কনসোলগুলি লাইভ অপারেশন সম্পাদন করতে পারে, যার মধ্যে ক্রয় এবং মেসেজ অন্তর্ভুক্ত।

অ্যাকাউন্ট‑নির্দিষ্ট এন্ডপয়েন্ট ক্যাটালগ কমিউনিকেশনস REST কনসোল পাবলিক কমিউনিকেশনস OpenAPI ডকুমেন্ট OAuth ইন্টিগ্রেশন গাইড